# Changelog — PRF Design System

Todas as mudanças relevantes deste design system são documentadas neste arquivo.

Formato baseado em [Keep a Changelog](https://keepachangelog.com/pt-BR/1.1.0/),
versionamento semântico adaptado ao contexto institucional:

- **major** (v2.0+): mudanças em cores oficiais, tipografia ou princípios.
- **minor** (v1.x): mudanças em componentes, escalas auxiliares, ícones ou famílias tipográficas.
- **patch** (v1.0.x): correções pontuais sem impacto visual significativo.

---

## [1.1.0] — 2026-04-27

Atualização menor incorporando orientações da Coordenação-Geral de Comunicação Social
(CGCOM/PRF) sobre adequação a interfaces digitais.

### Adicionado

- **Material Symbols Outlined** como família oficial de iconografia digital.
  - Licença Apache 2.0, livre, auto-hospedável.
  - Fonte variável (suporta FILL/wght/GRAD/opsz).
  - Padrão: outlined, weight 400, grade 0, fill 0, optical size 24.
  - Catálogo: https://fonts.google.com/icons
- Token `--bg-elevated` para superfícies elevadas (cards, modais, popovers).
  No tema claro = branco puro `#FFFFFF`; no tema escuro = `#0B0F1F`.
- Tonalidades de amarelo (`--amarelo-100` a `--amarelo-20`) explicitadas no
  `tokens.css` (já existiam no `tailwind.config.js`).
- Recursos OpenType do Inter (`cv02`, `cv03`, `cv04`, `cv11`, `ss01`, `calt`)
  ativados via `font-feature-settings` para legibilidade aprimorada em tela.

### Alterado

- **Tipografia primária**: Fira Sans → **Inter** (v4.0+, OFL, auto-hospedável).
  - Inter é desenhada especificamente para UI digital (objeto do Caderno 10).
  - Fira Sans permanece disponível como variante (`[data-typeface="fira"]`)
    para uso em peças impressas institucionais que já a adotem.
- **Token `--neutral-50`**: `#F7F7F8` → `#F5F5F5`.
  - Reduz fadiga visual em uso prolongado.
  - Alinha-se a sistemas de design contemporâneos (Material, shadcn, GitHub).
- **Token `--bg`** (tema claro): `--prf-branco` → `--neutral-50` (`#F5F5F5`).
  - Branco puro permanece em superfícies elevadas via `--bg-elevated`.
- `globals.css`: variável `--background` (shadcn HSL) atualizada de `0 0% 100%`
  para `0 0% 96%` (corresponde a `#F5F5F5`).
- `globals.css`: variável `--muted` ajustada de `220 7% 95%` para `220 7% 92%`
  para manter contraste adequado com o novo `--background` mais escuro.

### Mantido (sem alteração)

- Cores institucionais oficiais (Azul PRF `#000D4B`, Amarelo PRF `#FFC900`,
  Branco) — alinhadas ao MIV 7.0, Caderno 05, pág. 189.
- Pantone TPX (19-4027 e 14-0852).
- Princípio de tema duplo (claro padrão / escuro variação), com inversão de
  papéis no escuro (Amarelo PRF assume primária).
- WCAG 2.1 AA como requisito não-negociável.
- Princípio de soberania de fontes (zero dependência de CDN externo).

### Notas de migração

Para projetos que adotaram a **v1.0**, a migração para **v1.1** envolve:

1. Substituir os arquivos `tokens.css`, `globals.css`, `tailwind.config.js`,
   `fonts.css` pelos da v1.1.
2. Adicionar `InterVariable.woff2` e `InterVariable-Italic.woff2` em
   `assets/fonts/` (download oficial: https://rsms.me/inter/).
3. Adicionar `MaterialSymbolsOutlined.woff2` em `assets/fonts/` (download:
   https://github.com/google/material-design-icons).
4. Manter os arquivos `FiraSans-*.ttf` apenas se algum projeto continuar
   usando Fira Sans em modo legado (`data-typeface="fira"`).
5. Rodar busca por `bg-white`, `bg-[#FFFFFF]`, `bg-neutral-50` no projeto e
   substituir por `bg-bg` ou `bg-bg-elevated` conforme a intenção semântica:
   - "fundo geral da tela" → `bg-bg`
   - "card, modal, popover (superfície elevada)" → `bg-bg-elevated`

---

## [1.0.0] — 2026-04-27

Versão inicial do PRF Design System.

### Adicionado

- Cores institucionais oficiais (Azul PRF `#000D4B`, Amarelo PRF `#FFC900`,
  Branco) com referências ao MIV 7.0 e Pantone TPX.
- Escalas auxiliares de azul (`azul-10` a `azul-95`) e amarelo (`amarelo-20`
  a `amarelo-100`) para uso exclusivo em UI digital.
- Cores de status (sucesso, atenção, erro, informação) com contraste WCAG
  2.1 AA garantido sobre fundos institucionais.
- **Fira Sans** como tipografia primária (alinhada ao MIV Caderno 02, pág. 74).
- Escala tipográfica modular base 16, 8 níveis hierárquicos.
- Tema duplo (claro padrão / escuro variação) com inversão controlada de
  papéis (Amarelo PRF como primária no escuro).
- 3 densidades (compacta, padrão, espaçosa).
- Tokens de espaçamento (base 4), raios, sombras institucionais.
- `tailwind.config.js` com tokens mapeados como utilities.
- `globals.css` com tokens HSL para shadcn/ui.
- Componentes React: `BrasaoPRF`, `LogotipoPRF`.
- Documentação institucional: proposta de Caderno 10 (Interfaces Digitais)
  para incorporação ao MIV 7.0.
- `CLAUDE.md` modelo para uso com Claude Code/AI assistants.

### Princípios estabelecidos

1. Identidade institucional inegociável (cores e tipografia oficiais não admitem
   substituição em peças da corporação).
2. Acessibilidade WCAG 2.1 AA como requisito.
3. Tokens antes de componentes.
4. Tema claro como padrão; tema escuro como variação institucional.
5. Densidade adaptável.
6. Soberania de fontes (zero dependência de CDN externo).