fix(ci): handle qmlformat binary name across Ubuntu versions

Author: bernardopg

.github/workflows/quality.yml

@@ -23,7 +23,11 @@ jobs:
       - name: Install Qt tools
         run: |
           sudo apt-get update
-          sudo apt-get install -y qt6-declarative-dev-tools
+          # qt6-declarative-dev-tools provides qmlformat on Ubuntu 22.04;
+          # qml6format is the package name on Ubuntu 24.04+.
+          # Try both; at least one must succeed.
+          sudo apt-get install -y qt6-declarative-dev-tools || \
+          sudo apt-get install -y qml6format
 
       - name: Lint Markdown
         run: bash scripts/lint-markdown.sh

scripts/validate-qml.sh

@@ -1,6 +1,24 @@
 #!/usr/bin/env bash
 set -euo pipefail
 
+# Detect qmlformat binary — name varies by Qt version and distro:
+#   qmlformat   (Qt5 / Qt6 on Ubuntu 22.04)
+#   qml6format  (Qt6 on Ubuntu 24.04+)
+#   qmlformat6  (some Fedora/Arch packaging)
+QML_FMT=""
+for candidate in qmlformat qml6format qmlformat6; do
+  if command -v "$candidate" &>/dev/null; then
+    QML_FMT="$candidate"
+    break
+  fi
+done
+
+if [[ -z "$QML_FMT" ]]; then
+  echo "Error: no QML formatter found (tried: qmlformat, qml6format, qmlformat6)." >&2
+  echo "Install qt6-declarative-dev-tools (Ubuntu 22.04) or qml6format (Ubuntu 24.04+)." >&2
+  exit 1
+fi
+
 mapfile -t qml_files < <(find . -type f -name "*.qml" | sort)
 
 if [[ ${#qml_files[@]} -eq 0 ]]; then
@@ -9,7 +27,7 @@ if [[ ${#qml_files[@]} -eq 0 ]]; then
 fi
 
 for file in "${qml_files[@]}"; do
-  qmlformat "$file" >/dev/null
+  "$QML_FMT" "$file" >/dev/null
 done
 
-echo "QML syntax validation passed for ${#qml_files[@]} file(s)."
+echo "QML syntax validation passed for ${#qml_files[@]} file(s) (via $QML_FMT)."