Sobrescrita de superfícies sem seletor claro faz título herdar a cor do fundo do card

[!NOTE] Resumo Executivo (DEV-2026-158): Nos temas claros ProntOS e Central de Aventura, o texto de títulos h2 dentro de cards sumia por se igualar ao fundo branco ou washi. O seletor de tema claro não declarava a cor de texto contrastante e classes conflitantes de card misturavam fundos escuros e claros.


🚨 O Desafio Técnico / Contexto

Em 2026-11-13, após a padronização do modo escuro, os títulos h2 dentro de cards nos temas claros (ProntOS / AgendaSul e Central de Aventura) sumiram da tela por estarem com a mesma tonalidade da superfície do card.


💡 Principais Lições Aprendidas & Descobertas

  • 💡 Declarar regras de contraste para [data-triade-mode=’dark’] sem o bloco espelho [data-triade-mode=’light’] deixa os títulos dos temas claros vulneráveis a heranças indevidas.
  • 💡 O tema padrão agendasul precisa ter seletor explícito [data-triade-theme=’agendasul’] no CSS para igualar a especificidade dos temas temáticos como central-de-aventura.
  • 💡 Banners e blocos que já possuem gradiente próprio ou fundo escuro explícito (.bg-slate-900, .bg-gradient-to-r) não devem herdar a classe .card, cujo @apply bg-white injeta cor de superfície conflitante.

🛠️ Especificação Técnica & Código-Chave

/* Garantia de contraste nos temas claros */
[data-triade-mode="light"] :is(.card, main) :is(h1, h2, h3, h4, h5, h6):not([class*="text-white"]) {
  color: rgb(var(--tr-gray-900)) !important;
}

📈 Impacto no Ecossistema & Valor Prático

Os títulos e cabeçalhos de todos os cards recuperaram legibilidade e contraste absoluto nos temas claros e escuros.

  • Projetos Relacionados: 30-FieldFlow, triade-artesdosul
  • Registro de Origem: _data/daily.dev-27.yml

Publicado originalmente como parte do Diário de Desenvolvimento 2026 do ecossistema Artes do Sul & Araguaci.