From b444f98aa059b7ff25fdc4353a23899a6b5deb88 Mon Sep 17 00:00:00 2001
From: Keith Solomon <keith@vincentdesign.ca>
Date: Sun, 26 Jul 2026 00:13:40 -0500
Subject: [PATCH] feat: add match view server-rendered shell

---
 src/Http/Handlers/GetMatchView.php     | 24 ++++++++++++++
 src/Views/match.php                    | 43 ++++++++++++++++++++++++++
 tests/Integration/GetMatchViewTest.php | 39 +++++++++++++++++++++++
 3 files changed, 106 insertions(+)
 create mode 100644 src/Http/Handlers/GetMatchView.php
 create mode 100644 src/Views/match.php
 create mode 100644 tests/Integration/GetMatchViewTest.php

diff --git a/src/Http/Handlers/GetMatchView.php b/src/Http/Handlers/GetMatchView.php
new file mode 100644
index 0000000..31f8521
--- /dev/null
+++ b/src/Http/Handlers/GetMatchView.php
@@ -0,0 +1,24 @@
+<?php
+
+declare(strict_types=1);
+
+namespace BattleForge\Http\Handlers;
+
+use BattleForge\Http\Request;
+use BattleForge\Http\Response;
+
+final class GetMatchView
+{
+    /** @param array<string, string> $params */
+    public function handle(Request $request, array $params): Response
+    {
+        $csrf = $request->cookies['__csrf'] ?? '';
+
+        ob_start();
+        require_once __DIR__ . '/../../Views/layout.php';
+        require __DIR__ . '/../../Views/match.php';
+        $body = (string) ob_get_clean();
+
+        return Response::html(200, $body);
+    }
+}
diff --git a/src/Views/match.php b/src/Views/match.php
new file mode 100644
index 0000000..dcd7859
--- /dev/null
+++ b/src/Views/match.php
@@ -0,0 +1,43 @@
+<?php
+
+declare(strict_types=1);
+
+use BattleForge\Http\Escape;
+
+/** @var string $csrf Provided by the front controller. */
+?><?php
+render_layout(static function (): void {
+    $a = static fn (string $v): string => Escape::attr($v);
+    ?>
+    <header id="bf-match-header" data-bf-active-team="" data-bf-round="0">
+        <h1>Battle</h1>
+        <p>
+            Active team: <strong id="bf-active-team">&mdash;</strong>
+            &middot; Round: <strong id="bf-round">0</strong>
+        </p>
+        <p>
+            <button id="bf-end-turn" type="button">End Turn</button>
+        </p>
+    </header>
+    <main>
+        <div id="bf-grid" class="bf-grid" data-bf-width="0" data-bf-height="0"></div>
+        <aside id="bf-panel" class="bf-panel">
+            <p>Selected: <span id="bf-selected-unit">none</span></p>
+            <p>
+                <button id="bf-action-move" type="button" disabled>Move</button>
+                <button id="bf-action-attack" type="button" disabled>Attack</button>
+                <button id="bf-action-ability" type="button" disabled>Ability</button>
+            </p>
+            <div id="bf-ability-options"></div>
+        </aside>
+    </main>
+    <section id="bf-log" class="bf-log" aria-label="Action log"></section>
+    <section id="bf-result" class="bf-result" hidden>
+        <h2>Match over</h2>
+        <p>Winner: <strong id="bf-winner"></strong></p>
+        <p><a id="bf-return-home" href="/">Return to home</a></p>
+    </section>
+    <div id="bf-toast-host"></div>
+    <script type="module" src="<?= $a('/js/match.js') ?>"></script>
+    <?php
+}, $csrf, 'Battle');
diff --git a/tests/Integration/GetMatchViewTest.php b/tests/Integration/GetMatchViewTest.php
new file mode 100644
index 0000000..08ac5c0
--- /dev/null
+++ b/tests/Integration/GetMatchViewTest.php
@@ -0,0 +1,39 @@
+<?php
+
+declare(strict_types=1);
+
+namespace BattleForge\Tests\Integration;
+
+use BattleForge\Http\Handlers\GetMatchView;
+use BattleForge\Http\Request;
+use PHPUnit\Framework\TestCase;
+
+final class GetMatchViewTest extends TestCase
+{
+    public function testItRendersTheMatchShellWithSecurityHeaders(): void
+    {
+        $handler = new GetMatchView();
+        $request = new Request([], [], [], [], [], '', 'GET', '/matches/current', 'text/html', '');
+        $response = $handler->handle($request, []);
+
+        self::assertSame(200, $response->status);
+        self::assertStringContainsString('text/html', $response->headers['Content-Type'] ?? '');
+        self::assertSame('nosniff', $response->headers['X-Content-Type-Options']);
+        self::assertStringContainsString('default-src', $response->headers['Content-Security-Policy']);
+
+        self::assertStringContainsString('id="bf-match-header"', $response->body);
+        self::assertStringContainsString('id="bf-end-turn"', $response->body);
+        self::assertStringContainsString('id="bf-grid"', $response->body);
+        self::assertStringContainsString('id="bf-panel"', $response->body);
+        self::assertStringContainsString('id="bf-action-move"', $response->body);
+        self::assertStringContainsString('id="bf-action-attack"', $response->body);
+        self::assertStringContainsString('id="bf-action-ability"', $response->body);
+        self::assertStringContainsString('id="bf-selected-unit"', $response->body);
+        self::assertStringContainsString('id="bf-log"', $response->body);
+        self::assertStringContainsString('id="bf-result"', $response->body);
+        self::assertStringContainsString('id="bf-winner"', $response->body);
+        self::assertStringContainsString('id="bf-return-home"', $response->body);
+        self::assertStringContainsString('src="/js/match.js"', $response->body);
+        self::assertStringContainsString('name="csrf-token"', $response->body);
+    }
+}