Wire map images and Steam brand icon

ai/tasks/done/TASK-249-wire-map-images-and-steam-brand-icon.md

@@ -0,0 +1,120 @@
+# TASK-249 - Wire map images and Steam brand icon
+
+## Summary
+
+This task connects the new local map images to current match and historical match detail using a shared frontend resolver, and wires the new Steam brand icon into the external profile buttons.
+
+No map or brand asset files were modified.
+
+## Files Read First
+
+- `frontend/partida-actual.html`
+- `frontend/assets/js/partida-actual.js`
+- `frontend/historico-partida.html`
+- `frontend/assets/js/historico-partida.js`
+- `frontend/assets/css/historico.css`
+- `frontend/assets/img/maps/`
+- `frontend/assets/img/brands/`
+
+## Problem
+
+The frontend was still using narrow map-name heuristics and did not know how to resolve the new map image naming pattern consistently across:
+
+- current match
+- historical match detail
+
+The Steam external profile button also had no brand icon wired even though the asset already existed locally.
+
+## Decision
+
+Create one shared client-side resolver instead of duplicating ad hoc logic in each page.
+
+Rules:
+
+- normalize map ids, layer ids and pretty names aggressively
+- resolve to local assets using the `mapid-environment.webp` pattern when possible
+- keep a safe fallback image path
+- do not modify physical assets
+
+## Asset Coverage Detected
+
+Detected local coverage in `frontend/assets/img/maps/`:
+
+- `carentan`: day, dusk, night, rain
+- `driel`: dawn, day, night
+- `elalamein`: day, dusk
+- `elsenbornridge`: dawn, day, dusk, night
+- `foy`: day, night
+- `hill400`: day, dusk, night
+- `hurtgenforest`: day, night
+- `junobeach`: dawn, day, night
+- `kharkov`: day, night
+- `kursk`: day, night
+- `mortain`: day, dusk, night, overcast
+- `omahabeach`: day, dusk
+- `purpleheartlane`: dawn, day, night, rain
+- `remagen`: day, night
+- `smolensk`: day, dusk, night
+- `stalingrad`: day, dusk, night, overcast
+- `stmariedumont`: day, night, rain
+- `stmereeglise`: dawn, day, night
+- `tobruk`: dawn, day, dusk
+- `utahbeach`: day, night
+- fallback assets: `unknown-day.webp`, `unknown.webp`
+
+## Implementation
+
+### Shared map resolver
+
+Added `frontend/assets/js/map-image-resolver.js` with:
+
+- canonical map aliases
+- environment aliases
+- compact normalization of layer ids and display names
+- deterministic fallback selection
+
+Examples resolved correctly:
+
+- `junobeachwarfare` -> `./assets/img/maps/junobeach-day.webp`
+- `Juno Beach Warfare` -> `./assets/img/maps/junobeach-day.webp`
+- `utahbeach` -> `./assets/img/maps/utahbeach-day.webp`
+- `Driel` -> `./assets/img/maps/driel-day.webp`
+- `st marie du mont warfare` -> `./assets/img/maps/stmariedumont-day.webp`
+
+### Current match
+
+- `partida-actual.html` now loads the shared resolver before the page script.
+- `partida-actual.js` now resolves map assets from layer id, map id and pretty names instead of a short hardcoded map list.
+
+### Historical match detail
+
+- `historico-partida.html` now loads the shared resolver.
+- `historico-partida.js` now resolves map images from `match_id`, `map.id`, `map.name` and `map.pretty_name`.
+- It keeps the existing fallback behavior if no match is found.
+
+### Steam brand icon
+
+- Wired the Steam profile button to `./assets/img/brands/steam.png`.
+- Added `onerror="this.remove();"` to brand icons so a missing file does not leave a broken image.
+
+## Validation
+
+Executed:
+
+- `node --check frontend/assets/js/map-image-resolver.js`
+- `node --check frontend/assets/js/partida-actual.js`
+- `node --check frontend/assets/js/historico-partida.js`
+
+Static/runtime validation performed:
+
+- confirmed `historico-partida.html` does not load `current-match-weapon-icons.js`
+- confirmed `partida-actual.html` still loads `current-match-weapon-icons.js`
+- confirmed resolver maps `junobeachwarfare` to `junobeach-day.webp`
+- confirmed resolver maps `utahbeach`, `driel` and `st marie du mont warfare` to existing local assets
+- confirmed Steam button now points to the brand icon asset when present
+
+## Notes
+
+- No backend changes were required for this task.
+- No asset files were moved, renamed or modified.
+- No weapon or clan asset path was touched.