From 6bd76c97be4ef7053c462e5ce68b311fda830823 Mon Sep 17 00:00:00 2001
From: yonatanzunger <30514250+yonatanzunger@users.noreply.github.com>
Date: Thu, 29 Dec 2022 16:47:40 -0800
Subject: [PATCH] A fancy keymap for the wt65_xt. (#19375)
---
.../wt65_xt/keymaps/zunger/keymap.c | 640 ++++++++++++++++++
.../wt65_xt/keymaps/zunger/readme.md | 9 +
.../wt65_xt/keymaps/zunger/rules.mk | 2 +
3 files changed, 651 insertions(+)
create mode 100644 keyboards/wilba_tech/wt65_xt/keymaps/zunger/keymap.c
create mode 100644 keyboards/wilba_tech/wt65_xt/keymaps/zunger/readme.md
create mode 100644 keyboards/wilba_tech/wt65_xt/keymaps/zunger/rules.mk
diff --git a/keyboards/wilba_tech/wt65_xt/keymaps/zunger/keymap.c b/keyboards/wilba_tech/wt65_xt/keymaps/zunger/keymap.c
new file mode 100644
index 0000000000..45778e1698
--- /dev/null
+++ b/keyboards/wilba_tech/wt65_xt/keymaps/zunger/keymap.c
@@ -0,0 +1,640 @@
+/* Copyright 2021 Yonatan Zunger
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program. If not, see .
+ */
+#include QMK_KEYBOARD_H
+#include
+
+// This keymap is designed to make it easy to type in a wide variety of languages, as well as
+// generate mathematical symbols (à la Space Cadet), without relying on the host OS to do
+// key mappings or handle accents. Why? Because different OS's do this in radically different
+// ways, and don't support all of the features one often needs.
+//
+// LAYER MAGIC (aka, typing in many alphabets)
+//
+// This keyboard has three sets of "polyglot" layers: GREEK, CADET, and YIDDISH. Each of these
+// is actually a pair of layers, FOO and SHIFTFOO, which are full of Unicode points that let you
+// type in them. (The Greek and Yiddish keymaps selected here are very canted towards use on a
+// QWERTY layout, rather than the "standard" layouts often used for those languages in monolingual
+// environments. This is useful if your keyboard doesn't have legends for all of them, which in
+// most cases it won't. Of course, you could easily add more.)
+//
+// These each have their own layer select key, which can act as a held modifier key (GREEK+s to
+// produce sigma, etc). There's also a "layer lock" key; layer lock + modifier switches you into
+// that layer until you hit "layer lock" again to bounce back to QWERTY.
+//
+// ACCENT MAGIC
+//
+// We want to support easy typing of diacriticals, again without relying on the host OS. (On
+// MacOS, if you want Unicode to work you have to lose all the normal accent combining keys, and
+// if you're in a multi-OS world, each OS has a totally different input method)
+//
+// The real nuance comes from the three different ways Unicode represents these. Many common
+// accent + letter combinations like é have their own dedicated code points (the combined
+// normal form). One can also place a "combining accent mark" after the letter's code point to
+// form the decomposed normal form (NFKD); this often renders the same as the combined form, but
+// many less-sophisticated apps won't realize it's the same thing as the combined form (thus messing
+// up string matching), and if you backspace you need to backspace *twice* to remove the character,
+// because it's literally two characters. Finally, if you want to render just the accent mark as a
+// symbol of its own, that's a *third* code point. If you're simply typing, you don't want to think
+// about any of this!
+//
+// We thus have a bunch of special keycodes for "accent requests," which live on the FUNCTION
+// layer. Accent requests don't do anything immediate, but when the *next* non-modifier key is hit,
+// we generate a combined code point (if possible), two uncombined points (in cases where combined
+// points don't exist), or the isolated accent followed by the next character typed (in cases where
+// what you typed next isn't a letterform at all, e.g. you hit the space bar). You can also hit
+// shift- to just generate the uncombined accent on its own.
+//
+// The current accent request codes are modeled on the ones in MacOS.
+//
+// fn+` Grave accent (`)
+// fn+e Acute accent (´)
+// fn+i Circumflex (^)
+// fn+u Diaresis / umlaut / trema (¨)
+// fn+c Cedilla (¸)
+// fn+n Tilde (˜)
+//
+// Together, these functions make for a nice "polyglot" keyboard: one that can easily type in a wide
+// variety of languages, which is very useful for people who, well, need to type in a bunch of
+// languages.
+//
+// The major TODOs are:
+// - Add accent support for Hebrew accents.
+// - Factor the code below so that the data layers are more clearly separated from the code logic,
+// so that other users of this keymap can easily add whichever alphabets they need without
+// having to deeply understand the implementation. Probably something similar to
+// users/drashna/keyrecords/unicode.c, but I want to see if I can do some preprocessor magic
+// so that we can actually have the rendered *character* sitting in the code instead of just the
+// hex code point!
+//
+// PLATFORM MAGIC (aka, working well on both Mac and Windows)
+//
+// Finally, this keyboard can switch between Mac and Windows modes, changing various macro
+// combinations, the Unicode mode, and the position of the ALT and GUI keys.
+
+
+enum custom_keycodes {
+ // We provide special layer management keys:
+ // GREEK triggers the Greek (aka "Front") layer, or the SHIFTGREEK layer when shift is held.
+ // (Because we use Unicode, we need to implement shift-handling at the firmware level,
+ // rather than the OS level like we do in the QWERTY layer)
+ // CADET or GREEK+ALT triggers the Cadet (aka "Top") layer, or the SHIFTCADET layer when
+ // shift is held.
+ // YIDDISH triggers a keymap designed for easy Hebrew and Yiddish, based loosely on QWERTY
+ // layouts.
+ // LAYER_LOCK locks the "base" layer (i.e., QWERTY, GREEK, or CADET) to the value which is
+ // pressed at the moment that it is being released. When a layer lock is set, the
+ // analogous layer modifier key is reversed; e.g., if you lock the GREEK layer, then the
+ // GREEK button bounces you back to QWERTY.
+ //
+ // We also parse the shift, alt, and caps lock keys to provide management of those which is
+ // compatible with these various layers.
+ KC_GREEK = SAFE_RANGE,
+ KC_CADET,
+ KC_YIDDISH,
+ KC_LAYER_LOCK,
+ KC_PLATFORM, // Platform select
+
+ // OS-dependent macros
+ KC_VC_MUTE, // Video conference mute
+ KC_VC_HAND, // Video conference hand-raise
+ KC_SCRNSHT, // Screenshot (gui-shift-S on Windows, gui-shift-4 on Mac)
+
+ // These are the keycodes generated by the various "accent request" keystrokes.
+ KC_ACCENT_START,
+ KC_CGRV = KC_ACCENT_START, // Grave accent
+ KC_CAGU, // Acute accent
+ KC_CDIA, // Diaresis / umlaut / trema
+ KC_CCIR, // Circumflex
+ KC_CCED, // Cedilla
+ KC_CTIL, // Tilde
+ KC_ACCENT_END,
+};
+
+enum layers_keymap {
+ _QWERTY = 0,
+
+ _FIRST_LANGUAGE_LAYER,
+ _YIDDISH = _FIRST_LANGUAGE_LAYER,
+ _SHIFTYIDDISH,
+ _GREEK,
+ _SHIFTGREEK,
+ _CADET,
+ _SHIFTCADET,
+ _LAST_LANGUAGE_LAYER,
+
+ // Function goes last.
+ _FUNCTION = _LAST_LANGUAGE_LAYER,
+};
+
+// We manage our OS mode internally, and store it in a static, rather than EEPROM, bit. That's
+// because it changes as we flip machines, and there's no good reason to wear out the memory.
+enum os_modes {
+ _WINDOWS = 0,
+ _MAC = 1,
+ _OS_MODES_MAX = 2,
+};
+static uint8_t os_mode = _MAC;
+
+// Key types matter for accent handling. If there's a pending accent request and another key is
+// pressed:
+// - If it's a normal key, we trigger all our magic accent handling.
+// - If it's a modifier key, we do nothing and let the accent request hold until the next keypress.
+// - If it's a special key, we drop the accent request but don't handle it.
+enum key_types {
+ _NORMAL_KEY,
+ _MODIFIER_KEY,
+ _SPECIAL_KEY,
+};
+
+// msec to hold the platform key to trigger a switch
+#define PLATFORM_HOLD_DURATION 750
+
+// This is so that H(xxxx) has the same width as _______, which makes the grids more legible.
+#define H(x) UC(0x##x)
+#define MO_FN MO(_FUNCTION)
+#define KC_LLCK KC_LAYER_LOCK
+
+// Values for our OS-dependent keys, as arrays keyed by OS mode. Use Meet shortcuts on Mac, Teams on Windows
+const char *VC_MUTE_VALUES[_OS_MODES_MAX] = {SS_LCTL(SS_LSFT("m")), SS_LCMD("d")};
+const char *VC_HAND_VALUES[_OS_MODES_MAX] = {SS_LCTL(SS_LSFT("k")), SS_LCTL(SS_LCMD("h"))};
+const char *SCRNSHT_VALUES[_OS_MODES_MAX] = {SS_LGUI(SS_LSFT("s")), SS_LCMD(SS_LSFT("4"))};
+
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [_QWERTY] = LAYOUT_all(
+ KC_ESC, KC_LLCK, KC_GRAVE,KC_1, KC_2, KC_3, KC_4, KC_5, KC_6, KC_7, KC_8, KC_9, KC_0, KC_MINS, KC_EQL, KC_BSPC, KC_HOME,
+ KC_PLATFORM, KC_MPLY, KC_TAB, KC_Q, KC_W, KC_E, KC_R, KC_T, KC_Y, KC_U, KC_I, KC_O, KC_P, KC_LBRC, KC_RBRC, KC_BSLS, KC_PGUP,
+ KC_SCRNSHT, KC_YIDDISH, KC_LCTL, KC_A, KC_S, KC_D, KC_F, KC_G, KC_H, KC_J, KC_K, KC_L, KC_SCLN, KC_QUOT, KC_ENT, KC_PGDN,
+ KC_GREEK, KC_CADET, KC_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_RSFT, KC_UP, KC_END,
+ KC_VC_HAND, KC_VC_MUTE, KC_LCTL, KC_LGUI, KC_LALT, KC_SPC, MO_FN, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ /* The Greek and Cadet layers. Tab, backspace, the nav and modifier keys, and the control block
+ * are always transparent.
+ *
+ * QWERTY GREEK SGREEK CADET SCADET YID SYID
+ * ` ׳ 05f3 ״ 05f4
+ * 1 ₁ 2081 ¹ 00b9 ¡ 00a1 ¿ 00bf [transparent]
+ * 2 ₂ 2082 ² 00b2 « 00ab » 00bb [transparent]
+ * 3 ₃ 2083 ³ 00b3 £ 00a3 € 20ac [transparent]
+ * 4 ₄ 2084 ⁴ 2074 [transparent]
+ * 5 ₅ 2085 ⁵ 2075 [transparent]
+ * 6 ₆ 2086 ⁶ 2076 [transparent]
+ * 7 ₇ 2087 ⁷ 2077 [transparent]
+ * 8 ₈ 2088 ⁸ 2078 ° 00b0 ⊗ 2297 [transparent]
+ * 9 ₉ 2089 ⁹ 2079 [transparent]
+ * 0 ₀ 2080 ⁰ 2070 ∅ 2205 [transparent]
+ * - ₋ 208b ⁻ 207b ¬ 00ac ⊖ 2296 [transparent]
+ * = ₊ 208a ₋ 208b ≠ 2260 ⊕ 2295 [transparent]
+ * q θ 03b8 Θ 0398 ℚ 211a ק 05e7
+ * w ω 03c9 Ω 03a9 ש 05e9
+ * e ε 03b5 Ε 0395 ∃ 2203 ∄ 2204 ע 05e2
+ * r ρ 03c1 Ρ 03a1 ℝ 211d ר 05e8
+ * t τ 03c4 Τ 03a4 ט 05d8 תּ fb4a
+ * y ψ 03c8 Ψ 03a8 ∨ 2228 ∧ 2227 ײ 05f2 ײַ fb1f
+ * u υ 03c5 Υ 03a5 ∪ 222a ∩ 2229 ו 05d5 ױ 05f1
+ * i ι 03b9 Ι 0399 ∞ 221e ℵ 2135 י 05d9
+ * o ο 03bf Ο 039f ו 05d5 אָ fb2f
+ * p π 03c0 Π 03a0 ≡ 2261 ≢ 2262 פ 05e4 ף 05e3
+ * [ ± 00b1 ∓ 2213
+ * ] ≈ 2248 ≉ 2249
+ * \ ∼ 223c ≁ 2241
+ * a α 03b1 Α 0391 ∀ 2200 Å 212b א 05d0 אַ fb2e
+ * s σ 03c3 Σ 03a3 ∈ 2208 ∉ 2209 ס 05e1 ת 05ea
+ * d δ 03b4 Δ 0394 ⊂ 2282 ⊄ 2284 ד 05d3
+ * f φ 03c6 Φ 03a6 ⊆ 2286 ⊈ 2288 פֿ fb4e
+ * g γ 03b3 Γ 0393 ⊇ 2287 ⊉ 2289 ג 05d2
+ * h η 03b7 Η 0397 ← 2190 ⇐ 21d0 ה 05d4
+ * j ϑ 03d1 ↓ 2193 ⇓ 21d3 ח 05d7 כֿ fb4d
+ * k κ 03ba Κ 039a ↑ 2191 ⇑ 21d1 כ 05db ך 05da
+ * l λ 03bb Λ 039b → 2192 ⇒ 21d2 ל 05dc
+ * ; … 2026 ⋯ 22ef ↔ 2194 ⇔ 21d4
+ * ' · 00b7 • 2022 ∴ 2234 ⊙ 2299
+ * z ζ 03b6 Ζ 0396 ℤ 2124 ז 05d6
+ * x ξ 03be Ξ 039e ✘ 2718 צ 05e6 ץ 05e5
+ * c χ 03c7 Χ 03a7 ℂ 2102 כ 05db ך 05da
+ * v ς 03c2 ✔ 2714 √ 221a װ 05f0 בֿ fb4c
+ * b β 03b2 Β 0392 ב 05d1
+ * n ν 03bd Ν 039d ℕ 2115 נ 05e0 ן 05df
+ * m μ 03bc Μ 039c מ 05de ם 05dd
+ * , ≪ 226a ≫ 226b ∂ 2202 ∫ 222b
+ * . ≲ 2272 ≳ 2273 ≰ 2270 ≱ 2271
+ * / ⊘ 2298
+ */
+ [_YIDDISH] = LAYOUT_all(
+ KC_TRNS, KC_TRNS, H(05f3), KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS,
+ KC_TRNS, KC_TRNS, KC_TRNS, H(05e7), H(05e9), H(05e2), H(05e8), H(05d8), H(05f2), H(05d5), H(05d9), H(05d5), H(05e4), KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS,
+ KC_TRNS, KC_TRNS, KC_TRNS, H(05d0), H(05e1), H(05d3), H(fb4e), H(05d2), H(05d4), H(05d7), H(05db), H(05dc), KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS,
+ KC_TRNS, KC_TRNS, KC_TRNS, H(05d6), H(05e6), H(05db), H(05f0), H(05d1), H(05e0), H(05de), KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS,
+ KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS),
+ [_SHIFTYIDDISH] = LAYOUT_all(
+ KC_TRNS, KC_TRNS, H(05f4), KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS,
+ KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, H(fb4a), H(fb1f), H(05f1), KC_TRNS, H(fb2f), H(05e3), KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS,
+ KC_TRNS, KC_TRNS, KC_TRNS, H(fb2e), H(05ea), KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, H(fb4d), H(05da), KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS,
+ KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, H(05e5), H(05da), H(fb4c), KC_TRNS, H(05df), H(05dd), KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS,
+ KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS),
+ [_GREEK] = LAYOUT_all(
+ KC_TRNS, KC_TRNS, XXXXXXX, H(2081), H(2082), H(2083), H(2084), H(2085), H(2086), H(2087), H(2088), H(2089), H(2080), H(208b), H(208a), KC_TRNS, KC_TRNS,
+ KC_TRNS, KC_TRNS, KC_TRNS, H(03b8), H(03c9), H(03b5), H(03c1), H(03c4), H(03c8), H(03c5), H(03b9), H(03bf), H(03c0), XXXXXXX, XXXXXXX, XXXXXXX, KC_TRNS,
+ KC_TRNS, KC_TRNS, KC_TRNS, H(03b1), H(03c3), H(03b4), H(03c6), H(03b3), H(03b7), XXXXXXX, H(03ba), H(03bb), H(2026), H(00b7), KC_TRNS, KC_TRNS,
+ KC_TRNS, KC_TRNS, KC_TRNS, H(03b6), H(03be), H(03c7), XXXXXXX, H(03b2), H(03bd), H(03bc), H(226a), H(2272), XXXXXXX, KC_TRNS, KC_TRNS, KC_TRNS,
+ KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS),
+ [_SHIFTGREEK] = LAYOUT_all(
+ KC_TRNS, KC_TRNS, XXXXXXX, H(00b9), H(00b2), H(00b3), H(2074), H(2075), H(2076), H(2077), H(2078), H(2079), H(2070), H(207b), H(208b), KC_TRNS, KC_TRNS,
+ KC_TRNS, KC_TRNS, KC_TRNS, H(0398), H(03a9), H(0395), H(03a1), H(03a4), H(03a8), H(03a5), H(0399), H(039f), H(03a0), XXXXXXX, XXXXXXX, XXXXXXX, KC_TRNS,
+ KC_TRNS, KC_TRNS, KC_TRNS, H(0391), H(03a3), H(0394), H(03a6), H(0393), H(0397), H(03d1), H(039a), H(039b), H(22ef), H(2022), KC_TRNS, KC_TRNS,
+ KC_TRNS, KC_TRNS, KC_TRNS, H(0396), H(039e), H(03a7), H(03c2), H(0392), H(039d), H(039c), H(226b), H(2273), XXXXXXX, KC_TRNS, KC_TRNS, KC_TRNS,
+ KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS),
+ [_CADET] = LAYOUT_all(
+ KC_TRNS, KC_TRNS, XXXXXXX, H(00a1), H(00ab), H(00a3), XXXXXXX, XXXXXXX, XXXXXXX, XXXXXXX, H(00b0), XXXXXXX, H(2205), H(00ac), H(2260), KC_TRNS, KC_TRNS,
+ KC_TRNS, KC_TRNS, KC_TRNS, H(211a), XXXXXXX, H(2203), H(211d), XXXXXXX, H(2228), H(222a), H(221e), XXXXXXX, H(2261), H(00b1), H(2248), H(223c), KC_TRNS,
+ KC_TRNS, KC_TRNS, KC_TRNS, H(2200), H(2208), H(2282), H(2286), H(2287), H(2190), H(2193), H(2191), H(2192), H(2194), H(2234), KC_TRNS, KC_TRNS,
+ KC_TRNS, KC_TRNS, KC_TRNS, H(2124), H(2718), H(2102), H(2714), XXXXXXX, H(2115), XXXXXXX, H(2202), H(2270), XXXXXXX, KC_TRNS, KC_TRNS, KC_TRNS,
+ KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS),
+ [_SHIFTCADET] = LAYOUT_all(
+ KC_TRNS, KC_TRNS, XXXXXXX, H(00bf), H(00bb), H(20ac), XXXXXXX, XXXXXXX, XXXXXXX, XXXXXXX, H(2297), XXXXXXX, XXXXXXX, H(2296), H(2295), KC_TRNS, KC_TRNS,
+ KC_TRNS, KC_TRNS, KC_TRNS, XXXXXXX, XXXXXXX, H(2204), XXXXXXX, XXXXXXX, H(2227), H(2229), H(2135), XXXXXXX, H(2262), H(2213), H(2249), H(2241), KC_TRNS,
+ KC_TRNS, KC_TRNS, KC_TRNS, H(212b), H(2209), H(2284), H(2288), H(2289), H(21d0), H(21d3), H(21d1), H(21d2), H(21d4), H(2299), KC_TRNS, KC_TRNS,
+ KC_TRNS, KC_TRNS, KC_TRNS, XXXXXXX, XXXXXXX, XXXXXXX, H(221a), XXXXXXX, XXXXXXX, XXXXXXX, H(222b), H(2271), H(2298), KC_TRNS, KC_TRNS, KC_TRNS,
+ KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS),
+ // The function layer mostly contains the accent marks, but also has a few meta-control
+ // operations. The accent marks are placed by analogy with Mac OS.
+ [_FUNCTION] = LAYOUT_all(
+ QK_BOOT, KC_TRNS, KC_CGRV, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, XXXXXXX, XXXXXXX,
+ KC_TRNS, KC_TRNS, KC_TRNS, XXXXXXX, XXXXXXX, KC_CAGU, XXXXXXX, XXXXXXX, XXXXXXX, KC_CDIA, KC_CCIR, XXXXXXX, XXXXXXX, XXXXXXX, XXXXXXX, XXXXXXX, XXXXXXX,
+ KC_TRNS, KC_TRNS, KC_TRNS, XXXXXXX, XXXXXXX, XXXXXXX, XXXXXXX, XXXXXXX, XXXXXXX, XXXXXXX, XXXXXXX, XXXXXXX, XXXXXXX, XXXXXXX, XXXXXXX, XXXXXXX,
+ KC_TRNS, KC_TRNS, KC_TRNS, XXXXXXX, XXXXXXX, KC_CCED, XXXXXXX, XXXXXXX, KC_CTIL, XXXXXXX, XXXXXXX, XXXXXXX, XXXXXXX, KC_TRNS, XXXXXXX, XXXXXXX,
+ KC_TRNS, KC_TRNS, KC_RCTL, KC_RGUI, KC_RALT, KC_TRNS, KC_TRNS, XXXXXXX, XXXXXXX, XXXXXXX),
+};
+
+////////////////////////////////////////////////////////////////////////////////////////////////////
+// Accent implementation
+//
+// In the body of process_record_user, we store an "accent_request", which is the accent keycode if
+// one was just selected, or zero otherwise. When the *next* key is hit, we look up whether the
+// accent request plus that next keycode (plus the state of the shift key) together amount to an
+// interesting combined (NFKC) character, and if so, emit it; otherwise, we emit the accent as a
+// separate character and then process the next key normally. The resulting UI behavior is similar
+// to that of the combining accent keys in MacOS.
+//
+// We store two arrays, depending on whether shift is or isn't held. Each is two-dimensional, with
+// its outer key by the next keycode struck, and the inner key by the accent requested. The outer
+// array has KC_Z + 1 as its upper bound, so that we can save memory by only coding alphabetic keys.
+// The contents are either Unicode code points, or zero to indicate that we don't have a point for
+// this combination.
+
+#define KC_NUM_ACCENTS (KC_ACCENT_END - KC_ACCENT_START)
+#define KC_NUM_SLOTS (KC_Z + 1)
+
+const uint16_t PROGMEM unshifted_accents[KC_NUM_SLOTS][KC_NUM_ACCENTS] = {
+ // KC_CGRV, KC_CAGU, KC_CDIA, KC_CCIR, KC_CCED, KC_CTIL
+ [KC_A] = { 0x00e0, 0x00e1, 0x00e4, 0x00e2, 0, 0x00e3 },
+ [KC_E] = { 0x00e8, 0x00e9, 0x00eb, 0x00ea, 0, 0 },
+ [KC_I] = { 0x00ec, 0x00ed, 0x00ef, 0x00ee, 0, 0 },
+ [KC_O] = { 0x00f2, 0x00f3, 0x00f6, 0x00f4, 0, 0x00f5 },
+ [KC_U] = { 0x00f9, 0x00fa, 0x00fc, 0x00fb, 0, 0 },
+ [KC_Y] = { 0, 0, 0x00ff, 0, 0, 0 },
+ [KC_N] = { 0, 0, 0, 0, 0, 0x00f1 },
+ [KC_C] = { 0, 0, 0, 0, 0x00e7, 0 },
+};
+
+const uint16_t PROGMEM shifted_accents[KC_NUM_SLOTS][KC_NUM_ACCENTS] = {
+ // KC_CGRV, KC_CAGU, KC_CDIA, KC_CCIR, KC_CCED, KC_CTIL
+ [KC_A] = { 0x00c0, 0x00c1, 0x00c4, 0x00c2, 0, 0x00c3 },
+ [KC_E] = { 0x00c8, 0x00c9, 0x00cb, 0x00ca, 0, 0 },
+ [KC_I] = { 0x00cc, 0x00cd, 0x00cf, 0x00ce, 0, 0 },
+ [KC_O] = { 0x00d2, 0x00d3, 0x00d6, 0x00d4, 0, 0x00d5 },
+ [KC_U] = { 0x00d9, 0x00da, 0x00dc, 0x00db, 0, 0 },
+ [KC_Y] = { 0, 0, 0x00df, 0, 0, 0 },
+ [KC_N] = { 0, 0, 0, 0, 0, 0x00d1 },
+ [KC_C] = { 0, 0, 0, 0, 0x00c7, 0 },
+};
+
+// The uncombined and combined forms of the accents, for when we want to emit them as single
+// characters.
+const uint16_t PROGMEM uncombined_accents[KC_NUM_ACCENTS] = {
+ [KC_CGRV - KC_ACCENT_START] = 0x0060,
+ [KC_CAGU - KC_ACCENT_START] = 0x00b4,
+ [KC_CDIA - KC_ACCENT_START] = 0x00a8,
+ [KC_CCIR - KC_ACCENT_START] = 0x005e,
+ [KC_CCED - KC_ACCENT_START] = 0x00b8,
+ [KC_CTIL - KC_ACCENT_START] = 0x02dc,
+};
+
+const uint16_t PROGMEM combined_accents[KC_NUM_ACCENTS] = {
+ [KC_CGRV - KC_ACCENT_START] = 0x0300,
+ [KC_CAGU - KC_ACCENT_START] = 0x0301,
+ [KC_CDIA - KC_ACCENT_START] = 0x0308,
+ [KC_CCIR - KC_ACCENT_START] = 0x0302,
+ [KC_CCED - KC_ACCENT_START] = 0x0327,
+ [KC_CTIL - KC_ACCENT_START] = 0x0303,
+};
+
+// This function manages keypresses that happen after an accent has been selected by an earlier
+// keypress.
+// Args:
+// accent_key: The accent key which was earlier selected. This must be in the range
+// [KC_ACCENT_START, KC_ACCENT_END).
+// keycode: The keycode which was just pressed.
+// is_shifted: The current shift state (as set by a combination of shift and caps lock)
+//
+// Returns true if the keycode has been completely handled by this function (and so should not be
+// processed further by process_record_user) or false otherwise.
+bool process_key_after_accent(
+ uint16_t accent_key,
+ uint16_t keycode,
+ bool is_shifted
+) {
+ assert(accent_key >= KC_ACCENT_START);
+ assert(accent_key < KC_ACCENT_END);
+ const int accent_index = accent_key - KC_ACCENT_START;
+
+ // If the keycode is outside A..Z, we know we shouldn't even bother with a table lookup.
+ if (keycode <= KC_Z) {
+ // Pick the correct array. Because this is progmem, we're going to need to do the
+ // two-dimensional array indexing by hand, and so we just cast it to a single-dimensional array.
+ const uint16_t *points = (const uint16_t*)(is_shifted ? shifted_accents : unshifted_accents);
+ const uint16_t code_point = pgm_read_word(points + KC_NUM_ACCENTS * keycode + accent_index);
+ if (code_point) {
+ register_unicode(code_point);
+ return true;
+ }
+ }
+
+ // If we get here, there was no accent match. Emit the accent as its own character (i.e. a
+ // Unicode combining accent mark) and return false so that process_record_user also registers
+ // whatever is appropriate for the keycode after that. The host can figure out what to do with
+ // combining Unicode.
+ register_unicode(pgm_read_word(uncombined_accents + accent_index));
+ return false;
+}
+
+// This is a bitmask which selects the activation bits for layers *other* than our language
+// selectors.
+#define NON_LANGUAGE_LAYERS ~(((1UL << _LAST_LANGUAGE_LAYER) - 1) - ((1UL << _FIRST_LANGUAGE_LAYER) - 1))
+
+// Update the current layer state and return the layer we're in.
+uint8_t update_layer(
+ uint8_t layer_lock,
+ uint8_t layer_select_held,
+ bool shifted
+) {
+ uint8_t current_layer = layer_lock;
+ layer_state_t language_layers = 0;
+
+ // If there's a layer select being held right now, then it updates the current layer.
+ // (If it's the layer select for the currently locked layer, then instead it's a toggle
+ // back to _QWERTY!)
+ if (layer_select_held != _QWERTY) {
+ current_layer = (layer_lock == layer_select_held ? _QWERTY : layer_select_held);
+ }
+
+ language_layers |= (1UL << current_layer);
+
+ // If we're shifted (with either shift or caps lock), and we're in one of our special
+ // layers, bump up to the SHIFTED version of that layer. We don't do this for QWERTY;
+ // there we just emit USB HID codes and let the host deal with shift.
+ if (shifted && current_layer != _QWERTY) {
+ ++current_layer;
+ language_layers |= (1UL << current_layer);
+ }
+
+ // Update the QMK layer state by stomping just the language layer bits.
+ const layer_state_t new_layer_state = (layer_state & NON_LANGUAGE_LAYERS) | language_layers;
+ if (new_layer_state != layer_state) {
+ layer_state_set(new_layer_state);
+ }
+
+ return current_layer;
+}
+
+void set_os_mode(uint8_t new_mode) {
+ os_mode = new_mode;
+ // NB: We set unicode_config.input_mode directly, rather than calling
+ // set_unicode_input_mode, because we don't want to persist this and so we shouldn't put
+ // extra load on the EEPROMs.
+ unicode_config.input_mode = (os_mode == _MAC ? UNICODE_MODE_MACOS : UNICODE_MODE_WINCOMPOSE);
+ // Swap LALT and LGUI depending on Mac/Windows.
+ keymap_config.swap_lalt_lgui = (os_mode == _MAC);
+ // This would be a great moment for some auditory or visual feedback, but this keyboard
+ // doesn't support it. :(
+}
+
+void toggle_os_mode(void) {
+ set_os_mode((os_mode + 1) % _OS_MODES_MAX);
+}
+
+void keyboard_post_init_user() {
+ set_os_mode(_WINDOWS);
+}
+
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ // We track these persistent globals and manage them on our own, rather than trying to rely on
+ // get_mods or the like, because this function is called *before* that's updated!
+ static bool shift_held = false;
+ static bool alt_held = false;
+ static bool ctrl_held = false;
+ static bool super_held = false;
+
+ // These are where we remember the values of lock states.
+ static bool shift_lock = false;
+ static uint8_t layer_lock = _QWERTY; // The currently locked layer
+ static uint8_t next_layer_lock = _QWERTY; // Used when layer_lock is held
+ // Which layer select key is currently being held down. _QWERTY is equivalent to "none."
+ static uint8_t layer_select_held = _QWERTY;
+
+ // When the hold on the platform key started
+ static uint16_t platform_hold_start = 0;
+
+ // The accent request, or zero if there isn't one.
+ static uint16_t accent_request = 0;
+
+ // What kind of key we're striking right now, so that we know what to do if any accent requests
+ // are hanging around.
+ uint8_t key_type = _NORMAL_KEY;
+
+ // The layer selection and locking logic is:
+ // * By default, the current layer is given by saved value layer_lock.
+ // * If a layer select key is held down, we update the current layer to that value.
+ // (But special thing: If the current layer lock is and you hit the select key
+ // for , it instead toggles the current layer back to _QWERTY! That way you can
+ // insert some QWERTY keys in the midst of other-layer text.)
+ // * If the KC_LAYER_LOCK key is held down and a layer select key gets pressed, we update
+ // next_layer_lock to that selected layer. When KC_LAYER_LOCK is released, we update
+ // layer_lock to next_layer_lock. Note that that simply tapping KC_LAYER_LOCK resets
+ // layer_lock to _QWERTY.
+ // * After all of this is done, we check if shift is held (via either shift or caps lock);
+ // if it is, and our current layer isn't _QWERTY, then we bump the current layer ID by 1
+ // to get the shifted layer.
+
+ // Step 1: Process various interesting keycodes, especially ones that update our running
+ // state variables.
+ switch (keycode) {
+ // Monitoring the modifier keys, because we'll need them for our logic!
+ case KC_LSFT:
+ case KC_RSFT:
+ shift_held = record->event.pressed;
+ key_type = _MODIFIER_KEY;
+ break;
+ case KC_CAPS:
+ // If we're in QWERTY mode, caps lock is already going to be managed by the host OS, but by
+ // tracking it ourselves we can also usefully apply it to the GREEK and CADET layers.
+ shift_lock = !shift_lock;
+ key_type = _MODIFIER_KEY;
+ break;
+ case KC_LALT:
+ case KC_RALT:
+ alt_held = record->event.pressed;
+ key_type = _MODIFIER_KEY;
+ break;
+ case KC_LCTL:
+ case KC_RCTL:
+ ctrl_held = record->event.pressed;
+ key_type = _MODIFIER_KEY;
+ break;
+ case KC_LGUI:
+ case KC_RGUI:
+ super_held = record->event.pressed;
+ key_type = _MODIFIER_KEY;
+ break;
+
+ case KC_LAYER_LOCK:
+ if (record->event.pressed) {
+ // On press, get ready for a layer selection.
+ next_layer_lock = _QWERTY;
+ } else {
+ // On release, propagate next_layer_lock to layer_lock.
+ layer_lock = next_layer_lock;
+ }
+ key_type = _MODIFIER_KEY;
+ break;
+
+ // Layer selectors
+ case KC_GREEK:
+ if (record->event.pressed) {
+ layer_select_held = _GREEK;
+ next_layer_lock = _GREEK;
+ } else {
+ layer_select_held = _QWERTY;
+ }
+ key_type = _MODIFIER_KEY;
+ break;
+ case KC_CADET:
+ if (record->event.pressed) {
+ layer_select_held = _CADET;
+ next_layer_lock = _CADET;
+ } else {
+ layer_select_held = _QWERTY;
+ }
+ key_type = _MODIFIER_KEY;
+ break;
+ case KC_YIDDISH:
+ if (record->event.pressed) {
+ layer_select_held = _YIDDISH;
+ next_layer_lock = _YIDDISH;
+ } else {
+ layer_select_held = _QWERTY;
+ }
+ key_type = _MODIFIER_KEY;
+ break;
+
+ // Accent selectors
+ case KC_CGRV:
+ case KC_CAGU:
+ case KC_CDIA:
+ case KC_CCIR:
+ case KC_CCED:
+ case KC_CTIL:
+ // The accent request keys normally update accent_request (whose effect will trigger the next
+ // time we see a "normal" key pressed). However, shift+accent request will instead immediately
+ // generate the Unicode combining accent symbol instead.
+ if (shift_held) {
+ register_unicode(pgm_read_word(combined_accents + keycode - KC_ACCENT_START));
+ return false;
+ } else {
+ accent_request = keycode;
+ }
+ key_type = _MODIFIER_KEY;
+ break;
+
+ // Our special keycodes
+ case KC_PLATFORM:
+ if (record->event.pressed) {
+ platform_hold_start = record->event.time;
+ } else if (platform_hold_start != 0 && record->event.time - platform_hold_start > PLATFORM_HOLD_DURATION) {
+ toggle_os_mode();
+ }
+ key_type = _SPECIAL_KEY;
+ return true;
+
+ case KC_VC_MUTE:
+ if (record->event.pressed) {
+ send_string(VC_MUTE_VALUES[os_mode]);
+ return true;
+ }
+ key_type = _SPECIAL_KEY;
+ break;
+
+ case KC_VC_HAND:
+ if (record->event.pressed) {
+ send_string(VC_HAND_VALUES[os_mode]);
+ return true;
+ }
+ key_type = _SPECIAL_KEY;
+ break;
+
+ case KC_SCRNSHT:
+ if (record->event.pressed) {
+ send_string(SCRNSHT_VALUES[os_mode]);
+ return true;
+ }
+ key_type = _SPECIAL_KEY;
+ break;
+
+ case QK_BOOT:
+ key_type = _SPECIAL_KEY;
+ break;
+ }
+
+ // Step 2: Finalize current_layer and update the QMK layer state.
+ const bool shifted = (shift_held != shift_lock);
+ const uint8_t current_layer = update_layer(layer_lock, layer_select_held, shifted);
+
+ // Step 3: Handle accents.
+ bool handled = false;
+ if (accent_request && record->event.pressed) {
+ // If we're in any layer other than _QWERTY, or a modifier key is being held down,
+ // then we're actually generating a special key, not a normal one.
+ if (key_type == _NORMAL_KEY &&
+ (current_layer != _QWERTY || ctrl_held || super_held || alt_held)) {
+ key_type = _SPECIAL_KEY;
+ }
+
+ switch (key_type) {
+ case _NORMAL_KEY:
+ handled = process_key_after_accent(accent_request, keycode, shifted);
+ accent_request = 0;
+ break;
+
+ case _SPECIAL_KEY:
+ accent_request = 0;
+ break;
+
+ case _MODIFIER_KEY:
+ break;
+ }
+ }
+
+ return !handled;
+}
diff --git a/keyboards/wilba_tech/wt65_xt/keymaps/zunger/readme.md b/keyboards/wilba_tech/wt65_xt/keymaps/zunger/readme.md
new file mode 100644
index 0000000000..fe1264a085
--- /dev/null
+++ b/keyboards/wilba_tech/wt65_xt/keymaps/zunger/readme.md
@@ -0,0 +1,9 @@
+* A polyglot keymap for the RamaWorks Zenith
+* Author: Yonatan Zunger (zunger@gmail.com)
+
+This keyboard is designed to make it easy to type a wide range of symbols and a wide range of
+alphabets, without relying on the host OS, because... host OS's aren't fantastic at a lot of
+things.
+
+See the keymap file for most of the documentation, in the form of comments; this is still in
+development!
diff --git a/keyboards/wilba_tech/wt65_xt/keymaps/zunger/rules.mk b/keyboards/wilba_tech/wt65_xt/keymaps/zunger/rules.mk
new file mode 100644
index 0000000000..a61cfa33fa
--- /dev/null
+++ b/keyboards/wilba_tech/wt65_xt/keymaps/zunger/rules.mk
@@ -0,0 +1,2 @@
+# You need Unicode for this map.
+UNICODE_ENABLE = yes # Unicode