feat: reverse layout emulation

fixes #39

Author: aradzie

docs/translations_report.md

@@ -81,8 +81,8 @@
   "highScores.column.score.label": "Skóre",
   "highScores.column.speed.label": "Rychlost psaní",
   "highScores.column.user.label": "Uživatel",
-  "keyboard.emulate.description": "Emulace klávesnice ignoruje rozložení klávesnice nakonfigurované v systému a umožňuje procvičovat vybranou klávesnici bez ohledu na to, jak je systém nakonfigurován. Pohodlnější je ponechat možnost emulace zapnutou.",
-  "keyboard.emulate.label": "Emulovat rozložení",
+  "keyboard.emulation.forward.description": "Emulace klávesnice ignoruje rozložení klávesnice nakonfigurované v systému a umožňuje procvičovat vybranou klávesnici bez ohledu na to, jak je systém nakonfigurován. Pohodlnější je ponechat možnost emulace zapnutou.",
+  "keyboard.emulation.forward.label": "Emulovat rozložení",
   "keyboard.geometry.label": "Geometrie:",
   "keyboard.language.label": "Jazyk:",
   "keyboard.layout.label": "Rozložení:",

packages/keybr-intl/lib/messages/ar.json

@@ -79,7 +79,7 @@
   "help.section6": "<h2>Effektiviteten af denne applikation</h2><p>Vi valgte et par eksempelprofiler for at vise dig, hvordan folk gør fremskridt med at lære berøringstastning, når de bruger denne applikation. Det er ægte, anonymiserede brugerprofiler. Forhåbentlig vil de inspirere dig til at blive ved med at lære!</p>",
   "highScores.column.speed.label": "Skrivehastighed",
   "highScores.column.user.label": "Bruger",
-  "keyboard.emulate.label": "Efterligne layout",
+  "keyboard.emulation.forward.label": "Efterligne layout",
   "keyboard.geometry.label": "Geometri:",
   "keyboard.language.label": "Sprog:",
   "layouts.stats.bottomRowKeys.description": "Procentdel af taster, der er indtastet på Shift-rækken, jo færre jo bedre.",

packages/keybr-intl/lib/messages/cs.json

@@ -80,8 +80,8 @@
   "highScores.column.score.label": "Punktestand",
   "highScores.column.speed.label": "Geschwindigkeit",
   "highScores.column.user.label": "Benutzer",
-  "keyboard.emulate.description": "Die Tastaturemulation ignoriert das in Ihrem System konfigurierte Tastaturlayout und ermöglicht es Ihnen, die ausgewählte Tastatur zu üben, unabhängig davon, wie Ihr System konfiguriert ist. Es ist praktischer, die Emulationsoption aktiviert zu lassen.",
-  "keyboard.emulate.label": "Layout emulieren",
+  "keyboard.emulation.forward.description": "Die Tastaturemulation ignoriert das in Ihrem System konfigurierte Tastaturlayout und ermöglicht es Ihnen, die ausgewählte Tastatur zu üben, unabhängig davon, wie Ihr System konfiguriert ist. Es ist praktischer, die Emulationsoption aktiviert zu lassen.",
+  "keyboard.emulation.forward.label": "Layout emulieren",
   "keyboard.geometry.label": "Geometrie:",
   "keyboard.language.label": "Sprache:",
   "layouts.stats.bottomRowKeys.description": "Prozentualer Anteil der in der Umschaltzeile getippten Tasten, je weniger, desto besser.",

packages/keybr-intl/lib/messages/da.json

@@ -81,7 +81,7 @@
   "highScores.column.score.label": "Σκορ",
   "highScores.column.speed.label": "Ταχύτητα πληκτρολόγησης",
   "highScores.column.user.label": "Χρήστης",
-  "keyboard.emulate.label": "Εξομοίωση διάταξης",
+  "keyboard.emulation.forward.label": "Εξομοίωση διάταξης",
   "keyboard.geometry.label": "Γεωμετρία:",
   "keyboard.language.label": "Γλώσσα:",
   "keyboard.layout.label": "Διάταξη:",

packages/keybr-intl/lib/messages/de.json

@@ -81,8 +81,10 @@
   "highScores.column.score.label": "Score",
   "highScores.column.speed.label": "Typing Speed",
   "highScores.column.user.label": "User",
