@softize/opus 25.0.0 → 25.1.0

package/CHANGELOG.md

@@ -7,6 +7,50 @@ 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.
 
+## 25.1.0 — 2026-10-03
+
+`FloatingLayer`, de `@softize/opus/ui/react`, é uma camada que continua utilizável por cima de
+qualquer `Dialog` ou `Drawer` modal, como o botão e o painel de um assistente (ADR 0052). Quem está
+preenchendo um formulário em um modal pode usar a camada sem fechar o modal nem perder o que digitou.
+Os filhos vão para um hospedeiro fixo no `body`, `div[data-slot="floating-layer"]`, e cada um se
+posiciona contra a janela. Com um `Dialog` ou `Drawer` aberto:
+
+- clicar na camada não fecha o modal, mesmo que o elemento clicado suma no próprio clique, e o véu
+  continua fechando, respeitando `closeDisabled`;
+- o foco pode ir para a camada por clique ou por código sem ser puxado de volta, e o Tab passa do
+  último elemento do modal para a camada e dela de volta ao primeiro; quando o elemento focado da
+  camada some, o foco volta ao campo do modal em que a pessoa estava, e um modal que fecha com a
+  pessoa na camada não leva o foco ao gatilho dele;
+- o Esc age onde a pessoa está: na camada, nenhum modal fecha e `onEscapeKeyDown` é chamado uma vez
+  por tecla; no modal, o modal fecha;
+- a camada rola e continua visível ao leitor de tela, enquanto a página atrás segue travada e
+  escondida.
+
+O hospedeiro publica o `Dialog` ou `Drawer` do topo em `data-modal` (`none`, `dialog` ou `drawer`) e o
+lado do Drawer em `data-modal-side`, para o consumidor tirar o painel de cima do modal. O Opus não
+desloca nem redimensiona modais. Os patterns construídos sobre `Dialog` e `Drawer`, como
+`ActionFormDialog`, `ActionListDialog`, `Presentation` e `CommandDialog`, convivem com a camada sem
+mudança.
+
+Outras mudanças:
+
+- Popover, Menu, Tooltip, Select, Dialog e Drawer abertos de dentro de uma `FloatingLayer` vão para o
+  hospedeiro dela, e não para o `body`; fora da camada, nada muda;
+- `Dialog mode="alert"`, que também serve às confirmações do `DialogHost`, passa à faixa `z-70`,
+  acima da camada (`z-60`) e dos demais modais (`z-50`), e cobre a camada até a resposta, inclusive
+  enquanto um `Dialog` aberto de dentro dele estiver aberto. Popover, Menu e Tooltip do Opus abertos
+  de dentro de um alerta acompanham a faixa dele. Dois efeitos para conferir no seu código: um
+  elemento próprio com `z-index` entre 51 e 69, que antes ficava acima do alerta, agora fica abaixo
+  dele; e uma sobreposição de outra biblioteca com `z-50`, aberta de dentro de um alerta, fica
+  abaixo do véu dele. Durante a animação de saída, o alerta deixa de receber clique. A escala está
+  em `docs/stacking-scale.md`;
+- `DialogPortal` e `MenuPortal` sem `container` usam o hospedeiro da camada quando abertos de
+  dentro dela;
+- a `ref` de `DialogContent` e `DrawerContent` continua recebendo a limpeza das callback refs do
+  React 19, agora composta com a ref interna da camada;
+- o pacote ganha testes em navegador real (Chromium, pelo modo navegador do Vitest com Playwright)
+  para o foco da camada: `pnpm test:browser` roda à parte do `pnpm test` e entra no gate de release.
+
 ## 25.0.0 — 2026-10-02
 
 A exclusão lógica passa a declarar quando o registro excluído sai de vez (ADR 0051). `softDelete`