fluig-style-guide-helpers
Substitui CSS customizado e comportamentos recriados manualmente por helpers, componentes, grid e classes utilitárias do Fluig Style Guide (FLUIGC e Bootstrap 3.4.1), reduzindo código próprio e garantindo consistência visual e adaptação automática ao tema. Use quando o desenvolvedor pedir para trocar estilos/markup customizados por recursos oficiais do Style Guide ou simplificar CSS próprio reutilizando o design system.
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-style-guide-helpersAbout this skill
name: fluig-style-guide-helpers description: Substitui CSS customizado e comportamentos recriados manualmente por helpers, componentes, grid e classes utilitárias do Fluig Style Guide (FLUIGC e Bootstrap 3.4.1), reduzindo código próprio e garantindo consistência visual e adaptação automática ao tema. Use quando o desenvolvedor pedir para trocar estilos/markup customizados por recursos oficiais do Style Guide ou simplificar CSS próprio reutilizando o design system. argument-hint: o código/CSS/markup alvo a substituir por helpers e componentes do Style Guide
Substituição de CSS Customizado por Helpers do Style Guide
Esta skill substitui CSS/markup próprio por recursos do Fluig Style Guide; ela não duplica o catálogo. As categorias do Style Guide (CSS, Components, Forms, JavaScript plugins, Chart, Miscellaneous) e as famílias de classes helper fs-* vivem em context/style-guide.md, que é a fonte única de verdade referenciada abaixo.
Objetivo
Substituir, com responsabilidade única, CSS customizado e comportamentos recriados manualmente por helpers, componentes, grid e classes utilitárias do Fluig Style Guide, reduzindo código próprio e garantindo consistência visual e adaptação automática ao tema, sem alterar o comportamento observável.
Quando Usar
- Quando há CSS próprio que recria botões, cards, alertas, tabelas, formulários ou tipografia já oferecidos pelo Style Guide.
- Quando layouts usam posicionamento/medidas fixas em vez do grid responsivo.
- Quando comportamentos (modais, toasts, datatables, calendários, selects) são reimplementados manualmente em vez de usar
FLUIGC.*. - Quando imagens próprias são usadas no lugar dos ícones do Style Guide.
Entradas Esperadas
| Entrada | Descrição | Obrigatória |
|---|---|---|
| Código/CSS/markup alvo | Trecho ou arquivo com estilos/comportamentos customizados a substituir | sim |
| Contexto do componente | Função visual do elemento (botão, card, tabela, modal) para escolher o helper/componente adequado | não |
| Escopo do widget | Confirmação de que o elemento raiz tem a classe fluig-style-guide (escopo do Style Guide) | não |
Contexto de Referência (Fonte de Verdade)
Leia antes de executar — não reproduza o conteúdo aqui:
- style-guide.md — categorias do Style Guide (CSS, Components, Forms, JavaScript plugins, Chart, Miscellaneous) e classes helper
fs-*(scrollbar, posicionamento, display, flexbox com gap, tamanho, espaçamento responsivo com breakpoints, tipografia, cursor, background, cor de texto, formulário e utilitários gerais); além da API JavaScript pública (FLUIGC), sistema de grid (Bootstrap 3.4.1), ícones, helpers de comportamento (FLUIGC.utilities) e a regra de tema viavar(--fs-color-*). - Referência completa das classes helper
fs-*:references/helpers-and-variables-css/helper-classes.md.
Regras Aplicáveis (Resumo Executivo)
Somente o mínimo para orientar a tarefa; o catálogo completo está no contexto:
- Reutilizar componentes/classes do Style Guide (botões, cards, alertas, tabelas, formulários, tipografia) antes de escrever CSS próprio → ver
style-guide.md. - ⚠️ Proibido inventar classes helpers ou variáveis CSS. Usar somente as classes documentadas em
references/helpers-and-variables-css/helper-classes.mde as variáveis documentadas emreferences/helpers-and-variables-css/css-variables.md. Se não estiver nessas referências, não existe no Style Guide. - Usar o grid responsivo (
.container/.row/.col-*) em vez de posicionamento/medidas fixas → verstyle-guide.md. - Usar a API pública
FLUIGC.*(ex.:modal,toast,datatable,calendar,select,loading) em vez de recriar comportamentos → verstyle-guide.md. - Usar ícones do Style Guide (
flat/animalia,FLUIGC.icons()) em vez de imagens próprias → verstyle-guide.md. - Aproveitar classes utilitárias (espaçamento, alinhamento, visibilidade responsiva) e as classes helper
fs-*do Style Guide — scrollbar, posicionamento, display, flexbox (alinhamento, justify, direção, gap), tamanho, espaçamento responsivo com breakpoints (fs-mt-24,sm:fs-mt-16), tipografia, cursor, background, cor de texto e utilitários gerais; referência completa emreferences/helpers-and-variables-css/helper-classes.md→ verstyle-guide.md. - Manter cores de tema via
var(--fs-color-*)(sem hexadecimais fixos) ao ajustar estilos remanescentes → verstyle-guide.md. - Garantir a classe
fluig-style-guidena raiz para que os estilos/componentes se apliquem no escopo do widget → verstyle-guide.md.
Procedimento
- Ler o código alvo e mapear cada bloco de CSS/markup próprio e cada comportamento reimplementado.
- Identificar o recurso equivalente do Style Guide (componente/classe, item do grid, helper
FLUIGC.*ou ícone) consultandostyle-guide.md. - Substituir o CSS/markup próprio pelas classes/componentes oficiais e os comportamentos manuais pelos helpers
FLUIGC.*. - Converter layouts com medidas fixas para o grid responsivo e trocar imagens próprias por ícones do Style Guide quando aplicável.
- Remover o CSS próprio que ficou redundante; nos estilos remanescentes, usar
var(--fs-color-*)e classes utilitárias. - Confirmar o escopo (
fluig-style-guidena raiz) e validar o resultado com o checklist abaixo, preservando o comportamento.
Saída Esperada
Código que reutiliza helpers, componentes, grid, ícones e utilitários do Fluig Style Guide, com CSS próprio reduzido ao mínimo necessário, comportamento preservado, consistência visual e adaptação automática ao tema. Em conformidade com context/style-guide.md.
Exemplo de Uso
Antes (CSS próprio recriando um botão, com cor fixa):
<!-- ❌ botão recriado manualmente em vez do componente do Style Guide -->
<a class="my-custom-btn" onclick="save()">Salvar</a>
.my-custom-btn {
display: inline-
Read the complete source ↗