# Nexaya Design System

> Design system com tokens em camadas (--nx-brand-* → --nx-pr-* → --nx-color-*/--nx-data-*), temas por preset+modo, biblioteca de componentes (HTML só com tokens), gráficos SVG nativos (NX) e a galeria Vega-Lite inteira com o tema aplicado. Tudo acessível por REST e por MCP.

Versão 1.4.0. Idioma dos docs: pt-BR. Tudo é somente leitura e sem autenticação.

## Como usar
- Tokens: carregue /ds/tokens/tokens.css + /ds/tokens/preset-<preset>.css e envolva com data-nx-preset="<preset>" data-nx-theme="light|dark". Nunca escreva cor fixa: use var(--nx-*).
- Componentes: GET /api/components/{id}?theme=<id>&brand=<nome> devolve HTML só com tokens; {{brand}} é a marca.
- Gráficos nativos: /ds/charts/nexaya-charts.js; el.innerHTML = NX.<fn>(args); NX.attach(el) dá realce e tooltip; classe nx-play anima a entrada. SVG pronto: /api/charts/{id}/svg?theme=<id>.
- Vega-Lite / Altair: /api/vega/{name}?theme=<id> devolve o spec com o tema; /api/vega/theme/{theme} é o config para qualquer spec.
- Para TROCAR um gráfico seu pelo equivalente do DS: tool find_equivalent("descrição do seu gráfico") ou GET /api/charts/equivalent?q=… → devolve a chamada NX pronta e o exemplo Vega; depois get_chart_type(id) / get_vega_example(name). Dados vão no formato de args; cores nunca — só tokens.
- Tudo em um JSON: /api/manifest. OpenAPI: /openapi.json. MCP: https://ds.nexaya.com.br/mcp (tools: get_manifest, find_equivalent, search, fetch, themes, list_components, get_component, get_tokens, get_doc, check_contrast, list_chart_types, get_chart_type, get_chart_library, list_vega_examples, get_vega_example, get_vega_theme).

## Temas
- pastel-gold — Pastel Gold (nexaya/light, família gold, primária #FFD85F)
- slate-neon — Slate Neon (nexaya/dark, família gold, primária #FFD85F)
- mint-paper — Mint Paper (govsc/light, família mint, primária #A1C84D)
- forest-dark — Forest Dark (govsc/dark, família mint, primária #A1C84D)
- carbon-lime — Carbon Lime (carbono/dark, família carbon, primária #A1C84D)
- navy-sky — Navy Sky (azul/dark, família navy, primária #5B9BFF)
- silver-ash — Silver Ash (prata/dark, família silver, primária #B4BCC5)
- ruby-paper — Ruby Paper (vermelho/light, família ruby, primária #B12626)
- rose-petal — Rose Petal (rosa/light, família rose, primária #F2A7C3)
- lilac-paper — Lilac Paper (roxo/light, família violet, primária #B9A6E8)
- cyan-mist — Cyan Mist (ciano/light, família cyan, primária #8FD3E0)
- cocoa-clay — Cocoa Clay (marrom/light, família brown, primária #CCB29C)
- peach-sun — Peach Sun (laranja/light, família orange, primária #F3B06E)

## Regras
- nunca cor fixa: só var(--nx-*)
- sem grade nos gráficos; eixo só com rótulos e linha-base pontilhada
- no máximo 2 séries destacadas (primária + referência tracejada); demais nos tons da família
- paleta categórica = família do tema (primária, referência, neutro, primária clara, ocioso, trilha) — status só com semântica de status
- cantos redondos; arcos com recuo angular e pontas redondas; hachura = sem cobertura
- números pt-BR (1.234,5)
- número grande é font-weight 300
- a marca é {{brand}} no código

## Docs
- https://ds.nexaya.com.br/api/docs/master: Especificação completa (17 blocos)
- https://ds.nexaya.com.br/api/docs/guia: Guia de reprodução para IA (canvas, componentes difíceis, contexto de cor, receitas)
- https://ds.nexaya.com.br/api/docs/motion: Movimento: durações, easings, coreografia por gráfico
- https://ds.nexaya.com.br/api/docs/mobile: Mobile 390×844: 20 telas, componentes
- https://ds.nexaya.com.br/api/docs/charts: Gráficos: biblioteca nativa, galeria Vega, regras de cor, mapas IBGE
- https://ds.nexaya.com.br/api/docs/tokens: Temas e tokens: camadas, receita de um preset novo, validação
- https://ds.nexaya.com.br/api/docs/amostras: Amostras de pixel (evidência das cores)
- https://ds.nexaya.com.br/api/docs/contraste: Auditoria de contraste por tema

## Endpoints
- https://ds.nexaya.com.br/api/health
- https://ds.nexaya.com.br/llms.txt
- https://ds.nexaya.com.br/llms-full.txt
- https://ds.nexaya.com.br/api/manifest
- https://ds.nexaya.com.br/api/themes
- https://ds.nexaya.com.br/api/components
- https://ds.nexaya.com.br/api/components/{id}
- https://ds.nexaya.com.br/api/tokens
- https://ds.nexaya.com.br/api/docs
- https://ds.nexaya.com.br/api/docs/{key}
- https://ds.nexaya.com.br/api/contrast
- https://ds.nexaya.com.br/api/charts
- https://ds.nexaya.com.br/api/charts/{id}
- https://ds.nexaya.com.br/api/charts/{id}/svg
- https://ds.nexaya.com.br/api/charts/library
- https://ds.nexaya.com.br/api/vega
- https://ds.nexaya.com.br/api/vega/{name}
- https://ds.nexaya.com.br/api/vega/theme/{theme}
- https://ds.nexaya.com.br/mcp
- https://ds.nexaya.com.br/ds/{path}
- https://ds.nexaya.com.br/openapi.json