-  "keyboard.emulate.description": "Keyboard emulation ignores the keyboard layout configured in your system and allows you to practice the selected keyboard regardless of how your system is configured. It is more convenient to keep the emulation option enabled.",
-  "keyboard.emulate.label": "Emulate layout",
+  "keyboard.emulation.forward.description": "Keyboard emulation ignores the keyboard layout configured in your system and allows you to practice the selected keyboard regardless of how your system is configured. It is more convenient to keep the emulation option enabled.",
+  "keyboard.emulation.forward.label": "Emulate layout",
+  "keyboard.emulation.reverse.description": "Use this option if you have a hardware layout switcher on your keyboard, and you see that incorect keys are highlighted on the virtual keyboard.",
+  "keyboard.emulation.reverse.label": "Keyboard hardware emulates layout",
   "keyboard.geometry.label": "Geometry:",
   "keyboard.language.label": "Language:",
   "keyboard.layout.label": "Layout:",

packages/keybr-intl/lib/messages/el.json

@@ -81,7 +81,7 @@
   "highScores.column.score.label": "Puntuación",
   "highScores.column.speed.label": "Velocidad",
   "highScores.column.user.label": "Usuario",
-  "keyboard.emulate.label": "Emular disposición",
+  "keyboard.emulation.forward.label": "Emular disposición",
   "keyboard.geometry.label": "Geometría:",
   "keyboard.language.label": "Idioma:",
   "keyboard.layout.label": "Disposición:",

packages/keybr-intl/lib/messages/en.json

@@ -81,8 +81,8 @@
   "highScores.column.score.label": "Skoor",
   "highScores.column.speed.label": "Tippimiskiirus",
   "highScores.column.user.label": "Kasutaja",
-  "keyboard.emulate.description": "Klaviatuuri emulatsioon ignoreerib teie süsteemis konfigureeritud klaviatuuri paigutust ja võimaldab teil kasutada valitud klaviatuuri, olenemata sellest, kuidas teie süsteem on konfigureeritud. Mugavam on hoida emulatsiooni valik sisse lülitatud.",
-  "keyboard.emulate.label": "Paigutuse imiteerimine",
+  "keyboard.emulation.forward.description": "Klaviatuuri emulatsioon ignoreerib teie süsteemis konfigureeritud klaviatuuri paigutust ja võimaldab teil kasutada valitud klaviatuuri, olenemata sellest, kuidas teie süsteem on konfigureeritud. Mugavam on hoida emulatsiooni valik sisse lülitatud.",
+  "keyboard.emulation.forward.label": "Paigutuse imiteerimine",
   "keyboard.geometry.label": "Geomeetria:",
   "keyboard.language.label": "Keel:",
   "keyboard.layout.label": "Paigutus:",

packages/keybr-intl/lib/messages/es.json

@@ -62,7 +62,7 @@
   "highScores.column.score.label": "امتیاز",
   "highScores.column.speed.label": "سرعت تایپ",
   "highScores.column.user.label": "کاربر",
-  "keyboard.emulate.label": "شبیه‌ساری چیدمان",
+  "keyboard.emulation.forward.label": "شبیه‌ساری چیدمان",
   "keyboard.geometry.label": "هندسه:",
   "keyboard.language.label": "زبان:",
   "keyboard.layout.label": "چیدمان:",

packages/keybr-intl/lib/messages/et.json

@@ -80,7 +80,7 @@
   "highScores.column.score.label": "Note",
   "highScores.column.speed.label": "Vitesse",
   "highScores.column.user.label": "Utilisateur",
-  "keyboard.emulate.label": "Émuler la disposition",
+  "keyboard.emulation.forward.label": "Émuler la disposition",
   "keyboard.geometry.label": "Géométrie:",
   "keyboard.language.label": "Langue:",
   "keyboard.layout.label": "Disposition:",

packages/keybr-intl/lib/messages/fa.json

@@ -81,7 +81,7 @@
   "highScores.column.score.label": "ציון",
   "highScores.column.speed.label": "מהירות הקלדה",
   "highScores.column.user.label": "מִשׁתַמֵשׁ",
-  "keyboard.emulate.label": "חיקוי פריסה",
+  "keyboard.emulation.forward.label": "חיקוי פריסה",
   "keyboard.geometry.label": "גֵאוֹמֶטרִיָה:",
   "keyboard.language.label": "שפה:",
   "keyboard.layout.label": "מַעֲרָך:",

packages/keybr-intl/lib/messages/fr.json

