# Contagem regressiva (`contagem-regressiva`)

<!-- GERADO por scripts/gerar-catalogo.mjs a partir do componente.json. Para mudar, edite o componente.json e rode o script. -->

Dias, horas, minutos e segundos até um prazo real, com texto para leitor de tela e mensagem de encerramento automática.

- **Categoria:** Interativos
- **Equivalente no Elementor:** Contagem Regressiva (Countdown)
- **Arquivos:** `contagem-regressiva.html`, `contagem-regressiva.css`, `contagem-regressiva.js`
- **Precisa de JavaScript:** sim (inicia por `data-ds-regressiva`, `data-ds-regressiva-fim`, `data-ds-dias`, `data-ds-horas`, `data-ds-minutos`, `data-ds-segundos`, `data-ds-regressiva-texto`)

## Quando usar
- Fim de inscrição, de lote ou de condição especial com data real
- Início de evento ou aula ao vivo

## Quando não usar
- Prazo falso ou que reinicia a cada visita: engana o cliente e queima a marca
- Oferta sem data de fim

## Variações
- **Padrão:** classe ds-regressiva
- **Compacta (ao lado do botão):** classe ds-regressiva--compacta

## Conteúdo esperado
- Data e hora do prazo com fuso (ISO, ex.: 2026-12-31T23:59:00-03:00)
- Frase antes do relógio
- Mensagem de encerramento

## Acessibilidade
- Relógio que muda a cada segundo fica com aria-hidden (não interrompe o leitor de tela)
- Texto .ds-sr-only diz a data e a hora do prazo por extenso
- Números com largura fixa (não pulam)

## Como carregar

```html
<link rel="stylesheet" href="tokens.css"><!-- do projeto, gerado por gerar-tokens-css.mjs -->
<link rel="stylesheet" href="base/base.css">
<link rel="stylesheet" href="componentes/contagem-regressiva/contagem-regressiva.css">
<script src="componentes/contagem-regressiva/contagem-regressiva.js" defer></script>
```

Tokens do contrato usados: `--ds-cor-destaque`, `--ds-cor-sobre-destaque`, `--ds-cor-texto-suave`, `--ds-cor-titulo`, `--ds-espaco-1`, `--ds-espaco-2`, `--ds-espaco-3`, `--ds-fonte-impacto`, `--ds-fonte-titulo`, `--ds-raio-md`, `--ds-tamanho-cartao`, `--ds-tamanho-h2`, `--ds-tamanho-legenda`.

## Notas

A classe principal é ds-regressiva (nome curto).