# Battle Unit Hitbox Verification

Date: 2026-07-03

## Change

- Unit sprites no longer receive pointer input from the full enlarged sprite rectangle.
- Each unit now owns an invisible tile-sized hit zone centered on its tactical tile.
- The hit zone follows unit movement, visibility, retreat state, and map visibility.
- Attack/support target markers stay above unit hit zones, so target selection keeps priority during targeting.

## Local Verification

- Command: `pnpm build`
- URL: `http://127.0.0.1:4193/heros_web/?debug&debugBattleSetup=attack-preview&v=unit-hitbox-local`
- Adjacent unit selection: clicked Liu Bei, Guan Yu, and Zhang Fei by tile center; final selection was Zhang Fei.
- Command menu: clicked Zhang Fei tile center again; Zhang Fei command menu opened.
- Targeting: selected Guan Yu attack, clicked the adjacent Yellow Turban target, and opened combat prediction.
- Console errors: 0

Screenshots:

- `docs/battle-unit-hitbox-local-selection.png`
- `docs/battle-unit-hitbox-local-command-menu.png`
- `docs/battle-unit-hitbox-local-target-chosen.png`

## Deployed Verification

- Command: `pnpm deploy:nas`
- URL: `https://comtropy.synology.me/heros_web/?debug&debugBattleSetup=attack-preview&v=unit-hitbox-20260703`
- Adjacent unit selection: clicked Liu Bei, Guan Yu, and Zhang Fei by tile center; final selection was Zhang Fei.
- Command menu: clicked Zhang Fei tile center again; Zhang Fei command menu opened.
- Targeting: selected Guan Yu attack, clicked the adjacent Yellow Turban target, and opened combat prediction.
- Console errors: 0

Screenshots:

- `docs/battle-unit-hitbox-prod-selection.png`
- `docs/battle-unit-hitbox-prod-command-menu.png`
- `docs/battle-unit-hitbox-prod-target-chosen.png`