fluig-dark-mode
Adapta CSS de customizações Fluig ao modo escuro (dark mode) substituindo cores fixas por variáveis CSS de tema no formato var(--fs-color-*), garantindo que o componente acompanhe a troca de tema automaticamente sem código adicional. Use quando o desenvolvedor pedir para dar suporte a dark mode, adaptar estilos ao tema ativo ou remover hexadecimais fixos de cores de um trecho/arquivo CSS.
totvs · Static checks on file
Installation
Read the source and dependencies before running a command. Copying does not install or execute anything.
npx skills add totvs/fluig-agent-skills --skill fluig-dark-modeAbout this skill
name: fluig-dark-mode description: Adapta CSS de customizações Fluig ao modo escuro (dark mode) substituindo cores fixas por variáveis CSS de tema no formato var(--fs-color-*), garantindo que o componente acompanhe a troca de tema automaticamente sem código adicional. Use quando o desenvolvedor pedir para dar suporte a dark mode, adaptar estilos ao tema ativo ou remover hexadecimais fixos de cores de um trecho/arquivo CSS. argument-hint: o código/CSS alvo a adaptar ao dark mode (trecho ou arquivo com cores fixas)
Adaptação ao Modo Escuro (Dark Mode)
Esta skill adapta o CSS de customizações Fluig ao dark mode usando variáveis de tema; ela não duplica os tokens de cor nem a tabela de mapeamento de cores (uso comum → var(--fs-color-*) e hexadecimal → var(--fs-color-*)) — o arquivo de context/ é a fonte de verdade, referenciada abaixo.
Objetivo
Adaptar, com responsabilidade única, o CSS de uma customização ao modo escuro, substituindo cores fixas (hexadecimais, rgb(), nomes de cor) por variáveis CSS de tema no formato var(--fs-color-*), para que o componente acompanhe a troca de tema (claro/escuro) automaticamente, sem alterar o comportamento nem o layout.
Quando Usar
- Quando um widget/Custom Element usa hexadecimais fixos (
#fff,#202020) para cores de tema. - Quando o componente não acompanha a troca de tema e fica ilegível no modo escuro.
- Antes de publicar uma customização que precisa dar suporte a dark mode.
- Ao revisar CSS próprio e detectar cores que deveriam vir do tema (texto, fundo, borda, sombra).
Entradas Esperadas
| Entrada | Descrição | Obrigatória |
|---|---|---|
| Código/CSS alvo | Trecho ou arquivo CSS com cores a adaptar ao tema | sim |
| Contexto do componente | Tipo/função do elemento (cabeçalho, card, botão, texto) para escolher a família de token adequada | não |
| Tokens já em uso | Variáveis var(--fs-color-*) já adotadas no componente, a manter consistentes | não |
Contexto de Referência (Fonte de Verdade)
Leia antes de executar — não reproduza o conteúdo aqui:
- style-guide.md — seção Theming e dark mode (variáveis CSS): regra obrigatória de usar
var(--fs-color-*), proibição de hexadecimais fixos e de variáveis SCSS para cores de tema, tabelas completas de todas as famílias de tokens (marca, ação, neutros, feedback com tonslightest→darkest, sombras--fs-shadow-*) e a tabela de mapeamento de cores (uso comum →var(--fs-color-*)e hexadecimal →var(--fs-color-*)) usada para converter cores fixas. - Referência completa das variáveis CSS:
references/helpers-and-variables-css/css-variables.md.
Regras Aplicáveis (Resumo Executivo)
Somente o mínimo para orientar a tarefa; o detalhe e o catálogo de tokens estão no contexto:
- Para qualquer cor de tema, usar variáveis CSS no formato
var(--fs-color-*)→ verstyle-guide.md. - ⚠️ Proibido inventar variáveis CSS. Usar somente as variáveis documentadas em
references/helpers-and-variables-css/css-variables.md. Se uma variável não estiver nessa referência, ela não existe no Style Guide — nesse caso, use um valor CSS convencional ou CSS próprio escopado. - Hexadecimais fixos e variáveis SCSS (
$...) para cores de tema são proibidos — não acompanham a troca de tema e quebram o dark mode → verstyle-guide.md. - Ao converter cores fixas, consultar a tabela de mapeamento de cores (uso comum → variável e hexadecimal → variável) que vive em
style-guide.md→ verstyle-guide.md. - Escolher a família de token conforme o papel da cor: marca (
--fs-color-brand-*), ação (--fs-color-action-*), neutros (--fs-color-neutral-*), feedback (--fs-color-positive/negative/warning/info-*) → verstyle-guide.md. - Usar tokens de sombra (
--fs-shadow-*) e tipografia (--fs-font-*) em vez de valores fixos, quando aplicável → verstyle-guide.md. - Reutilizar componentes/classes do Style Guide já adaptados ao tema, em vez de recriar estilos → ver
style-guide.md. - Preservar o layout e o comportamento: trocar apenas a origem da cor, não a estrutura.
Procedimento
- Ler o CSS alvo e listar todas as cores fixas usadas (hexadecimais,
rgb(), nomes de cor) e sombras com valores fixos. - Classificar cada cor pelo seu papel (texto, fundo, borda, ação, feedback) para escolher a família de token correta.
- Substituir cada cor fixa pela variável
var(--fs-color-*)correspondente, consultando a tabela de mapeamento de cores (uso comum → variável e hexadecimal → variável) emstyle-guide.md. - Trocar sombras fixas por tokens
--fs-shadow-*e, quando houver, fonte/cor de texto por tokens--fs-font-*. - Verificar que nenhum hexadecimal fixo de cor de tema permaneceu e que o layout não mudou.
- Conferir o resultado com o checklist abaixo antes de entregar.
Saída Esperada
CSS adaptado ao dark mode, com todas as cores de tema expressas como var(--fs-color-*) (e sombras/tipografia via tokens quando aplicável), sem hexadecimais fixos de tema, com layout e comportamento preservados e adaptação automática à troca de tema. Em conformidade com context/style-guide.md.
Exemplo de Uso
Antes (cores fixas — não acompanham o tema, quebram no dark mode):
/* ❌ hexadecimal fixo: ilegível ao trocar para o modo escuro */
.my-widget__header {
color: #202020;
background-color: #ffffff;
box-shadow: 0 1px 2px rgba(0, 0, 0, 0.15);
}
Depois (variáveis de tema — adaptam-se automaticamente):
/* ✅ usa var(--fs-color-*) e token de sombra: adapta a dark mode sem código extra */
.my-widget__header {
color: var(--fs-color-neutral-dark-90);
background-color: var(--fs-color-neutral-light-00);
box-shadow: var(--fs-shadow-sm);
}
Checklist de Validação
- Toda cor de tema usa
var(--fs-color-*); nenhum hexadecimal fixo de tema permaneceu. - A família de token escolhida corresponde ao papel da co