Rebuild keyboard

.devcontainer/docker/devcontainer.json

@@ -8,7 +8,8 @@
     }
   },
   "mounts": [
-    "source=${localEnv:HOME}/.ssh,target=/home/vscode/.ssh,type=bind,consistency=cached"
+    "source=${localEnv:HOME}/.ssh,target=/home/vscode/.ssh,type=bind,consistency=cached",
+    "source=${localEnv:HOME}/.gnupg,target=/home/vscode/.gnupg,type=bind,consistency=cached"
   ],
   "onCreateCommand": ".devcontainer/install-deps.sh",
   "customizations": {

.devcontainer/install-deps.sh

@@ -38,6 +38,12 @@ APT_PACKAGES=(
   zstd
   python3-venv
   python3-kconfiglib
+  ripgrep
+  ca-certificates
+  curl
+  gnupg
+  nodejs
+  npm
 )
 
 if [ "${ARCH}" = "amd64" ]; then
@@ -61,3 +67,20 @@ wget https://github.com/jetkvm/rv1106-system/releases/download/${BUILDKIT_VERSIO
     rm buildkit.tar.zst
 popd
 rm -rf "${BUILDKIT_TMPDIR}"
+
+# Playwright Chromium system libraries (libnspr4, libnss3, libgbm, X11/xcb, etc.)
+# Needed for `make test_e2e` / `npx playwright test` to launch the bundled headless shell.
+sudo env "PATH=$PATH" npm exec --yes playwright@latest install-deps chromium
+
+# Docker CLI
+sudo install -m 0755 -d /etc/apt/keyrings
+sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
+sudo chmod a+r /etc/apt/keyrings/docker.asc
+
+echo \
+  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian \
+  trixie stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
+
+sudo apt-get update && \
+  sudo apt-get install -y docker-ce-cli && \
+  sudo rm -rf /var/lib/apt/lists/*

.devcontainer/podman/devcontainer.json

@@ -17,7 +17,8 @@
     "HOME": "/home/vscode"
   },
   "mounts": [
-    "source=${localEnv:HOME}/.ssh,target=/home/vscode/.ssh,type=bind,consistency=cached"
+    "source=${localEnv:HOME}/.ssh,target=/home/vscode/.ssh,type=bind,consistency=cached",
+    "source=${localEnv:HOME}/.gnupg,target=/home/vscode/.gnupg,type=bind,consistency=cached"
   ],
   "onCreateCommand": ".devcontainer/install-deps.sh",
   "customizations": {

.github/ISSUE_TEMPLATE/keyboard-layout.yml

@@ -0,0 +1,141 @@
+name: Keyboard Layout
+type: 'Feature'
+description: Submit a new keyboard layout, fix an existing one, or request one we don't ship.
+labels:
+- 'type: keyboard-layout'
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for helping us cover more keyboard layouts!
+
+        ## Are you ready to open a PR?
+
+        **If yes**, please follow the step-by-step contributor walkthrough — it covers everything from picking a starting point to validating against `kbdlayout.info`:
+
+        👉 **[docs/keyboard/ADDING_A_LAYOUT.md](https://github.com/jetkvm/kvm/blob/dev/docs/keyboard/ADDING_A_LAYOUT.md)**
+
+        A PR is the fastest path: you drop a single `.kle.json` into `internal/keyboard/layouts/`, the test suite tells you if anything is off, and we can merge it directly.
+
+        **If no** (you don't code Go, you can't run the build, or you're just flagging a bug), keep filling in this issue. The fields below give us enough to do the work for you.
+
+        ---
+
+        ## What we need
+
+        - The **locale code** and **display name** (always).
+        - At least one of: a `kbdlayout.info` URL **or** a KLE JSON pasted below.
+        - Anything you know about **dead keys** on this layout.
+
+  - type: input
+    id: locale
+    attributes:
+      label: Locale code
+      description: |
+        Use `language-REGION` with a hyphen, e.g. `ko-KR`, `tr-TR`, `pt-BR`, `el-GR`.
+        Lowercased language, uppercased region.
+      placeholder: "e.g. ko-KR"
+    validations:
+      required: true
+
+  - type: input
+    id: layout-name
+    attributes:
+      label: Display name
+      description: |
+        What the dropdown will show. Convention: native script + locale code + form factor —
+        e.g. "한국어 ko-KR (ANSI 103)", "Türkçe tr-TR (ISO 105)", "Português (Brasil) pt-BR (ABNT2)".
+      placeholder: 'e.g. 한국어 ko-KR (ANSI 103)'
+    validations:
+      required: true
+
+  - type: dropdown
+    id: layout-type
+    attributes:
+      label: Physical layout type
+      description: |
+        ANSI is the flat single-row Enter (US standard).
+        ISO is the L-shaped Enter (most of Europe).
+        JIS is the Japanese variant with extra keys around the spacebar.
+      options:
+        - ISO 105-key (most European/international keyboards)
+        - ANSI 104-key (US standard)
+        - JIS 109-key (Japanese)
+        - Other (describe in Notes)
+    validations:
+      required: true
+
+  - type: input
+    id: kbdlayout-url
+    attributes:
+      label: kbdlayout.info URL (preferred)
+      description: |
+        If your layout exists at [kbdlayout.info](https://kbdlayout.info/), paste the URL here.
+        This is the **most reliable** way to give us what we need — the page has the canonical
+        legends and dead-key behaviour, and our audit script can validate against it directly.
+      placeholder: "https://kbdlayout.info/00000412/"
+    validations:
+      required: false
+
+  - type: textarea
+    id: kle-json
+    attributes:
+      label: KLE JSON (alternative if no kbdlayout.info URL)
+      description: |
+        If your layout isn't on kbdlayout.info, paste a KLE JSON here. You can:
+
+        - Download one from [kbdlayout.info](https://kbdlayout.info/) for the closest match and edit it, or
+        - Build one on [keyboard-layout-editor.com](https://www.keyboard-layout-editor.com) and copy the **Raw data** tab.
+
+        If you can run Go locally, please validate first:
+
+        ```bash
+        go run scripts/validate_layout.go path/to/your-layout.kle.json
+        ```
+      render: json
+    validations:
+      required: false
+
+  - type: textarea
+    id: dead-keys
+    attributes:
+      label: Dead keys
+      description: |
+        A **dead key** is one that doesn't type a character on its own — pressing it puts
+        the keyboard in a "waiting" state, and the next key combines to produce an accented
+        character (e.g. on French AZERTY, `^` then `a` produces `â`).
+
+        Paste the literal characters that act as dead keys on this layout, separated by
+        spaces — e.g. `^ ¨ ´ ` ~`. If the layout has no dead keys, write `none`.
+
+        **Verify on a real machine running this layout** — some characters look like
+        accents but type immediately on a given layout.
+      placeholder: "^ ¨ ´ ` ~     (or 'none')"
+    validations:
+      required: true
+
+  - type: textarea
+    id: notes
+    attributes:
+      label: Additional notes
+      description: |
+        Anything we should know — regional variants, AltGr-layer quirks, keys that
+        differ from kbdlayout.info, alternative locale codes that should alias to
+        this layout (e.g. `nl-BE` aliasing to `fr-BE`), unusual physical layouts.
+    validations:
+      required: false
+
+  - type: checkboxes
+    attributes:
+      label: Checklist
+      options:
+        - label: The locale code matches `language-REGION` (hyphen, lowercase language, uppercase region).
+          required: true
+        - label: I have access to a real machine running this layout (or the kbdlayout.info reference) and have verified the legends.
+          required: true
+        - label: The dead-keys list reflects actual dead-key behaviour on the target OS, not just keys that look like accents.
+          required: true
+        - label: 'I have read [ADDING_A_LAYOUT.md](https://github.com/jetkvm/kvm/blob/dev/docs/keyboard/ADDING_A_LAYOUT.md) (optional but recommended — many questions are answered there).'
+          required: false
+        - label: 'I have run `go run scripts/validate_layout.go` against my KLE JSON (optional, only if you have Go installed).'
+          required: false

.github/workflows/keyboard.yml

@@ -0,0 +1,86 @@
+name: keyboard
+# Validates keyboard layouts whenever the parser, the layout files, the
+# scripts that reason about them, or the docs that reference them change.
+# Skipped on unrelated PRs to keep CI fast.
+
+on:
+  push:
+    branches: [dev, main]
+    paths:
+      - 'internal/keyboard/layouts/**'        # built-in layout files (KLE JSON)
+      - 'internal/keyboard/testdata/**'       # KLE fixtures used by unit tests
+      - 'internal/keyboard/keyaliases.json'   # special-key taxonomy
+      - 'internal/keyboard/**.go'             # parser, validator, tests, helpers
+      - 'scripts/audit_layouts.go'            # the audit tool itself
+      - 'scripts/validate_layout.go'          # the single-file validator
+      - '.github/workflows/keyboard.yml'      # this workflow
+  pull_request:
+    paths:
+      - 'internal/keyboard/layouts/**'
+      - 'internal/keyboard/testdata/**'
+      - 'internal/keyboard/keyaliases.json'
+      - 'internal/keyboard/**.go'
+      - 'scripts/audit_layouts.go'
+      - 'scripts/validate_layout.go'
+      - '.github/workflows/keyboard.yml'
+
+permissions:
+  contents: read
+
+jobs:
+  layouts:
+    name: Layouts (unit tests + kbdlayout.info audit)
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@v5
+
+      - uses: actions/setup-go@v6
+        with:
+          go-version: "^1.25.1"
+          cache: true
+
+      # Cache the kbdlayout.info reference downloads. The audit script
+      # writes them to whatever --cache points at; persist that across
+      # runs so we only hit kbdlayout.info on first-time misses.
+      - name: Restore kbdlayout.info cache
+        id: kbdcache
+        uses: actions/cache@v5
+        with:
+          path: ~/.cache/kbdlayout-audit
+          key: kbdlayout-audit-${{ hashFiles('internal/keyboard/layouts/*.kle.json') }}
+          restore-keys: |
+            kbdlayout-audit-
+
+      - name: Unit tests (parser, charMap, drift guards)
+        run: go test -v -count=1 ./internal/keyboard/...
+
+      # Audit the locally-parsed layouts against the canonical
+      # kbdlayout.info reference. The script exits 1 only on real
+      # regressions (charMap entries missing on this side); known
+      # ISO/ANSI / dead-key differences are emitted as warnings and
+      # don't fail the job.
+      - name: Audit against kbdlayout.info
+        run: |
+          mkdir -p ~/.cache/kbdlayout-audit
+          go run ./scripts/audit_layouts.go --cache ~/.cache/kbdlayout-audit | tee audit-output.txt
+
+      - name: Summarise audit
+        if: always()
+        run: |
+          {
+            echo "## Layout audit"
+            echo
+            echo '```'
+            tail -n 25 audit-output.txt 2>/dev/null || echo "(no audit output)"
+            echo '```'
+          } >> "$GITHUB_STEP_SUMMARY"
+
+      - name: Upload audit log
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: layout-audit
+          path: audit-output.txt
+          if-no-files-found: ignore
+          retention-days: 14

.gitignore

@@ -18,3 +18,20 @@ ui/reports
 
 # compiled remote-agent test binary
 e2e/remote-agent/remote-agent
+
+# compiled keyboard-layouts test binary
+audit-layouts
+
+# build artifacts
+build/.cmake/
+build/_deps/
+build/CMakeFiles/
+build/CMakeCache.txt
+ui/tsconfig.node.tsbuildinfo
+
+# devcontainer lock file
+.devcontainer/docker/devcontainer-lock.json
+
+ui/localization/jetKVM.UI.inlang/cache/
+ui/localization/jetKVM.UI.inlang/README.md
+ui/localization/jetKVM.UI.inlang/.meta.json

.golangci.yml

@@ -26,6 +26,9 @@ linters:
       - linters:
           - forbidigo
         path: cmd/main.go
+      - linters:
+          - forbidigo
+        path: scripts/audit_layouts.go
       - linters:
           - gochecknoinits
         path: internal/logging/sse.go