#!/bin/bash
# Round01 vertical keyboard App focus fixture QA. It verifies that App Shelf
# index keys and left/right arrows behave like App icon hover in vertical
# Waterfall, while up/down move only inside the focused column and report
# boundary bounce without wrapping.

set -euo pipefail

SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
OUTPUT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
# shellcheck source=build-output-paths.sh
source "$SCRIPT_DIR/build-output-paths.sh"
APP="$BUILD_CURRENT_APP"
REPORT_DIR="$BUILD_REPORT_ROOT"
FIXTURE_APP_COUNT="${ALIGNER_ROUND1_VERTICAL_KEYBOARD_APP_COUNT:-12}"
FIXTURE_WINDOWS_PER_APP="${ALIGNER_ROUND1_VERTICAL_KEYBOARD_WINDOWS_PER_APP:-8}"
REPORT_WAIT="${ALIGNER_ROUND1_VERTICAL_KEYBOARD_REPORT_WAIT:-6.0}"
APP_PID=""

fail() {
  echo "Round01 vertical keyboard App focus fixture QA failed: $*" >&2
  exit 1
}

aligner_pids_for_current_app() {
  ps -axo pid=,args= | while read -r pid command; do
    if [[ "$command" == "$APP/Contents/MacOS/Aligner"* ]] \
      || [[ "$command" == "/Applications/Aligner.app/Contents/MacOS/Aligner"* ]] \
      || [[ "$command" == "$HOME/Applications/Aligner.app/Contents/MacOS/Aligner"* ]]; then
      echo "$pid"
    fi
  done
}

stop_current_aligner() {
  for pid in $(aligner_pids_for_current_app); do
    kill "$pid" 2>/dev/null || true
  done

  for _ in {1..30}; do
    [ -z "$(aligner_pids_for_current_app)" ] && return
    sleep 0.1
  done

  fail "current Aligner app did not exit before QA"
}

cleanup() {
  if [ -n "${APP_PID:-}" ]; then
    kill "$APP_PID" 2>/dev/null || true
    wait "$APP_PID" 2>/dev/null || true
    APP_PID=""
  fi
  stop_current_aligner
}

normalize_keyboard_sequence() {
  local sequence="$1"
  local symbols="1234567890ABCDEFGHIJKLMNOPQRSTUVWXYZ"
  local normalized=""
  local IFS=,

  for raw_part in $sequence; do
    local upper
    upper="$(printf "%s" "$raw_part" | tr '[:lower:]' '[:upper:]')"
    local part="$raw_part"
    if [ "${#upper}" -eq 1 ] && [[ "$symbols" == *"$upper"* ]]; then
      part="app:$upper"
    fi

    if [ -n "$normalized" ]; then
      normalized="$normalized,$part"
    else
      normalized="$part"
    fi
  done

  echo "$normalized"
}

wait_for_report() {
  local report="$1"
  local expected_sequence="$2"

  /usr/bin/python3 - "$report" "$REPORT_WAIT" "$expected_sequence" <<'PY'
import json
import sys
import time

path = sys.argv[1]
timeout = float(sys.argv[2])
expected_sequence = [part for part in sys.argv[3].split(",") if part]
deadline = time.monotonic() + timeout
last_report = None

while time.monotonic() < deadline:
    try:
        with open(path, "r", encoding="utf-8") as file:
            report = json.load(file)
        last_report = report
        root = report.get("rootView", {})
        if (
            report.get("snapshotLoaded") is True
            and report.get("quickSwitchVisible") is True
            and root.get("keyboardCommandsApplied") == expected_sequence
        ):
            sys.exit(0)
    except FileNotFoundError:
        pass
    except json.JSONDecodeError:
        pass
    time.sleep(0.2)

if last_report is not None:
    print(json.dumps(last_report, indent=2, ensure_ascii=False), file=sys.stderr)
print(f"vertical keyboard report did not reach expected commands within {timeout:.1f}s", file=sys.stderr)
sys.exit(1)
PY
}