@@ -81,7 +81,7 @@
   "highScores.column.score.label": "Eredmény",
   "highScores.column.speed.label": "Gépelési sebesség",
   "highScores.column.user.label": "Felhasználó",
-  "keyboard.emulate.label": "A kiosztás szimulálása",
+  "keyboard.emulation.forward.label": "A kiosztás szimulálása",
   "keyboard.geometry.label": "Geometria:",
   "keyboard.language.label": "Nyelv:",
   "keyboard.layout.label": "Kiosztás:",

packages/keybr-intl/lib/messages/he.json

@@ -73,7 +73,7 @@
   "highScores.column.score.label": "Punteggio",
   "highScores.column.speed.label": "Velocità di battitura",
   "highScores.column.user.label": "Utente",
-  "keyboard.emulate.label": "Emula layout",
+  "keyboard.emulation.forward.label": "Emula layout",
   "keyboard.geometry.label": "Geometria:",
   "keyboard.language.label": "Lingua:",
   "layouts.stats.bottomRowKeys.description": "Percentuale di tasti digitati sulla riga Maiusc, un nomero basso è meglio.",

packages/keybr-intl/lib/messages/hu.json

@@ -78,7 +78,7 @@
   "highScores.column.score.label": "スコア",
   "highScores.column.speed.label": "タイピング速度",
   "highScores.column.user.label": "ユーザー",
-  "keyboard.emulate.label": "配列をエミュレートする",
+  "keyboard.emulation.forward.label": "配列をエミュレートする",
   "keyboard.geometry.label": "形状:",
   "keyboard.language.label": "言語:",
   "keyboard.layout.label": "配列:",

packages/keybr-intl/lib/messages/it.json

@@ -81,7 +81,7 @@
   "highScores.column.score.label": "स्कोर",
   "highScores.column.speed.label": "टाइपिङ गति",
   "highScores.column.user.label": "प्रयोगकर्ता",
-  "keyboard.emulate.label": "लेआउट अनुकरण गर्नुहोस्",
+  "keyboard.emulation.forward.label": "लेआउट अनुकरण गर्नुहोस्",
   "keyboard.geometry.label": "ज्यामिति:",
   "keyboard.language.label": "भाषा:",
   "keyboard.layout.label": "लेआउट:",

packages/keybr-intl/lib/messages/ja.json

@@ -64,7 +64,7 @@
   "highScores.column.layout.label": "Indeling",
   "highScores.column.speed.label": "Typsnelheid",
   "highScores.column.user.label": "Gebruiker",
-  "keyboard.emulate.label": "Indeling emuleren",
+  "keyboard.emulation.forward.label": "Indeling emuleren",
   "keyboard.geometry.label": "Geometrie:",
   "keyboard.language.label": "Taal:",
   "keyboard.layout.label": "Indeling:",

packages/keybr-intl/lib/messages/ne.json

@@ -81,8 +81,8 @@
   "highScores.column.score.label": "Wynik",
   "highScores.column.speed.label": "Tempo",
   "highScores.column.user.label": "Użytkownik",
-  "keyboard.emulate.description": "Emulacja klawiatury ignoruje układ klawiatury skonfigurowany w systemie i umożliwia ćwiczenie wybranej klawiatury niezależnie od konfiguracji systemu. Wygodniej jest mieć włączoną opcję emulacji.",
-  "keyboard.emulate.label": "Emuluj układ",
+  "keyboard.emulation.forward.description": "Emulacja klawiatury ignoruje układ klawiatury skonfigurowany w systemie i umożliwia ćwiczenie wybranej klawiatury niezależnie od konfiguracji systemu. Wygodniej jest mieć włączoną opcję emulacji.",
+  "keyboard.emulation.forward.label": "Emuluj układ",
   "keyboard.geometry.label": "Geometria:",
   "keyboard.language.label": "Język:",
   "keyboard.layout.label": "Układ:",

packages/keybr-intl/lib/messages/nl.json

@@ -80,7 +80,7 @@
   "highScores.column.score.label": "Pontuação",
   "highScores.column.speed.label": "Velocidade de Digitação",
   "highScores.column.user.label": "Usuário",
-  "keyboard.emulate.label": "Layout simulado",
+  "keyboard.emulation.forward.label": "Layout simulado",
   "keyboard.geometry.label": "Geometria:",
   "keyboard.language.label": "Linguagem:",
   "layouts.stats.bottomRowKeys.description": "Porcentagem de teclas digitadas na linha do Shift. Quanto menos, melhor.",

