@softize/opus 12.5.2 → 12.5.4

package/CHANGELOG.md

@@ -7,6 +7,23 @@ 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.
 
+## 12.5.4 — 2026-08-25
+
+A `Dock` lembra por onde o Tab entra depois que o foco sai dela: quem andou até a quinta ação e
+voltou para a tela reentra na quinta, não no começo da barra. E o recálculo por render passa a ter
+o teste que faltava — o da 12.5.3 remontava a barra em vez de re-renderizá-la, então passava igual
+contra o código bugado. Os casos cobertos agora são os reais: ação recém-montada não vira um
+segundo ponto de entrada, e sumir com a ação que era a entrada não deixa a barra fora do Tab.
+
+A nota da 12.5.3 dizia que todo re-render devolvia a entrada ao primeiro ícone; o que de fato
+acontece é isso aqui — a entrada se perde quando as ações da barra mudam ou quando o foco sai.
+
+## 12.5.3 — 2026-08-24
+
+O roving tabindex da `Dock` sobrevive ao re-render do consumidor. Antes o efeito devolvia o ponto
+de entrada ao primeiro ícone a cada render da tela em volta, tirando do Tab justamente o botão em
+foco — a barra prometia um ponto de entrada e entregava outro assim que qualquer estado mudava.
+
 ## 12.5.2 — 2026-08-24
 
 `SidebarItem` aplica `className` sempre na linha, recolhida ou aberta. Antes a prop mudava de alvo

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@softize/opus",
-  "version": "12.5.2",
+  "version": "12.5.4",
   "description": "End-to-end action protocol for TypeScript. Single package with subpath exports (core + adapters).",
   "license": "MIT",
   "type": "module",

package/src/ui/components/patterns/dock.tsx

@@ -35,17 +35,29 @@ export interface DockProps {
 /** Barra flutuante ancorada à superfície. O contêiner precisa ser `relative`. */
 export function Dock({ position = 'bottom', label, className, children }: DockProps): React.ReactElement {
   const ref = React.useRef<HTMLDivElement>(null)
+  // Onde o Tab entra na barra. Fica num ref porque precisa sobreviver ao foco SAIR dela: quem
+  // andou até o quinto ícone e voltou pra tela espera reentrar no quinto, não no primeiro.
+  const entrada = React.useRef<HTMLButtonElement | null>(null)
 
   // Roving tabindex: uma toolbar tem UM ponto de entrada no Tab; dentro dela, as setas andam.
   // Sem isto as setas seriam um caminho a mais, e a barra continuaria cobrando um Tab por ícone.
-  const roving = React.useCallback((focado?: HTMLElement) => {
+  const roving = React.useCallback((focado?: HTMLElement | null) => {
     const items = Array.from(ref.current?.querySelectorAll<HTMLButtonElement>('button') ?? [])
-    const entrada = items.find((item) => item === focado) ?? items.find((item) => !item.disabled)
-    for (const item of items) item.tabIndex = item === entrada ? 0 : -1
+    // Foco fora da barra não move a entrada — só confirma a que já estava valendo.
+    if (focado instanceof HTMLButtonElement && items.includes(focado)) entrada.current = focado
+    const lembrada = entrada.current
+    const alvo =
+      (lembrada !== null && items.includes(lembrada) && !lembrada.disabled ? lembrada : undefined) ??
+      items.find((item) => !item.disabled)
+    entrada.current = alvo ?? null
+    for (const item of items) item.tabIndex = item === alvo ? 0 : -1
   }, [])
 
   React.useEffect(() => {
-    roving()
+    // Roda a cada render porque as ações da barra mudam com o estado da tela: sem recalcular, um
+    // ícone recém-montado entraria no Tab por conta própria, e sumir com o ícone que era a
+    // entrada deixaria a barra inteira fora do Tab.
+    roving(document.activeElement as HTMLElement | null)
   })
 
   // Navegação de toolbar: as setas andam entre as ações, e Home/End vão às pontas. Sem isso