ui/phase-27: battle viewer (radial scene, playback, map markers)

Engine wire change: Report.battle switched from []uuid.UUID to
[]BattleSummary{id, planet, shots} so the map can place battle
markers without N extra fetches. FBS schema + generated Go/TS
regenerated; transcoder + report controller updated; openapi
adds the BattleSummary schema with a freeze test.

Backend gateway forwards engine GET /api/v1/battle/:turn/:uuid as
/api/v1/user/games/{game_id}/battles/{turn}/{battle_id} (handler
plus engineclient.FetchBattle, contract test stub, openapi spec).

UI:
- BattleViewer (lib/battle-player/) is a logically isolated SVG
  radial scene that consumes a BattleReport prop. Planet at the
  centre, races on the outer ring at equal angular spacing, race
  clusters by (race, className) with <class>:<numLeft> labels;
  observer groups (inBattle: false) are not drawn; eliminated
  races drop out and survivors re-distribute on the next frame.
- Shot line per frame: red on destroyed, green otherwise; erased
  on the next frame. Playback controls: play/pause + step ± +
  rewind + 1x/2x/4x speed (400/200/100 ms per frame).
- Page wrapper (lib/active-view/battle.svelte) loads BattleReport
  via api/battle-fetch.ts; synthetic-gameId prefix routes to a
  fixture loader, otherwise REST through the gateway. Always-
  visible <ol> text protocol satisfies the accessibility ask.
- section-battles.svelte links every battle UUID into the viewer.
- map/battle-markers.ts: yellow X cross of 2 LinePrim through the
  corners of the planet's circumscribed square (stroke width
  clamps from 1 px at 1 shot to 5 px at 100+ shots); bombing
  marker is a stroke-only ring (yellow when damaged, red when
  wiped). Wired into state-binding.ts; click handler dispatches
  battle clicks to the viewer and bombing clicks to the matching
  Reports row.
- i18n keys for the viewer in en + ru.

Docs: ui/docs/battle-viewer-ux.md, FUNCTIONAL.md §6.5 + ru
mirror, ui/PLAN.md Phase 27 decisions + deferred TODOs (push
event, richer class visuals, animated re-distribution).

Tests: Vitest unit (radial layout + timeline frame builder +
marker stroke formula + marker primitives), Playwright e2e for
the viewer (Reports link → viewer, playback step, not-found),
backend engineclient FetchBattle (200 / 404 / bad input), engine
openapi freezes (BattleReport, BattleReportGroup,
BattleActionReport, BattleSummary, Report.battle items).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

ui/frontend/src/api/game-state.ts

@@ -382,6 +382,18 @@ export interface ReportBombing {
  * mirrors the producing planet's free industry. Stable order: sorted
  * by `(planetNumber, class)`.
  */
+/**
+ * ReportBattle is one battle summary in the current turn. Carries the
+ * battle UUID, planet number, and shot count — enough to render a
+ * battle marker on the map and to link into the Battle Viewer without
+ * fetching the full BattleReport.
+ */
+export interface ReportBattle {
+	id: string;
+	planet: number;
+	shots: number;
+}
+
 export interface ReportShipProduction {
 	planetNumber: number;
 	class: string;
@@ -524,11 +536,17 @@ export interface GameReport {
 	 */
 	otherShipClass: ReportOtherShipClass[];
 	/**
-	 * battleIds is the list of battle UUIDs the engine recorded for
-	 * the current turn. Phase 23 renders them as inactive
-	 * monospace identifiers; Phase 27 will turn them into navigation
-	 * targets once the battle viewer lands. Empty when no battles
-	 * occurred last turn.
+	 * battles is the list of battle summaries the engine recorded for
+	 * the current turn. Each entry carries the battle UUID, the planet
+	 * it happened on, and the number of shots exchanged. The Reports
+	 * View uses `id` to link into the Battle Viewer; the map renderer
+	 * uses `planet` to locate the marker and `shots` to scale its
+	 * stroke. Empty when no battles occurred last turn.
+	 */
+	battles: ReportBattle[];
+	/**
+	 * battleIds is a convenience derived list of UUIDs from `battles`,
+	 * preserved for legacy callers (Phase 23 report section, fixtures).
 	 */
 	battleIds: string[];
 	/**
@@ -700,7 +718,8 @@ function decodeReport(report: Report): GameReport {
 	const localFleets = decodeLocalFleets(report);
 	const otherScience = decodeOtherScience(report);
 	const otherShipClass = decodeOtherShipClass(report);
-	const battleIds = decodeBattleIds(report);
+	const battles = decodeBattles(report);
+	const battleIds = battles.map((b) => b.id);
 	const bombings = decodeBombings(report);
 	const shipProductions = decodeShipProductions(report);
 
@@ -730,6 +749,7 @@ function decodeReport(report: Report): GameReport {
 		players,
 		otherScience,
 		otherShipClass,
+		battles,
 		battleIds,
 		bombings,
 		shipProductions,
@@ -1153,13 +1173,18 @@ function decodeOtherShipClass(report: Report): ReportOtherShipClass[] {
 	return out;
 }
 
-function decodeBattleIds(report: Report): string[] {
-	const out: string[] = [];
+function decodeBattles(report: Report): ReportBattle[] {
+	const out: ReportBattle[] = [];
 	for (let i = 0; i < report.battleLength(); i++) {
-		const uuid = report.battle(i);
-		const value = uuidStringFromFB(uuid);
-		if (value === null) continue;
-		out.push(value);
+		const summary = report.battle(i);
+		if (summary === null) continue;
+		const id = uuidStringFromFB(summary.id());
+		if (id === null) continue;
+		out.push({
+			id,
+			planet: Number(summary.planet()),
+			shots: Number(summary.shots()),
+		});
 	}
 	return out;
 }
@@ -1439,6 +1464,7 @@ export function applyOrderOverlay(
 		players: report.players ?? [],
 		otherScience: report.otherScience ?? [],
 		otherShipClass: report.otherShipClass ?? [],
+		battles: report.battles ?? [],
 		battleIds: report.battleIds ?? [],
 		bombings: report.bombings ?? [],
 		shipProductions: report.shipProductions ?? [],