# Prazo que vence

Todo prazo que a tela impõe se avisa antes e se estende com um gesto (WCAG
2.2.1, nível A).

## O problema

A sessão que expira no meio do cadastro leva o cadastro junto. O Pix que vence
sem dizer quanto falta deixa a pessoa pagando um QR morto. E o cronômetro de
reserva vira pressão, que é a ferramenta de quem vende enganando.

## Quando usar

Sempre que a tela tem um relógio que a pessoa não controla: sessão que termina
por inatividade, código Pix com validade, reserva de estoque ou de horário,
código de verificação por SMS, link de pagamento.

## Quando não usar

- **Prazo inventado para apressar** não é prazo: é padrão enganoso
  ([padroes-enganosos.md](https://ds.rivocode.com.br/padroes/padroes-enganosos.md)). Oferta que reinicia, "só
  hoje" que dura a semana, cronômetro no carrinho sem reserva de verdade.
- **Sessão curta sem motivo** também não: o prazo existe por segurança, e só
  onde a segurança pede (banco, prontuário, painel administrativo).

## As peças

- `useIdle`: diz quando a pessoa parou.
- `AlertDialog`: o aviso de sessão, que não se dispensa clicando fora.
- `PixCode` com `expiresAt`, `onExpire` e `onRenew`: o Pix que conta quanto
  falta, vence sozinho e oferece gerar outro. `expired` é para quando quem
  sabe que venceu é o servidor.
- `RelativeTime` e `Text` com `tabular-nums`: o quanto falta, perto do valor.

## Comportamento

- **Sessão que expira** avisa com pelo menos um minuto de folga, num
  `AlertDialog` "Sua sessão termina em 1 minuto", com "Continuar conectado" de
  primária. Se expirar mesmo assim, o que foi digitado volta depois do novo
  login: perder um cadastro inteiro para o relógio é o pior desfecho de
  formulário que existe.
- **Pix com validade** mostra quanto falta perto do valor ("Vence em 14:32"):
  é o `expiresAt` do `PixCode`, que faz a conta, anuncia uma vez e no último
  minuto, e no fim troca o QR pelo vencido com o `onRenew`. O prazo do Pix é do
  intermediador e não se estende; renovar é a extensão.
- **Reserva de estoque ou de horário** diz quanto tempo segura e o que acontece
  no fim ("O horário fica reservado até 14h40. Depois disso, ele volta para a
  agenda"), e nunca é cronômetro de pressão.
- **O relógio para quando a pessoa está trabalhando.** Digitar, rolar e clicar
  contam como presença; o `useIdle` só dispara depois da pausa.

## Texto

- O aviso diz quanto falta e o que acontece: "Sua sessão termina em 1 minuto.
  O que você digitou fica guardado."
- O botão que estende diz o que faz: "Continuar conectado", "Gerar outro
  código Pix". Nunca "OK".
- O vencido diz que venceu e o próximo passo: "Este código Pix venceu. Gere
  outro para pagar."

## Acessibilidade

- O aviso de sessão chega antes do fim, com tempo para quem lê devagar ou usa
  leitor de tela: um minuto é o piso, e não o alvo.
- O contador que muda a cada segundo **não** é região viva: anunciar cada
  segundo atropela o leitor. Anuncie o aviso uma vez, e de novo no último
  minuto.
- Estender é um gesto só, alcançável pelo teclado, com o foco já nele.

## No celular e no nativo

No celular a pessoa sai do app para copiar o código Pix no banco e volta: o
prazo conta enquanto ela está fora, e a tela, ao voltar, mostra o que sobrou ou
o vencido com o renovar. O `PixCode` mora em `@rivocode/ui-native/chart`, com o
copiar por `renderCopy`. O `AlertDialog` nativo é controlado, com `onConfirm` e
`labels`.

## Os blocos que o aplicam

Nenhum bloco do site tem prazo ainda. O Pix inteiro, do QR ao recibo, está em
[comercio.md](https://ds.rivocode.com.br/skill/reference/comercio.md).