assert_report() {
  local report="$1"
  local expected_sequence="$2"
  local expected_app_index="$3"
  local expected_window_index="$4"
  local expected_boundary_count="$5"
  local expected_boundary_direction="$6"
  local expect_selection_changed="$7"

  /usr/bin/python3 - \
    "$report" \
    "$expected_sequence" \
    "$expected_app_index" \
    "$expected_window_index" \
    "$expected_boundary_count" \
    "$expected_boundary_direction" \
    "$expect_selection_changed" \
    "$FIXTURE_APP_COUNT" \
    "$FIXTURE_WINDOWS_PER_APP" <<'PY'
import json
import sys

path = sys.argv[1]
expected_sequence = [part for part in sys.argv[2].split(",") if part]
expected_app_index = int(sys.argv[3])
expected_window_index = int(sys.argv[4])
expected_boundary_count = int(sys.argv[5])
expected_boundary_direction = None if sys.argv[6] == "none" else sys.argv[6]
expect_selection_changed = sys.argv[7] == "true"
fixture_app_count = int(sys.argv[8])
fixture_windows_per_app = int(sys.argv[9])

with open(path, "r", encoding="utf-8") as file:
    report = json.load(file)

def require(condition, message):
    if not condition:
        print(message, file=sys.stderr)
        print(json.dumps(report, indent=2, ensure_ascii=False), file=sys.stderr)
        sys.exit(1)

root = report.get("rootView", {})
items = root.get("appShelfItems", [])
columns = root.get("waterfallColumns", [])
target_item = next((item for item in items if item.get("index") == expected_app_index), None)
target_column = next((column for column in columns if column.get("appGroupIndex") == expected_app_index), None)

require(report.get("snapshotLoaded") is True, "snapshotLoaded must be true")
require(report.get("quickSwitchVisible") is True, "fixture must keep Quick Switch visible")
require(report.get("appCount") == fixture_app_count, "fixture appCount must match")
require(report.get("windowCount") == fixture_app_count * fixture_windows_per_app, "fixture windowCount must match")
require(root.get("waterfallViewMode") == "verticalColumns", "fixture must run in vertical Waterfall")
require(root.get("keyboardCommandsApplied") == expected_sequence, "keyboard commands must match normalized sequence")
require(root.get("keyboardFocusedAppGroupIndex") == expected_app_index, "keyboard focus must land on expected App")
require(root.get("hoveredAppGroupIndex") == expected_app_index, "keyboard focus must expose hovered App")
require(root.get("hoverTargetKind") == "app", "keyboard focus must use App hover target")
require(root.get("hoverTargetSource") == "keyboard", "keyboard focus must report keyboard source")
require(root.get("lastCommittedWindowID") is None, "no-Enter keyboard focus runs must not commit")
require(root.get("lastCommitSource") is None, "no-Enter keyboard focus runs must not report commit source")
require(target_item is not None, "target App Shelf item must exist")
require(target_column is not None, "target Waterfall column must exist")
require(target_item.get("isHovered") is True, "target App Shelf item must expose hover")
require("hover" in target_item.get("visualStates", []), "target App Shelf item must expose hover visual")
require(target_column.get("isHovered") is True, "target Waterfall column must expose hover")
require("hover" in target_column.get("visualStates", []), "target Waterfall column must expose hover visual")
require(root.get("selectedAppGroupIndex") == expected_app_index, "selected App must match expected App after column entry")
require(root.get("selectedWindowIndex") == expected_window_index, "selected window index must match expected column movement")
require(root.get("selectionChangedByLastCommand") is expect_selection_changed, "selectionChangedByLastCommand must match final command")
require(root.get("boundaryBounceCount") == expected_boundary_count, "boundary bounce count must match")
if expected_boundary_direction is None:
    require(root.get("lastBoundaryBounceAxis") is None, "no-boundary run must not report boundary axis")
    require(root.get("lastBoundaryBounceDirection") is None, "no-boundary run must not report boundary direction")
else:
    require(root.get("lastBoundaryBounceAxis") == "vertical", "boundary run must report vertical axis")
    require(root.get("lastBoundaryBounceDirection") == expected_boundary_direction, "boundary direction must match")

print(json.dumps({
    "commands": root.get("keyboardCommandsApplied"),
    "keyboardFocusedAppGroupIndex": root.get("keyboardFocusedAppGroupIndex"),
    "selectedWindowIndex": root.get("selectedWindowIndex"),
    "boundaryBounceCount": root.get("boundaryBounceCount"),
    "lastBoundaryBounceDirection": root.get("lastBoundaryBounceDirection")
}, indent=2, ensure_ascii=False))
PY
}

run_case() {
  local name="$1"
  local sequence="$2"
  local expected_app_index="$3"
  local expected_window_index="$4"
  local expected_boundary_count="$5"
  local expected_boundary_direction="$6"
  local expect_selection_changed="$7"
  local report="$REPORT_DIR/round01-vertical-keyboard-$name-report.json"
  local expected_sequence
  expected_sequence="$(normalize_keyboard_sequence "$sequence")"

  stop_current_aligner
  rm -f "$report"

  "$APP/Contents/MacOS/Aligner" \
    --round0-skip-permissions \
    --round01-open-quick-switch \
    --round01-waterfall-view-mode=vertical \
    --round01-fixture-app-count="$FIXTURE_APP_COUNT" \
    --round01-fixture-windows-per-app="$FIXTURE_WINDOWS_PER_APP" \
    --round01-disable-screenshot-refresh \
    --round01-debug-key-sequence="$sequence" \
    --round01-quick-switch-report="$report" &

  APP_PID=$!
  wait_for_report "$report" "$expected_sequence"
  swift "$SCRIPT_DIR/window-logic-qa.swift" --expect-quick-switch >&2
  assert_report \
    "$report" \
    "$expected_sequence" \
    "$expected_app_index" \
    "$expected_window_index" \
    "$expected_boundary_count" \
    "$expected_boundary_direction" \
    "$expect_selection_changed"

  kill "$APP_PID" 2>/dev/null || true
  wait "$APP_PID" 2>/dev/null || true
  APP_PID=""
  sleep 0.3
  swift "$SCRIPT_DIR/window-logic-qa.swift" --expect-no-quick-switch >&2
}

if [ "$FIXTURE_APP_COUNT" -lt 12 ]; then
  fail "fixture app count must be at least 12"
fi
if [ "$FIXTURE_WINDOWS_PER_APP" -lt 8 ]; then
  fail "fixture windows per app must be at least 8"
fi

trap cleanup EXIT
stop_current_aligner
"$SCRIPT_DIR/package-app.sh" >&2

run_case "wrap" "1,left,right" 0 0 0 "none" "false"
run_case "bottom-boundary" "3,down,down,down,down,down,down,down,down,down" 2 7 1 "down" "false"
run_case "top-boundary" "4,down,up" 3 0 1 "up" "false"

trap - EXIT
cleanup