@poly-ds/styles
v0.2.4
Published
CSS da design system: tokens em 3 camadas, temas e estilos de componente
Maintainers
Readme
@poly-ds/styles
CSS da design system poly-ds: tokens em 3 camadas (primitivo → semântico →
componente), 12 marcas × 2 esquemas (claro/escuro) × 2 densidades, e o estilo
de cada componente. Consumido junto de @poly-ds/react, @poly-ds/vue ou
@poly-ds/angular — nenhum deles funciona visualmente sem este pacote.
Instalação
npm install @poly-ds/stylesUso
import '@poly-ds/styles';Um único import de efeito colateral traz tudo: tokens primitivos, os 12 temas e o CSS de todos os componentes. Para consumidores que só usam um subconjunto de componentes e querem economizar bytes, os arquivos gerados também são importáveis em partes:
import '@poly-ds/styles/base.css'; // só tokens primitivos + semânticos
import '@poly-ds/styles/themes.css'; // só as 12 marcas
import '@poly-ds/styles/components/button.css'; // um componente específicoAplicando um tema
Os três eixos são atributos HTML — nenhum JS é necessário para o CSS funcionar:
<html data-ds-theme="mono" data-ds-scheme="dark" data-ds-density="compact"></html>Para persistir a escolha do usuário, seguir o SO ao vivo e evitar flash no
primeiro paint, use @poly-ds/theme-manager — guia completo em
docs/TROCANDO-DE-TEMA.md.
Sobrescrevendo estilo
Cada componente lê a camada 3 de tokens, a API pública de override, válida a partir de qualquer ancestral:
.formulario-compacto {
--ds-input-padding-y: 2px;
--ds-input-radius: 0;
}Detalhes do modelo de 3 camadas em
docs/CRIANDO-UM-TEMA.md e no
README principal.
