Single State, Enum (Discriminated Union)

Regra

Nunca crie vários $state/ref/useState booleanos (ou null) para controlar modais, abas, etapas ou modos de exibição. Use um único estado cujo valor é uma discriminated union (um enum com payload), onde type (ou status) identifica o estado ativo.

O type é sempre explícito — inclusive o estado "fechado/none". Isso elimina a classe inteira de bugs de "dois toggles dessincronizados" e deixa explícito qual overlay pode estar aberto (só um por vez).

Por quê