@softize/opus 12.10.0 → 13.0.0

package/CHANGELOG.md

@@ -7,6 +7,62 @@ Depois de qualquer bump, rode os gates (`typecheck` · `test` · `opus check` ·
 `opus copy --check` · `base copy check` · `manifest:check`) — eles apontam o que a
 mudança cobra do seu código.
 
+## 13.0.0 — 2026-09-07
+
+Dialogs passam a formar uma única família. `Dialog mode="alert"` oferece a semântica de
+`alertdialog`, exige uma resposta explícita e compartilha conteúdo, cabeçalho, mídia, corpo e rodapé
+com o modo padrão. `DialogClose` pode declarar `result` e foco inicial, enquanto `Dialog.onResult`
+recebe a escolha. A API imperativa mantém `alert`, `confirm` e `prompt` e acrescenta
+`dialog.choose({ actions })` para uma ou mais respostas nomeadas.
+
+Alerts, toasts, itens, estados vazios, dialogs e drawers alinham mídia e ações pela mesma anatomia.
+Molduras de ícone permanecem quadradas mesmo com descrições em várias linhas; ações ficam na região
+final da superfície e usam `Button` explicitamente. Toast aceita uma coleção ordenada em `actions`,
+com a última ação destacada por padrão. Drawer aproxima cabeçalho, corpo e rodapé do enquadramento de
+Dialog. Tabelas ganham respiro consistente, cabeçalhos muted e representação muted para valores
+ausentes. `Page` passa a usar teto padrão de `80rem`, e `SidebarTreeGroup` incorpora a guia visual
+para navegação hierárquica.
+
+A documentação publicada foi reorganizada por famílias de uso. Button Group, Input Group, Toggle
+Group e Page State passam a viver nas páginas dos componentes que os contextualizam, cada API com
+sua própria referência de propriedades. Dialog reúne os modos declarativo e imperativo, Sidebar
+documenta composição em árvore, e as categorias do catálogo ganham ícones próprios. A nova skill
+`maintain-opus-docs` registra o padrão editorial e os gates usados para manter esse catálogo.
+
+**Breaking:** os exports `AlertDialog*` foram removidos. Troque a raiz por
+`<Dialog mode="alert">`, os demais slots pelos equivalentes `Dialog*` e componha cada ação como
+`<DialogClose asChild><Button>…</Button></DialogClose>`. Para distinguir respostas, declare
+`result` em `DialogClose` e trate o valor em `Dialog.onResult`. Os campos `action` e `cancel` de
+Toast também foram removidos; use `actions`. `EmptyContent` foi removido; use `EmptyActions`.
+`SidebarNavGroup.subgroups` deixa de existir: componha níveis adicionais com `SidebarTreeGroup`.
+
+## 12.11.0 — 2026-09-04
+
+A UI passa a separar intenção semântica de tratamento visual. `context` aceita `neutral`,
+`primary`, `info`, `success`, `warning` e `danger`; `variant` fica restrita a `solid`, `subtle`,
+`outline`, `ghost` e `link`. `tone` e as variantes semânticas anteriores continuam aceitos para
+migração, mas novos componentes e dicionários devem declarar `context`. Actions destrutivas
+continuam usando `destructive`, projetado visualmente como `danger`.
+Durante a migração, use o alias antigo sozinho: combiná-lo com `context` é ambíguo e agora falha
+explicitamente em vez de descartar uma das intenções.
+
+Páginas, conteúdos e estados assíncronos ganham anatomia compartilhada. `PageState` cobre vazio e
+erro no enquadramento da página; `Content` organiza título, descrição e ações; `MetricCard` evita
+cards de indicador montados manualmente. `Page`, sidebars, alerts, itens, cards, drawers e tabelas
+expõem slots estruturais consistentes, documentados e verificados por `opus check`.
+As composições públicas anteriores de `ContentHeader`, `Alert` e `ItemHeader` permanecem
+funcionais como adaptadores durante a série 12, enquanto o gate orienta código novo à anatomia.
+
+Controles de tamanho normal passam a compartilhar a mesma altura relativa, e `Detail` alinha os
+rótulos sem depender do comprimento de cada atributo. A documentação do catálogo inclui os novos
+padrões, tokens e exemplos, e o verificador aceita slots válidos envolvidos por condicionais JSX.
+
+**Migração:** troque intenção semântica declarada em `variant` ou `tone` por `context`, mantendo em
+`variant` apenas a aparência. Em dicionários de status ou estágio, substitua `tone` por `context`.
+Use `PageState`, `Content` e os slots estruturais em vez de reproduzir vazio, erro, cabeçalho ou
+ações com composição local. O gate informa os locais que ainda usam a forma antiga ou uma anatomia
+incompleta.
+
 ## 12.10.0 — 2026-09-03
 
 `Alert` ganha a variante aditiva `warning` e passa a oferecer realce tonal nativo ao redor do