packages/keybr-intl/lib/messages/pl.json

@@ -81,8 +81,8 @@
   "highScores.column.score.label": "Баллы",
   "highScores.column.speed.label": "Скорость",
   "highScores.column.user.label": "Пользователь",
-  "keyboard.emulate.description": "Эмуляция клавиатуры игнорирует раскладку клавиатуры, настроенную в вашей системе, и позволяет вам практиковаться с выбранной клавиатурой независимо от того, как настроена ваша система. Удобнее оставлять эмуляцию включенной.",
-  "keyboard.emulate.label": "Эмулировать раскладку",
+  "keyboard.emulation.forward.description": "Эмуляция клавиатуры игнорирует раскладку клавиатуры, настроенную в вашей системе, и позволяет вам практиковаться с выбранной клавиатурой независимо от того, как настроена ваша система. Удобнее оставлять эмуляцию включенной.",
+  "keyboard.emulation.forward.label": "Эмулировать раскладку",
   "keyboard.geometry.label": "Геометрия:",
   "keyboard.language.label": "Язык:",
   "keyboard.layout.label": "Раскладка:",

packages/keybr-intl/lib/messages/pt-br.json

@@ -80,7 +80,7 @@
   "highScores.column.score.label": "Poäng",
   "highScores.column.speed.label": "Skrivhastighet",
   "highScores.column.user.label": "Användare",
-  "keyboard.emulate.label": "Emulera layout",
+  "keyboard.emulation.forward.label": "Emulera layout",
   "keyboard.geometry.label": "Geometri:",
   "keyboard.language.label": "Språk:",
   "layouts.stats.bottomRowKeys.description": "Procent av tangenter på Shiftraden, ju färre desto bättre.",

packages/keybr-intl/lib/messages/ru.json

@@ -81,7 +81,7 @@
   "highScores.column.score.label": "Бали",
   "highScores.column.speed.label": "Швидкість",
   "highScores.column.user.label": "Користувач",
-  "keyboard.emulate.label": "Емулювати розкладку",
+  "keyboard.emulation.forward.label": "Емулювати розкладку",
   "keyboard.geometry.label": "Геометрія:",
   "keyboard.language.label": "Мова:",
   "keyboard.layout.label": "Розкладка:",

packages/keybr-intl/lib/messages/sv.json

@@ -80,8 +80,8 @@
   "highScores.column.score.label": "分数",
   "highScores.column.speed.label": "输入速度",
   "highScores.column.user.label": "用户",
-  "keyboard.emulate.description": "键盘模拟会忽略系统配置的键盘布局，无论系统配置如何，您都可以练习所选键盘。启用模拟选项会更方便。",
-  "keyboard.emulate.label": "模拟布局",
+  "keyboard.emulation.forward.description": "键盘模拟会忽略系统配置的键盘布局，无论系统配置如何，您都可以练习所选键盘。启用模拟选项会更方便。",
+  "keyboard.emulation.forward.label": "模拟布局",
   "keyboard.geometry.label": "样式:",
   "keyboard.language.label": "语言:",
   "keyboard.layout.label": "布局:",

packages/keybr-intl/lib/messages/tr.json

@@ -1,5 +1,6 @@
 import {
   booleanProp,
+  enumProp,
   itemProp,
   type Settings,
   xitemProp,
@@ -8,10 +9,28 @@ import { Geometry } from "./geometry.ts";
 import { Language } from "./language.ts";
 import { Layout } from "./layout.ts";
 
+export enum Emulation {
+  /**
+   * No emulation.
+   */
+  None = 10,
+  /**
+   * Assumes that the physical key locations are correct,
+   * fixes the character codes.
+   */
+  Forward = 1,
+  /**
+   * Assumes that the character codes are correct,
+   * fixes the physical key locations.
+   * It reverses the effect of layout emulation in hardware.
+   */
+  Reverse = 2,
+}
+
 export const keyboardProps = {
   layout: xitemProp("keyboard.layout", Layout.ALL, Layout.EN_US),
   geometry: itemProp("keyboard.geometry", Geometry.ALL, Geometry.ANSI_101),
-  emulate: booleanProp("keyboard.emulate", true),
+  emulation: enumProp("keyboard.emulation", Emulation, Emulation.Forward),
   colors: booleanProp("keyboard.colors", true),
   pointers: booleanProp("keyboard.pointers", true),
 } as const;