A shoot-out between police and an armed gang involved in a South African supermarket robbery left 12 people dead, including four police officers.