Hotkey support for MMapper client

.gitignore

@@ -20,6 +20,9 @@ CMakeUserPresets.json
 CMakeSettings.json
 cmake-build-debug/
 
+# Qt installation from aqtinstall
+6.5.3/
+
 
 # snapcraft
 parts/

AGENTS.md

@@ -22,3 +22,32 @@ To enable fast, cached builds, the following steps are **required**:
           -DCMAKE_C_COMPILER_LAUNCHER=ccache \
           ... [Other flags from BUILD.md]
     ```
+
+---
+
+## Code Formatting (clang-format)
+
+CI uses Ubuntu clang-format 18.1.8 via Docker. To run the exact same check locally:
+
+```bash
+# Check a specific file
+docker run --platform linux/amd64 --rm -v "$(pwd)":/src --entrypoint /bin/sh \
+  ghcr.io/jidicula/clang-format:18 -c \
+  "clang-format --dry-run -Werror -style=file /src/tests/TestHotkeyManager.cpp && echo '✓ Formatting OK'" \
+  || echo '✗ Formatting errors found'
+
+# Auto-fix a file
+docker run --platform linux/amd64 --rm -v "$(pwd)":/src --entrypoint /bin/sh \
+  ghcr.io/jidicula/clang-format:18 -c \
+  "clang-format -i -style=file /src/tests/TestHotkeyManager.cpp && echo '✓ File formatted'"
+
+# Check all src and tests files
+docker run --platform linux/amd64 --rm -v "$(pwd)":/src --entrypoint /bin/sh \
+  ghcr.io/jidicula/clang-format:18 -c \
+  "find /src/src /src/tests -name '*.cpp' -o -name '*.h' | xargs clang-format --dry-run -Werror -style=file && echo '✓ All files OK'" \
+  || echo '✗ Formatting errors found'
+```
+
+Note: `--platform linux/amd64` is required on ARM Macs for x86 emulation.
+
+Alternative (faster but may differ slightly): `brew install llvm@18` then use `/opt/homebrew/opt/llvm@18/bin/clang-format`

docs/WEBASSEMBLY_BUILD.md

@@ -0,0 +1,121 @@
+---
+layout: default
+title: WebAssembly Build Guide
+---
+
+## WebAssembly Build Guide
+
+### First-Time Setup: 1. Install Emscripten SDK
+
+```bash
+cd ~/dev  # or any directory you prefer
+git clone https://github.com/emscripten-core/emsdk.git
+cd emsdk
+./emsdk install 3.1.25
+./emsdk activate 3.1.25
+```
+
+### 2. Install Qt WebAssembly
+
+```bash
+brew install aqtinstall
+cd <MMAPPER_ROOT>  # your MMapper source directory
+aqt install-qt mac desktop 6.5.3 wasm_multithread -m qtwebsockets -O .
+```
+
+### 3. Build script
+
+The build script is located at `scripts/build-wasm.sh`:
+
+```bash
+#!/bin/bash
+set -e
+
+# Source Emscripten environment
+# Adjust path if you installed emsdk elsewhere
+source "$HOME/dev/emsdk/emsdk_env.sh"
+
+# Paths - adjust these to match your setup
+MMAPPER_SRC="<MMAPPER_ROOT>"  # e.g., /Users/yourname/dev/MMapper
+QT_WASM="$MMAPPER_SRC/6.5.3/wasm_multithread"
+QT_HOST="$MMAPPER_SRC/6.5.3/macos"
+
+"$QT_WASM/bin/qt-cmake" \
+    -S "$MMAPPER_SRC" \
+    -B "$MMAPPER_SRC/build-wasm" \
+    -DQT_HOST_PATH="$QT_HOST" \
+    -DWITH_OPENSSL=OFF \
+    -DWITH_TESTS=OFF \
+    -DWITH_WEBSOCKET=ON \
+    -DWITH_UPDATER=OFF \
+    -DCMAKE_BUILD_TYPE=Release
+
+# Build with limited parallelism to avoid system slowdown
+# --parallel N uses N CPU cores. Omit the number to use all cores.
+# Reduce N if your system becomes unresponsive during build.
+cmake --build "$MMAPPER_SRC/build-wasm" --parallel 4
+```
+
+### 4. Server script
+
+The server script is located at `scripts/server.py`:
+
+```python
+import http.server
+import socketserver
+
+PORT = 9742
+
+class MyHandler(http.server.SimpleHTTPRequestHandler):
+    def end_headers(self):
+        # Required headers for SharedArrayBuffer (WASM multithreading)
+        self.send_header("Cross-Origin-Opener-Policy", "same-origin")
+        self.send_header("Cross-Origin-Embedder-Policy", "require-corp")
+        http.server.SimpleHTTPRequestHandler.end_headers(self)
+
+with socketserver.TCPServer(("", PORT), MyHandler) as httpd:
+    print(f"Serving at http://localhost:{PORT}/mmapper.html")
+    httpd.serve_forever()
+```
+
+---
+
+## Daily Use (Everything Installed)
+
+### Build
+
+```bash
+cd <MMAPPER_ROOT>
+./scripts/build-wasm.sh
+```
+
+### Run
+
+```bash
+cd build-wasm/src
+python3 ../../scripts/server.py
+```
+
+### Open
+
+```text
+http://localhost:9742/mmapper.html
+```
+
+### Clean rebuild
+
+```bash
+rm -rf build-wasm && ./scripts/build-wasm.sh
+```
+
+---
+
+## Path Reference
+
+- **`<MMAPPER_ROOT>`**: MMapper source directory
+  (e.g., `/Users/yourname/dev/MMapper`)
+- **`$HOME/dev/emsdk`**: Emscripten SDK location (`~/dev/emsdk`)
+- **`6.5.3/wasm_multithread`**: Qt WASM installed by aqt
+  (inside `<MMAPPER_ROOT>`)
+- **`6.5.3/macos`**: Qt native macOS host tools
+  (inside `<MMAPPER_ROOT>`)

scripts/build-wasm.sh

@@ -0,0 +1,31 @@
+#!/bin/bash
+set -e
+
+# Source Emscripten environment
+# IMPORTANT: Change this path to match your emsdk installation location
+source "$HOME/dev/emsdk/emsdk_env.sh"
+
+# Paths - automatically detect project root (parent of scripts directory)
+MMAPPER_SRC="$(cd "$(dirname "$0")/.." && pwd)"
+QT_WASM="$MMAPPER_SRC/6.5.3/wasm_multithread"
+QT_HOST="$MMAPPER_SRC/6.5.3/macos"
+
+# Configure with qt-cmake
+"$QT_WASM/bin/qt-cmake" \
+    -S "$MMAPPER_SRC" \
+    -B "$MMAPPER_SRC/build-wasm" \
+    -DQT_HOST_PATH="$QT_HOST" \
+    -DWITH_OPENSSL=OFF \
+    -DWITH_TESTS=OFF \
+    -DWITH_WEBSOCKET=ON \
+    -DWITH_UPDATER=OFF \
+    -DCMAKE_BUILD_TYPE=Release
+
+# Build (limited to 4 cores to avoid system slowdown)
+cmake --build "$MMAPPER_SRC/build-wasm" --parallel 4
+
+echo ""
+echo "Build complete!"
+echo "To run:"
+echo "  cd $MMAPPER_SRC/build-wasm/src && python3 $MMAPPER_SRC/scripts/server.py"
+echo "Then open: http://localhost:9742/mmapper.html"

scripts/server.py

@@ -0,0 +1,15 @@
+import http.server
+import socketserver
+
+PORT = 9742
+
+class MyHandler(http.server.SimpleHTTPRequestHandler):
+    def end_headers(self):
+        self.send_header("Cross-Origin-Opener-Policy", "same-origin")
+        self.send_header("Cross-Origin-Embedder-Policy", "require-corp")
+        http.server.SimpleHTTPRequestHandler.end_headers(self)
+
+with socketserver.TCPServer(("", PORT), MyHandler) as httpd:
+    print(f"Serving MMapper WASM at http://localhost:{PORT}/mmapper.html")
+    print("Press Ctrl+C to stop")
+    httpd.serve_forever()

src/CMakeLists.txt

@@ -37,6 +37,8 @@ set(mmapper_SRCS
     configuration/PasswordConfig.h
     configuration/configuration.cpp
     configuration/configuration.h
+    configuration/HotkeyManager.cpp
+    configuration/HotkeyManager.h
     display/CanvasMouseModeEnum.h
     display/Characters.cpp
     display/Characters.h
@@ -432,6 +434,7 @@ set(mmapper_SRCS
     parser/AbstractParser-Commands.h
     parser/AbstractParser-Config.cpp
     parser/AbstractParser-Group.cpp
+    parser/AbstractParser-Hotkey.cpp
     parser/AbstractParser-Mark.cpp
     parser/AbstractParser-Room.cpp
     parser/AbstractParser-Timer.cpp
@@ -867,6 +870,13 @@ set(CPACK_PACKAGE_VERSION_MAJOR ${CMAKE_MATCH_1})
 set(CPACK_PACKAGE_VERSION_MINOR ${CMAKE_MATCH_2})
 set(CPACK_PACKAGE_VERSION_PATCH ${CMAKE_MATCH_3})
 set(CPACK_PACKAGE_VERSION_TWEAK ${CMAKE_MATCH_4})
+# If parsing failed (e.g., version is just a commit hash), fall back to MMAPPER_VERSION
+if(NOT CPACK_PACKAGE_VERSION_MAJOR)
+    string(REGEX MATCH "^([0-9]+)\\.([0-9]+)\\.([0-9]+).*$" _ "${MMAPPER_VERSION}")
+    set(CPACK_PACKAGE_VERSION_MAJOR ${CMAKE_MATCH_1})
+    set(CPACK_PACKAGE_VERSION_MINOR ${CMAKE_MATCH_2})
+    set(CPACK_PACKAGE_VERSION_PATCH ${CMAKE_MATCH_3})
+endif()
 if(NOT CPACK_PACKAGE_VERSION_TWEAK)
     # Set to 0 if the commit count is missing
     set(CPACK_PACKAGE_VERSION_TWEAK 0)

src/client/ClientWidget.cpp

@@ -50,6 +50,13 @@ ClientWidget::ClientWidget(ConnectionListener &listener, QWidget *const parent)
 
 ClientWidget::~ClientWidget() = default;
 
+void ClientWidget::playMume()
+{
+    qDebug() << "[ClientWidget::playMume] Auto-starting client and connecting to MUME";
+    getUi().parent->setCurrentIndex(1);
+    getTelnet().connectToHost(m_listener);
+}
+
 ClientWidget::Pipeline::~Pipeline()
 {
     objs.clientTelnet.reset();
@@ -112,6 +119,15 @@ void ClientWidget::initStackedInputWidget()
             getSelf().slot_onShowMessage(msg);
         }
         void virt_requestPassword() final { getSelf().getInput().requestPassword(); }
+        void virt_scrollDisplay(bool pageUp) final
+        {
+            auto *scrollBar = getDisplay().verticalScrollBar();
+            if (scrollBar) {
+                int pageStep = scrollBar->pageStep();
+                int delta = pageUp ? -pageStep : pageStep;
+                scrollBar->setValue(scrollBar->value() + delta);
+            }
+        }
     };
     auto &out = m_pipeline.outputs.stackedInputWidgetOutputs;
     out = std::make_unique<LocalStackedInputWidgetOutputs>(*this);

src/client/ClientWidget.h

@@ -81,6 +81,7 @@ class NODISCARD_QOBJECT ClientWidget final : public QWidget
 public:
     NODISCARD bool isUsingClient() const;
     void displayReconnectHint();
+    void playMume();
 
 private:
     void relayMessage(const QString &msg) { emit sig_relayMessage(msg); }