Define as regras, uso pretendido, variação permitida, exemplos e requisitos de consistência para mensagens de validação. Esta referência fixa o limite de adoção, comportamento em falhas e evidências observáveis, deixando os limites específicos do ambiente configuráveis.
Status do pacote: contexto de referência pronto para revisão humana. O contrato e os cenários de teste estão completos, mas não se afirma que uma implementação adotante os tenha aprovado.
Decisão
Para mensagens de validação, adote tokens de design versionados e contratos de componentes compartilhados por design e implementação. Defina uma jornada do usuário determinística com estado visível, escolhas reversíveis quando possível, entrada preservada e recuperação acessível. Este pacote é um contrato de referência: a equipe adotante deve escolher limites numéricos, provedores, jurisdições e responsáveis operacionais a partir de evidências em seu próprio ambiente.
Escopo
- Os atores, entradas, saídas, estados, versões de política ou esquema e resultados visíveis externamente descritos por este bloco de UX.
- Interfaces primárias e alternativas, trabalho em segundo plano, caches, integrações, caminhos de suporte e evidências que podem exercer o mesmo limite.
- Configuração específica de adoção, implantação, recuperação e responsabilidades de verificação necessárias para aplicar a referência com segurança.
Fora deste bloco
- Escolher um fornecedor universal, framework, jurisdição, limite numérico, período de retenção ou objetivo de nível de serviço para todos os adotantes.
- Alegar que cenários empacotados foram executados contra uma implementação a jusante ou que esta referência concede certificação legal, de segurança ou acessibilidade.
Contrato
- Nomeie tokens por propósito semântico; o código do produto não depende de valores brutos de paleta, espaçamento ou tipografia quando um token semântico existe.
- Defina variantes e estados permitidos com comportamento de acessibilidade, restrições de conteúdo e comportamento responsivo no mesmo contrato.
- Trate mudanças quebradoras de tokens ou componentes como migrações com propriedade, notas de compatibilidade e adoção mensurável.
- Use verificações visuais como evidência de mudança, não como único teste para semântica, operação por teclado ou nomes acessíveis.
- Mostre progresso apenas enquanto o trabalho estiver realmente pendente e evite ativações duplicadas sem ocultar a intenção comprometida do usuário.
- Use mensagens simples e específicas para ação que distingam validação, permissão, conectividade, conflito e falha terminal.
- Declare o problema e a recuperação em linguagem simples, nomeie o campo ou regra afetada e mantenha a redação consistente com a validação do servidor e o valor enviado pelo usuário.
- Associe mensagens programaticamente, anuncie novos erros sem repetição, preserve entrada válida, evite indicadores apenas por cor e localize valores dinâmicos e formas plurais com segurança.
Orientações de implementação
- Prototipe os caminhos mais longos, vazios, lentos, offline, negados e de tecnologia assistiva antes de travar o layout do caminho feliz.
- Modele entradas, saídas, atores, estados, invariantes, efeitos colaterais e evidências das mensagens de validação antes de selecionar detalhes de framework ou fornecedor.
- Armazene a versão aplicável do contrato ou política de mensagens de validação com o estado material para que migrações, reprodução e decisões de suporte permaneçam atribuíveis.
- Introduza o caminho por trás de implantação controlada, compare resultados esperados e observados e mantenha uma rota de recuperação testada até que a evidência de adoção esteja completa.
Tratamento de falhas e salvaguardas
- Um token ou variante desconhecida falha visivelmente em desenvolvimento e usa um fallback seguro documentado em clientes liberados.
- Estado inválido ou contraditório de mensagens de validação é rejeitado ou colocado em quarentena; a implementação nunca supõe um valor que amplie autoridade ou duplique um efeito.
- Retentativas são limitadas e usam identidade durável; após esgotamento, o trabalho alcança um estado terminal inspecionável com um responsável accountable.
Verificação e operações
- Complete a jornada com teclado, toque, leitor de tela, viewport estreito, rede com atraso e erro de servidor recuperável.
- Monitore sucesso, negação, falha de validação, falha de dependência, esgotamento de retentativas e recuperação por versão do contrato sem dimensões sensíveis de payload.
- Reexecute fixtures positivos e negativos pareados após mudanças de política, esquema, dependência, migração ou limite e preserve a evidência resultante.
Suposições de adoção
- Nomes e valores no exemplo são um fixture concreto, não padrões universais; adotantes os substituem por meio de evidência documentada e propriedade.
- O sistema adotante pode fornecer identidade autenticada, versões duráveis de operação ou registro, telemetria limitada e um caminho controlado para mudança.
Os exemplos com aparência executável neste pacote são fixtures e contratos de aceitação. Execute o validador da coleção para verificar estrutura e metadados, depois traduza e execute os cenários no repositório alvo antes de registrar evidências da implementação.