@aurea-uds/react 0.2.0 → 0.3.0

package/dist/navigation.d.ts

@@ -1,85 +1,2 @@
-import React, { type HTMLAttributes, type RefAttributes, type ReactNode, type ReactElement } from "react";
-import { type IconName } from "./system.js";
-export type StepState = "default" | "active" | "done" | "error";
-export interface StepItem {
-    label: ReactNode;
-    state?: StepState;
-    optional?: ReactNode;
-    onClick?: () => void;
-}
-export declare function Stepper({ items, label, className }: {
-    items: StepItem[];
-    label?: string;
-    className?: string;
-}): React.JSX.Element;
-export declare function Breadcrumb({ items, label }: {
-    items: Array<{
-        label: ReactNode;
-        href?: string;
-    }>;
-    label?: string;
-}): React.JSX.Element;
-export declare function Tabs({ tabs, value, onChange, label }: {
-    tabs: Array<{
-        id: string;
-        label: ReactNode;
-        content: ReactNode;
-    }>;
-    value: string;
-    onChange: (id: string) => void;
-    label?: string;
-}): React.JSX.Element;
-export declare function Pagination({ page, total, onPageChange }: {
-    page: number;
-    total: number;
-    onPageChange: (p: number) => void;
-}): React.JSX.Element;
-export interface TocItem {
-    id: string;
-    label: string;
-    sub?: boolean;
-}
-export declare function TableOfContents({ items, current, label, className, ...props }: HTMLAttributes<HTMLElement> & RefAttributes<HTMLElement> & {
-    items: TocItem[];
-    current?: string;
-    label?: string;
-}): React.JSX.Element;
-export interface TreeNode {
-    id: string;
-    label: ReactNode;
-    icon?: IconName;
-    children?: TreeNode[];
-}
-export declare function TreeView({ items, defaultExpandedIds, onSelect, label, className }: {
-    items: TreeNode[];
-    defaultExpandedIds?: string[];
-    onSelect?: (node: TreeNode) => void;
-    label?: string;
-    className?: string;
-}): ReactElement<unknown, string | React.JSXElementConstructor<any>>;
-export interface SidebarItem {
-    id: string;
-    label: ReactNode;
-    href?: string;
-    icon?: IconName;
-    badge?: ReactNode;
-    onClick?: () => void;
-    items?: SidebarItem[];
-}
-export declare function Sidebar({ items, current, collapsed, label, children, className, ...props }: HTMLAttributes<HTMLElement> & RefAttributes<HTMLElement> & {
-    items?: SidebarItem[];
-    current?: string;
-    collapsed?: boolean;
-    label?: string;
-}): React.JSX.Element;
-export type TopbarVariant = "floating" | "flush" | "pill";
-export declare function Topbar({ variant, brand, children, className, ...props }: HTMLAttributes<HTMLElement> & RefAttributes<HTMLElement> & {
-    variant?: TopbarVariant;
-    brand?: ReactNode;
-}): React.JSX.Element;
-export declare function CommandPaletteShell({ open, query, onQueryChange, children }: {
-    open: boolean;
-    query: string;
-    onQueryChange: (v: string) => void;
-    children?: ReactNode;
-}): React.JSX.Element | null;
+export * from "./navigation-client.js";
+export { Topbar, type TopbarVariant } from "./markup.js";

package/dist/navigation.js

@@ -1,138 +1,5 @@
-"use client";
-import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-// Fase 9 (achado A5): este arquivo saiu do index.tsx de 970 linhas. Um módulo por categoria
-// do registry — a taxonomia já existia e é gateada. A ordem de import entre eles é um DAG:
-// internal → system → actions → feedback → inputs → navigation → layout → data-display → resto.
-import React from "react";
-import { Tabs as BaseTabs } from "@base-ui/react/tabs";
-import { cx, useAureaStrings } from "./internal.js";
-import { Icon } from "./system.js";
-import { Button } from "./actions.js";
-import { Badge } from "./feedback.js";
-import { SearchField } from "./inputs.js";
-export function Stepper({ items, label, className }) {
-    const s = useAureaStrings();
-    return _jsx("div", { role: "list", "aria-label": label ?? s.stepperLabel, className: cx("stepper", className), children: items.map((it, n) => {
-            const st = it.state ?? "default";
-            const marca = st === "done" ? _jsx(Icon, { name: "checkmark" }) : st === "error" ? _jsx(Icon, { name: "error" }) : n + 1;
-            const miolo = _jsxs(_Fragment, { children: [_jsx("span", { className: "step-dot", children: marca }), _jsx("strong", { children: it.label }), it.optional && _jsx("small", { className: "step-optional", children: it.optional })] });
-            return _jsx("div", { role: "listitem", className: cx("step", st !== "default" && `step-${st}`), "aria-current": st === "active" ? "step" : undefined, children: it.onClick ? _jsx("button", { type: "button", className: "step-trigger", onClick: it.onClick, children: miolo }) : miolo }, n);
-        }) });
-}
-export function Breadcrumb({ items, label }) { const s = useAureaStrings(); return _jsx("nav", { className: "breadcrumb", "aria-label": label ?? s.breadcrumbLabel, children: items.map((i, n) => _jsxs(React.Fragment, { children: [n > 0 && _jsx(Icon, { name: "chevron--right", size: "sm" }), " ", i.href ? _jsx("a", { href: i.href, children: i.label }) : _jsx("strong", { "aria-current": "page", children: i.label })] }, n)) }); }
-export function Tabs({ tabs, value, onChange, label }) { const s = useAureaStrings(); return _jsxs(BaseTabs.Root, { value: value, onValueChange: v => onChange(String(v)), children: [_jsx(BaseTabs.List, { className: "tabs", "aria-label": label ?? s.tabsLabel, activateOnFocus: true, children: tabs.map(t => _jsx(BaseTabs.Tab, { value: t.id, className: "tab", children: t.label }, t.id)) }), tabs.map(t => _jsx(BaseTabs.Panel, { value: t.id, className: "card card-inset", tabIndex: 0, children: t.content }, t.id))] }); }
-export function Pagination({ page, total, onPageChange }) { const s = useAureaStrings(); return _jsxs("nav", { className: "pagination", "aria-label": s.paginationLabel, children: [_jsx(Button, { variant: "ghost", size: "sm", disabled: page <= 1, onClick: () => onPageChange(page - 1), children: s.previous }), _jsxs(Badge, { variant: "primary", children: [page, " / ", total] }), _jsx(Button, { variant: "ghost", size: "sm", disabled: page >= total, onClick: () => onPageChange(page + 1), children: s.next })] }); }
-export function TableOfContents({ items, current, label, className, ...props }) {
-    const s = useAureaStrings();
-    return _jsxs("nav", { className: cx("toc", className), "aria-label": label ?? s.tocLabel, ...props, children: [_jsx("p", { className: "toc-label", children: label ?? s.tocLabel }), items.map(i => _jsx("a", { href: `#${i.id}`, className: cx(i.sub && "toc-sub"), ...(i.id === current ? { "aria-current": "true" } : {}), children: i.label }, i.id))] });
-}
-function flattenVisible(nodes, expanded, level = 1, parentId, acc = []) {
-    for (const node of nodes) {
-        acc.push({ node, level, parentId });
-        if (node.children?.length && expanded.has(node.id))
-            flattenVisible(node.children, expanded, level + 1, node.id, acc);
-    }
-    return acc;
-}
-export function TreeView({ items, defaultExpandedIds, onSelect, label, className }) {
-    const s = useAureaStrings();
-    const baseId = React.useId();
-    const [expanded, setExpanded] = React.useState(() => new Set(defaultExpandedIds));
-    const [selected, setSelected] = React.useState();
-    const [active, setActive] = React.useState(() => items[0]?.id);
-    const rootRef = React.useRef(null);
-    const visible = flattenVisible(items, expanded);
-    // Roving tab stop derivado: se o nó ativo saiu do conjunto visível (dados
-    // trocados, nó removido), o primeiro visível volta a ser tabulável — senão a
-    // árvore inteira fica tabIndex=-1 e some da ordem do Tab (auditoria, MÉDIO 1).
-    const effectiveActive = active !== undefined && visible.some(v => v.node.id === active) ? active : visible[0]?.node.id;
-    const focusId = (id) => { setActive(id); rootRef.current?.querySelector(`[data-tree-id="${CSS.escape(id)}"]`)?.focus(); };
-    const toggle = (id, open) => setExpanded(prev => { const n = new Set(prev); if (open)
-        n.add(id);
-    else
-        n.delete(id); return n; });
-    const select = (node) => { setSelected(node.id); onSelect?.(node); };
-    const onKeyDown = (e) => {
-        const idx = visible.findIndex(v => v.node.id === effectiveActive);
-        if (idx < 0)
-            return;
-        const cur = visible[idx], hasChildren = !!cur.node.children?.length, isOpen = expanded.has(cur.node.id);
-        const rtl = getComputedStyle(e.currentTarget).direction === "rtl";
-        const expandKey = rtl ? "ArrowLeft" : "ArrowRight", collapseKey = rtl ? "ArrowRight" : "ArrowLeft";
-        switch (e.key) {
-            case "ArrowDown":
-                e.preventDefault();
-                if (idx < visible.length - 1)
-                    focusId(visible[idx + 1].node.id);
-                break;
-            case "ArrowUp":
-                e.preventDefault();
-                if (idx > 0)
-                    focusId(visible[idx - 1].node.id);
-                break;
-            case expandKey:
-                e.preventDefault();
-                if (hasChildren && !isOpen)
-                    toggle(cur.node.id, true);
-                else if (hasChildren && isOpen)
-                    focusId(cur.node.children[0].id);
-                break;
-            case collapseKey:
-                e.preventDefault();
-                if (hasChildren && isOpen)
-                    toggle(cur.node.id, false);
-                else if (cur.parentId)
-                    focusId(cur.parentId);
-                break;
-            case "Home":
-                e.preventDefault();
-                focusId(visible[0].node.id);
-                break;
-            case "End":
-                e.preventDefault();
-                focusId(visible[visible.length - 1].node.id);
-                break;
-            case "Enter":
-            case " ":
-                e.preventDefault();
-                select(cur.node);
-                if (hasChildren)
-                    toggle(cur.node.id, !isOpen);
-                break;
-        }
-    };
-    const renderNodes = (nodes, level) => (_jsx("ul", { ref: level === 1 ? rootRef : undefined, className: cx(level === 1 ? "tree" : "tree-group", level === 1 && className), role: level === 1 ? "tree" : "group", "aria-label": level === 1 ? (label ?? s.treeLabel) : undefined, onKeyDown: level === 1 ? onKeyDown : undefined, children: nodes.map(node => {
-            const hasChildren = !!node.children?.length, isOpen = expanded.has(node.id), isSelected = selected === node.id, labelId = baseId + node.id;
-            return _jsxs("li", { className: "tree-item", role: "treeitem", "data-tree-id": node.id, "aria-level": level, "aria-expanded": hasChildren ? isOpen : undefined, "aria-selected": isSelected, "aria-labelledby": labelId, tabIndex: node.id === effectiveActive ? 0 : -1, children: [_jsxs("span", { className: "tree-node", "data-selected": isSelected || undefined, style: { paddingInlineStart: `calc(var(--space-3) + ${level - 1} * var(--space-4))` }, onClick: () => { focusId(node.id); select(node); if (hasChildren)
-                            toggle(node.id, !isOpen); }, children: [hasChildren ? _jsx(Icon, { name: "chevron--right", size: "sm", className: "tree-twist" }) : _jsx("span", { className: "tree-indent", "aria-hidden": "true" }), node.icon && _jsx(Icon, { name: node.icon, size: "sm" }), _jsx("span", { id: labelId, className: "tree-label", children: node.label })] }), hasChildren && isOpen && renderNodes(node.children, level + 1)] }, node.id);
-        }) }));
-    return renderNodes(items, 1);
-}
-function sidebarList(items, ctx, sub, labelledBy) {
-    return _jsx("ul", { className: cx("sidebar-list", sub && "sidebar-sub"), "aria-labelledby": labelledBy, children: items.map(it => {
-            const lid = ctx.baseId + it.id;
-            const filhos = it.items?.length ? it.items : undefined;
-            // Rótulo escondido vira `.sr-only` em vez de sumir do DOM: na lateral recolhida o item
-            // continua tendo nome para quem usa leitor de tela. Ícone sozinho não nomeia nada.
-            const oculto = (no) => ctx.collapsed ? _jsx("span", { className: "sr-only", children: no }) : no;
-            if (filhos && !it.href && !it.onClick)
-                return _jsxs("li", { children: [_jsx("p", { id: lid, className: cx("sidebar-group-label", ctx.collapsed && "sr-only"), children: it.label }), sidebarList(filhos, ctx, false, lid)] }, it.id);
-            const ativo = it.id === ctx.current;
-            const miolo = _jsxs(_Fragment, { children: [it.icon && _jsx(Icon, { name: it.icon, size: "sm" }), _jsx("span", { className: cx("sidebar-label", ctx.collapsed && "sr-only"), children: it.label }), it.badge != null && oculto(it.badge)] });
-            return _jsxs("li", { children: [it.href
-                        ? _jsx("a", { id: lid, href: it.href, className: "sidebar-item", "aria-current": ativo ? "page" : undefined, onClick: it.onClick, children: miolo })
-                        : _jsx("button", { id: lid, type: "button", className: "sidebar-item", "aria-current": ativo ? "page" : undefined, onClick: it.onClick, children: miolo }), filhos && sidebarList(filhos, ctx, true, lid)] }, it.id);
-        }) });
-}
-export function Sidebar({ items, current, collapsed, label, children, className, ...props }) {
-    const s = useAureaStrings();
-    const baseId = React.useId();
-    return _jsxs("aside", { className: cx("sidebar", collapsed && "sidebar-collapsed", className), ...props, children: [items && items.length > 0 && _jsx("nav", { className: "sidebar-nav", "aria-label": label ?? s.sidebarLabel, children: sidebarList(items, { baseId, current, collapsed }) }), children] });
-}
-export function Topbar({ variant = "floating", brand, children, className, ...props }) { return _jsxs("header", { className: cx("topbar", `topbar-${variant}`, className), ...props, children: [brand != null && _jsx("div", { className: "brand", children: brand }), children] }); }
-// Shell NÃO-modal de propósito: é presentational (o consumidor controla open) e não
-// tem focus trap/inert/Escape — declarar aria-modal sem entregar a modalidade faria
-// leitores ocultarem o resto da página com o teclado ainda alcançando tudo
-// (auditoria 18/07/2026, ALTO 2; APG dialog-modal). Modal de verdade = BaseDialog.
-export function CommandPaletteShell({ open, query, onQueryChange, children }) { const s = useAureaStrings(); if (!open)
-    return null; return _jsx("div", { className: "command-overlay", children: _jsxs("div", { className: "command-palette", role: "dialog", "aria-label": s.commandLabel, children: [_jsx(SearchField, { autoFocus: true, "aria-label": s.commandPlaceholder, value: query, onChange: e => onQueryChange(e.target.value), placeholder: s.commandPlaceholder }), children] }) }); }
+// VITRINE da categoria — é este arquivo que `@aurea-uds/react/navigation` resolve. Sem
+// `"use client"` de propósito: a diretiva contamina o módulo inteiro e faria a marcação pura
+// chegar como cliente por vizinhança (ADR-0026; o check 26b reprova quem a puser de volta aqui).
+export * from "./navigation-client.js";
+export { Topbar } from "./markup.js";

package/dist/overlays.d.ts

@@ -7,6 +7,16 @@ export declare function Dialog({ open, title, children, footer, onClose }: {
     footer?: ReactNode;
     onClose: () => void;
 }): React.JSX.Element;
+export declare function ConfirmDialog({ open, title, description, confirmLabel, cancelLabel, destructive, onConfirm, onCancel }: {
+    open: boolean;
+    title: ReactNode;
+    description: ReactNode;
+    confirmLabel?: string;
+    cancelLabel?: string;
+    destructive?: boolean;
+    onConfirm: () => void;
+    onCancel: () => void;
+}): React.JSX.Element;
 export declare function Drawer({ open, title, children, onClose, side }: {
     open: boolean;
     title: ReactNode;
@@ -14,6 +24,19 @@ export declare function Drawer({ open, title, children, onClose, side }: {
     onClose: () => void;
     side?: "left" | "right";
 }): React.JSX.Element;
+export type AccessGateProps = {
+    allowed: boolean;
+    children: ReactElement;
+} & ({
+    mode?: "hide";
+    fallback?: ReactNode;
+    reason?: never;
+} | {
+    mode: "disable";
+    reason: ReactNode;
+    fallback?: never;
+});
+export declare function AccessGate({ allowed, children, ...resto }: AccessGateProps): React.JSX.Element;
 export type OverlaySide = "top" | "right" | "bottom" | "left";
 export declare function Tooltip({ children, content, side }: {
     children: ReactElement;

package/dist/overlays.js

@@ -1,10 +1,11 @@
 "use client";
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 // Fase 9 (achado A5): este arquivo saiu do index.tsx de 970 linhas. Um módulo por categoria
 // do registry — a taxonomia já existia e é gateada. A ordem de import entre eles é um DAG:
 // internal → system → actions → feedback → inputs → navigation → layout → data-display → resto.
 import React from "react";
 import { Dialog as BaseDialog } from "@base-ui/react/dialog";
+import { AlertDialog as BaseAlertDialog } from "@base-ui/react/alert-dialog";
 import { Popover as BasePopover } from "@base-ui/react/popover";
 import { Tooltip as BaseTooltip } from "@base-ui/react/tooltip";
 import { Menu as BaseMenu } from "@base-ui/react/menu";
@@ -12,10 +13,53 @@ import { ContextMenu as BaseContextMenu } from "@base-ui/react/context-menu";
 import { PreviewCard as BasePreviewCard } from "@base-ui/react/preview-card";
 import { cx, useAureaStrings, usePortalContainer } from "./internal.js";
 import { Icon } from "./system.js";
+import { Button } from "./actions.js";
 export function Dialog({ open, title, children, footer, onClose }) { const s = useAureaStrings(); const portal = usePortalContainer(); return _jsx(BaseDialog.Root, { open: open, onOpenChange: o => { if (!o)
         onClose(); }, children: _jsxs(BaseDialog.Portal, { container: portal, children: [_jsx(BaseDialog.Backdrop, { className: "dialog-backdrop" }), _jsxs(BaseDialog.Popup, { className: "dialog", children: [_jsxs("header", { children: [_jsx(BaseDialog.Title, { render: _jsx("h2", {}), children: title }), _jsx(BaseDialog.Close, { className: "btn btn-ghost btn-icon", "aria-label": s.close, children: _jsx(Icon, { name: "close" }) })] }), _jsx("div", { className: "dialog-body", children: children }), footer && _jsx("footer", { children: footer })] })] }) }); }
+// ConfirmDialog (M5): a decisão que não se fecha por engano. NÃO é um Dialog com dois botões —
+// é `role="alertdialog"`, e a diferença é de comportamento, não de aparência: o Base UI tira do
+// AlertDialog.Root as props `modal` e `disablePointerDismissal` (medido no d.ts de 1.6.0), ou
+// seja, clicar fora NÃO fecha. Num Dialog comum, clicar fora vira "cancelei" sem a pessoa ter
+// decidido — que é exatamente o acidente que este componente existe para impedir.
+//
+// FOCO NO BOTÃO SEGURO: quem abre um "isto apaga" e aperta Enter por reflexo tem de cancelar,
+// não apagar. As quatro referências convergem em cancelar-antes-de-agir na ORDEM visual, e
+// nenhuma delas move o foco — este passo saiu de medir o teclado, não de ler.
+//
+// DUAS coisas garantem, e as duas foram medidas em 13/08/2026, uma de cada vez:
+//   • a ORDEM do DOM — o Cancelar vem primeiro, e o motor foca o primeiro focável. Sozinha, ela
+//     já faz o teste passar; tirar só o `initialFocus` NÃO reprova.
+//   • o `initialFocus`, que é o cinto: com a ordem dos dois botões INVERTIDA ele continua
+//     segurando o foco no Cancelar, e é aí que ele prova que não é enfeite. Sem ele e com a
+//     ordem invertida, o teste reprova — que é o defeito de verdade, porque inverter a ordem é
+//     uma mudança de aparência que alguém faz sem pensar no teclado.
+// O teste cobra o EFEITO ("o foco nasce no seguro"), não o mecanismo. É por isso que ele
+// sobrevive a trocar um dos dois — e reprova quando os dois somem.
+//
+// ESCOPO MENOR que a referência (BUILDING.md §5): lá são nove peças compostas
+// (Root/Trigger/Content/Header/Title/Description/Footer/Cancel/Action). Aqui é uma prop `open`,
+// como no `Dialog` e no `Drawer` — a composição não acrescenta escolha nenhuma num diálogo cujo
+// corpo é uma frase e dois botões.
+//
+// `description` é prop e não `children` porque ela é o nó de `aria-describedby`: o AlertDialog
+// só anuncia o que passa pelo `Description`. Como `children`, um consumidor poria um <div> no
+// meio e o leitor de tela perderia a frase que diz o que se perde.
+export function ConfirmDialog({ open, title, description, confirmLabel, cancelLabel, destructive, onConfirm, onCancel }) {
+    const s = useAureaStrings();
+    const portal = usePortalContainer();
+    const seguro = React.useRef(null);
+    return _jsx(BaseAlertDialog.Root, { open: open, onOpenChange: o => { if (!o)
+            onCancel(); }, children: _jsxs(BaseAlertDialog.Portal, { container: portal, children: [_jsx(BaseAlertDialog.Backdrop, { className: "dialog-backdrop" }), _jsxs(BaseAlertDialog.Popup, { className: "dialog dialog-confirm", initialFocus: seguro, children: [_jsx("header", { children: _jsx(BaseAlertDialog.Title, { render: _jsx("h2", {}), children: title }) }), _jsx(BaseAlertDialog.Description, { className: "dialog-body", children: description }), _jsxs("footer", { children: [_jsx(Button, { ref: seguro, variant: "secondary", onClick: onCancel, children: cancelLabel ?? s.confirmCancel }), _jsx(Button, { variant: destructive ? "danger" : "primary", onClick: onConfirm, children: confirmLabel ?? s.confirmProceed })] })] })] }) });
+}
 export function Drawer({ open, title, children, onClose, side = "right" }) { const s = useAureaStrings(); const portal = usePortalContainer(); return _jsx(BaseDialog.Root, { open: open, onOpenChange: o => { if (!o)
         onClose(); }, children: _jsxs(BaseDialog.Portal, { container: portal, children: [_jsx(BaseDialog.Backdrop, { className: "drawer-backdrop" }), _jsxs(BaseDialog.Popup, { className: cx("drawer", `drawer-${side}`), children: [_jsxs("header", { children: [_jsx(BaseDialog.Title, { render: _jsx("h2", {}), children: title }), _jsx(BaseDialog.Close, { className: "btn btn-ghost btn-icon", "aria-label": s.close, children: _jsx(Icon, { name: "close" }) })] }), children] })] }) }); }
+export function AccessGate({ allowed, children, ...resto }) {
+    if (allowed)
+        return children;
+    if (resto.mode === "disable")
+        return _jsx(Tooltip, { content: resto.reason, children: React.cloneElement(children, { "aria-disabled": true }) });
+    return _jsx(_Fragment, { children: resto.fallback ?? null });
+}
 // `role="tooltip"` + `aria-describedby` no disparador é o que faz a dica EXISTIR para leitor
 // de tela. Medido em 30/07/2026: sem isso, o popup saía sem role e sem id, e o disparador sem
 // aria-describedby — quem navega por leitor de tela ouvia só o rótulo do botão e nunca o

package/dist/pure.d.ts

@@ -4,6 +4,10 @@ export declare const universalStates: readonly UniversalState[];
 export declare const stateSeverity: (state: UniversalState) => "info" | "warning";
 export interface AureaStrings {
     close: string;
+    confirmCancel: string;
+    dataError: string;
+    dataEmpty: string;
+    confirmProceed: string;
     paginationLabel: string;
     previous: string;
     next: string;
@@ -68,6 +72,22 @@ export interface AureaStrings {
     mediaSkipForward: string;
     mediaFullscreenEnter: string;
     mediaFullscreenExit: string;
+    carouselLabel: string;
+    carouselSlide: string;
+    positionOf: string;
+    carouselPrev: string;
+    carouselNext: string;
+    galleryLabel: string;
+    sortableLabel: string;
+    sortableHandle: string;
+    sortableHelp: string;
+    sortableGrabbed: string;
+    sortableDropped: string;
+    sortableMoved: string;
+    sortableCanceled: string;
+    blockEditorLabel: string;
+    blockLabel: string;
+    blockRemove: string;
     uploadSending: string;
     uploadCancel: string;
     uploadRetry: string;
@@ -164,3 +184,13 @@ export declare function gridStateFromParams(params: URLSearchParams, filters?: A
     column: string;
     facet?: boolean;
 }>): GridState;
+export interface ScreenState extends GridState {
+    tab?: string;
+    view?: string;
+    detail?: string;
+}
+export declare function screenStateToParams(state: ScreenState, into?: URLSearchParams): URLSearchParams;
+export declare function screenStateFromParams(params: URLSearchParams, filters?: Array<{
+    column: string;
+    facet?: boolean;
+}>): ScreenState;

package/dist/pure.js

@@ -21,10 +21,10 @@ export const universalStates = ["waiting_user", "waiting_approval", "waiting_dep
 // perdeu qualidade é avisado. Um `role="alert"` aqui interromperia o leitor de tela por uma
 // condição que não pede ação imediata, que é o oposto do que o papel serve.
 export const stateSeverity = (state) => state.startsWith("waiting_") ? "info" : "warning";
-export const defaultStrings = { close: "Close", paginationLabel: "Pagination", previous: "Previous", next: "Next", breadcrumbLabel: "Breadcrumb", tabsLabel: "Tabs", optionsLabel: "Options", tableLabel: "Table", commandLabel: "Command palette", commandPlaceholder: "Type a command…", dismissNotification: "Dismiss notification", toolbarLabel: "Toolbar", loading: "Loading", otpDigit: "Digit", stepperLabel: "Steps", increment: "Increase", decrement: "Decrease", comboboxEmpty: "No results", comboboxClear: "Clear selection", comboboxOpen: "Open list", comboboxRemove: "Remove", comboboxLoading: "Loading…", fileDropPrompt: "Drag files here or click to select", fileAdded: "File added", fileRemoved: "File removed", fileRemove: "Remove", fileTooLarge: "File exceeds the size limit", fileWrongType: "File type not allowed", treeLabel: "Tree", notificationsLabel: "Notifications", notificationMarkAll: "Mark all as read", notificationEmpty: "No notifications", notificationUnread: "Unread", notificationNew: "new notifications", dataGridFilter: "Filter", dataGridEmpty: "No results", dataGridSelectAll: "Select all rows", dataGridSelectRow: "Select row", dataGridSelected: "selected", dataGridClearSelection: "Clear selection", dataGridBulkLabel: "Bulk actions", dataGridColumns: "Columns", dataGridResize: "Resize column", dataGridStale: "Showing data that may be out of date.", dataGridPartial: "Some rows could not be loaded. What you see is incomplete.", dataGridError: "The rows could not be loaded.", dataGridDetails: "Details", dataGridDetailPanel: "Row detail", dataGridExport: "Export", dataGridExportRows: "rows", dataGridExportFiltered: "filtered rows", dataGridExportSelected: "selected rows", mediaPlayer: "Media player", mediaPlay: "Play", mediaPause: "Pause", mediaMute: "Mute", mediaUnmute: "Unmute", mediaSeek: "Seek", mediaVolume: "Volume", mediaCaptionsShow: "Show captions", mediaCaptionsHide: "Hide captions", mediaSkipBack: "Skip back 10 seconds", mediaSkipForward: "Skip forward 10 seconds", mediaFullscreenEnter: "Enter full screen", mediaFullscreenExit: "Exit full screen", uploadSending: "Uploading", uploadCancel: "Cancel upload", uploadRetry: "Retry upload", uploadError: "Upload failed", uploadCanceled: "Upload canceled", uploadComplete: "Upload complete", uploadPause: "Pause upload", uploadResume: "Resume upload", uploadPaused: "Paused", uploadPending: "Waiting", uploadChecksum: "Checksum", uploadChecksumBad: "The server received different bytes than the ones sent.", fileConflict: "A file with this name is already in the queue", fileReplace: "Replace", fileKeepBoth: "Keep both", fileSkip: "Skip", uploadReceipt: "Receipt", uploadReceiptCopy: "Copy receipt", agentInspector: "Agent inspector", invocationLabel: "Invocation", invocationInput: "Input", invocationOutput: "Output", taskQueueLabel: "Task queue", taskState: { queued: "Queued", running: "Running", completed: "Completed", failed: "Failed", blocked: "Blocked", paused: "Paused" }, taskPriority: { low: "Low", medium: "Medium", high: "High" }, approvalLabel: "Approval", approvalApprove: "Approve", approvalDeny: "Deny", approvalApproved: "Approved", approvalDenied: "Denied", approvalDeadline: "Decide by", approvalRisk: { low: "Low risk", medium: "Medium risk", high: "High risk" }, permissionLabel: "Tool permissions", permissionAsk: "Ask", permissionAlways: "Always", permissionNever: "Never", eventStreamLabel: "Events", traceLabel: "Trace", healthLabel: "Health", healthState: { operational: "Operational", degraded: "Degraded", down: "Down", maintenance: "Maintenance", unknown: "Unknown" }, modelUsageLabel: "Model usage", usageMetric: { tokens: "Tokens", cost: "Cost", requests: "Requests" }, costMeterLabel: "Cost", costMeterSpent: "Spent", costMeterRemaining: "left", costMeterExceeded: "Over the limit", costMeterNear: "Spending is past the soft limit.", costMeterOver: "The limit has been reached. Further calls are blocked.", memoryLabel: "Memory ledger", memoryProvenance: "Where this came from", memoryOperation: { added: "Added", updated: "Updated", recalled: "Recalled", forgotten: "Forgotten" }, memoryScope: { episodic: "Episodic", semantic: "Semantic", procedural: "Procedural" }, agentMessageLabel: "Agent messages", agentMessageTo: "to", agentMessageBroadcast: "all agents", agentMessageReason: "Why it went this way", agentMessageKind: { request: "Request", response: "Response", handoff: "Handoff", broadcast: "Broadcast", error: "Error" }, automationWhen: "When", automationThen: "Then", automationEnabled: "Enabled", automationLastRun: "Last run", automationResult: { success: "Succeeded", failure: "Failed" }, graphLabel: "Dependency graph", agentState: { idle: "Idle", thinking: "Thinking", running: "Running", paused: "Paused", error: "Error", completed: "Completed" }, codeEditor: "Code editor", chatLabel: "Conversation", chatMessage: "Message", chatSend: "Send", qrCode: "QR code", chartLabel: "Chart", copyCode: "Copy code", tocLabel: "On this page", navigationToggle: "Navigation", sidebarLabel: "Sidebar", universalState: { waiting_user: "Waiting for someone to act.", waiting_approval: "Waiting for approval.", waiting_dependency: "Waiting for something else to finish.", offline: "No connection. This was loaded earlier.", stale: "This may be out of date.", partial: "Some of this could not be loaded.", degraded: "Working with reduced capability." } };
+export const defaultStrings = { close: "Close", confirmCancel: "Cancel", dataError: "This could not be loaded.", dataEmpty: "Nothing here yet", confirmProceed: "Continue", paginationLabel: "Pagination", previous: "Previous", next: "Next", breadcrumbLabel: "Breadcrumb", tabsLabel: "Tabs", optionsLabel: "Options", tableLabel: "Table", commandLabel: "Command palette", commandPlaceholder: "Type a command…", dismissNotification: "Dismiss notification", toolbarLabel: "Toolbar", loading: "Loading", otpDigit: "Digit", stepperLabel: "Steps", increment: "Increase", decrement: "Decrease", comboboxEmpty: "No results", comboboxClear: "Clear selection", comboboxOpen: "Open list", comboboxRemove: "Remove", comboboxLoading: "Loading…", fileDropPrompt: "Drag files here or click to select", fileAdded: "File added", fileRemoved: "File removed", fileRemove: "Remove", fileTooLarge: "File exceeds the size limit", fileWrongType: "File type not allowed", treeLabel: "Tree", notificationsLabel: "Notifications", notificationMarkAll: "Mark all as read", notificationEmpty: "No notifications", notificationUnread: "Unread", notificationNew: "new notifications", dataGridFilter: "Filter", dataGridEmpty: "No results", dataGridSelectAll: "Select all rows", dataGridSelectRow: "Select row", dataGridSelected: "selected", dataGridClearSelection: "Clear selection", dataGridBulkLabel: "Bulk actions", dataGridColumns: "Columns", dataGridResize: "Resize column", dataGridStale: "Showing data that may be out of date.", dataGridPartial: "Some rows could not be loaded. What you see is incomplete.", dataGridError: "The rows could not be loaded.", dataGridDetails: "Details", dataGridDetailPanel: "Row detail", dataGridExport: "Export", dataGridExportRows: "rows", dataGridExportFiltered: "filtered rows", dataGridExportSelected: "selected rows", mediaPlayer: "Media player", mediaPlay: "Play", mediaPause: "Pause", mediaMute: "Mute", mediaUnmute: "Unmute", mediaSeek: "Seek", mediaVolume: "Volume", mediaCaptionsShow: "Show captions", mediaCaptionsHide: "Hide captions", mediaSkipBack: "Skip back 10 seconds", mediaSkipForward: "Skip forward 10 seconds", mediaFullscreenEnter: "Enter full screen", mediaFullscreenExit: "Exit full screen", carouselLabel: "Carousel", carouselSlide: "Slide", positionOf: "of", carouselPrev: "Previous slide", carouselNext: "Next slide", galleryLabel: "Gallery", sortableLabel: "Sortable list", sortableHandle: "Reorder", sortableHelp: "Press Space to pick this up, then Arrow Up and Arrow Down to move it. Space drops it, Escape puts it back.", sortableGrabbed: "Picked up", sortableDropped: "Dropped", sortableMoved: "Moved", sortableCanceled: "Put back", blockEditorLabel: "Content blocks", blockLabel: "Block", blockRemove: "Remove block", uploadSending: "Uploading", uploadCancel: "Cancel upload", uploadRetry: "Retry upload", uploadError: "Upload failed", uploadCanceled: "Upload canceled", uploadComplete: "Upload complete", uploadPause: "Pause upload", uploadResume: "Resume upload", uploadPaused: "Paused", uploadPending: "Waiting", uploadChecksum: "Checksum", uploadChecksumBad: "The server received different bytes than the ones sent.", fileConflict: "A file with this name is already in the queue", fileReplace: "Replace", fileKeepBoth: "Keep both", fileSkip: "Skip", uploadReceipt: "Receipt", uploadReceiptCopy: "Copy receipt", agentInspector: "Agent inspector", invocationLabel: "Invocation", invocationInput: "Input", invocationOutput: "Output", taskQueueLabel: "Task queue", taskState: { queued: "Queued", running: "Running", completed: "Completed", failed: "Failed", blocked: "Blocked", paused: "Paused" }, taskPriority: { low: "Low", medium: "Medium", high: "High" }, approvalLabel: "Approval", approvalApprove: "Approve", approvalDeny: "Deny", approvalApproved: "Approved", approvalDenied: "Denied", approvalDeadline: "Decide by", approvalRisk: { low: "Low risk", medium: "Medium risk", high: "High risk" }, permissionLabel: "Tool permissions", permissionAsk: "Ask", permissionAlways: "Always", permissionNever: "Never", eventStreamLabel: "Events", traceLabel: "Trace", healthLabel: "Health", healthState: { operational: "Operational", degraded: "Degraded", down: "Down", maintenance: "Maintenance", unknown: "Unknown" }, modelUsageLabel: "Model usage", usageMetric: { tokens: "Tokens", cost: "Cost", requests: "Requests" }, costMeterLabel: "Cost", costMeterSpent: "Spent", costMeterRemaining: "left", costMeterExceeded: "Over the limit", costMeterNear: "Spending is past the soft limit.", costMeterOver: "The limit has been reached. Further calls are blocked.", memoryLabel: "Memory ledger", memoryProvenance: "Where this came from", memoryOperation: { added: "Added", updated: "Updated", recalled: "Recalled", forgotten: "Forgotten" }, memoryScope: { episodic: "Episodic", semantic: "Semantic", procedural: "Procedural" }, agentMessageLabel: "Agent messages", agentMessageTo: "to", agentMessageBroadcast: "all agents", agentMessageReason: "Why it went this way", agentMessageKind: { request: "Request", response: "Response", handoff: "Handoff", broadcast: "Broadcast", error: "Error" }, automationWhen: "When", automationThen: "Then", automationEnabled: "Enabled", automationLastRun: "Last run", automationResult: { success: "Succeeded", failure: "Failed" }, graphLabel: "Dependency graph", agentState: { idle: "Idle", thinking: "Thinking", running: "Running", paused: "Paused", error: "Error", completed: "Completed" }, codeEditor: "Code editor", chatLabel: "Conversation", chatMessage: "Message", chatSend: "Send", qrCode: "QR code", chartLabel: "Chart", copyCode: "Copy code", tocLabel: "On this page", navigationToggle: "Navigation", sidebarLabel: "Sidebar", universalState: { waiting_user: "Waiting for someone to act.", waiting_approval: "Waiting for approval.", waiting_dependency: "Waiting for something else to finish.", offline: "No connection. This was loaded earlier.", stale: "This may be out of date.", partial: "Some of this could not be loaded.", degraded: "Working with reduced capability." } };
 // pt-BR preservado como locale (mesmos valores que já eram o default): passe
 // <AureaProvider strings={ptBR}> para restaurar português.
-export const ptBR = { close: "Fechar", paginationLabel: "Paginação", previous: "Anterior", next: "Próxima", breadcrumbLabel: "Breadcrumb", tabsLabel: "Abas", optionsLabel: "Opções", tableLabel: "Tabela", commandLabel: "Paleta de comandos", commandPlaceholder: "Digite um comando…", dismissNotification: "Dispensar notificação", toolbarLabel: "Barra de ferramentas", loading: "Carregando", otpDigit: "Dígito", stepperLabel: "Etapas", increment: "Aumentar", decrement: "Diminuir", comboboxEmpty: "Nenhum resultado", comboboxClear: "Limpar seleção", comboboxOpen: "Abrir lista", comboboxRemove: "Remover", comboboxLoading: "Carregando…", fileDropPrompt: "Arraste arquivos aqui ou clique para selecionar", fileAdded: "Arquivo adicionado", fileRemoved: "Arquivo removido", fileRemove: "Remover", fileTooLarge: "Arquivo maior que o limite", fileWrongType: "Tipo de arquivo não aceito", treeLabel: "Árvore", notificationsLabel: "Notificações", notificationMarkAll: "Marcar todas como lidas", notificationEmpty: "Nenhuma notificação", notificationUnread: "Não lida", notificationNew: "novas notificações", dataGridFilter: "Filtrar", dataGridEmpty: "Nenhum resultado", dataGridSelectAll: "Selecionar todas as linhas", dataGridSelectRow: "Selecionar linha", dataGridSelected: "selecionadas", dataGridClearSelection: "Limpar seleção", dataGridBulkLabel: "Ações em lote", dataGridColumns: "Colunas", dataGridResize: "Redimensionar coluna", dataGridStale: "Mostrando dados que podem estar desatualizados.", dataGridPartial: "Algumas linhas não puderam ser carregadas. O que aparece está incompleto.", dataGridError: "Não foi possível carregar as linhas.", dataGridDetails: "Detalhes", dataGridDetailPanel: "Detalhe da linha", dataGridExport: "Exportar", dataGridExportRows: "linhas", dataGridExportFiltered: "linhas filtradas", dataGridExportSelected: "linhas selecionadas", mediaPlayer: "Reprodutor de mídia", mediaPlay: "Reproduzir", mediaPause: "Pausar", mediaMute: "Silenciar", mediaUnmute: "Ativar som", mediaSeek: "Posição da reprodução", mediaVolume: "Volume", mediaCaptionsShow: "Ativar legendas", mediaCaptionsHide: "Desativar legendas", mediaSkipBack: "Voltar 10 segundos", mediaSkipForward: "Avançar 10 segundos", mediaFullscreenEnter: "Tela cheia", mediaFullscreenExit: "Sair da tela cheia", uploadSending: "Enviando", uploadCancel: "Cancelar envio", uploadRetry: "Tentar envio novamente", uploadError: "Falha no envio", uploadCanceled: "Envio cancelado", uploadComplete: "Envio concluído", uploadPause: "Pausar envio", uploadResume: "Retomar envio", uploadPaused: "Pausado", uploadPending: "Aguardando", uploadChecksum: "Soma de verificação", uploadChecksumBad: "O servidor recebeu bytes diferentes dos enviados.", fileConflict: "Já existe um arquivo com este nome na fila", fileReplace: "Substituir", fileKeepBoth: "Manter os dois", fileSkip: "Pular", uploadReceipt: "Recibo", uploadReceiptCopy: "Copiar recibo", agentInspector: "Inspetor do agente", invocationLabel: "Invocação", invocationInput: "Entrada", invocationOutput: "Saída", taskQueueLabel: "Fila de tarefas", taskState: { queued: "Na fila", running: "Executando", completed: "Concluída", failed: "Falhou", blocked: "Bloqueada", paused: "Pausada" }, taskPriority: { low: "Baixa", medium: "Média", high: "Alta" }, approvalLabel: "Aprovação", approvalApprove: "Aprovar", approvalDeny: "Negar", approvalApproved: "Aprovado", approvalDenied: "Negado", approvalDeadline: "Decidir até", approvalRisk: { low: "Risco baixo", medium: "Risco médio", high: "Risco alto" }, permissionLabel: "Permissões de ferramenta", permissionAsk: "Perguntar", permissionAlways: "Sempre", permissionNever: "Nunca", eventStreamLabel: "Eventos", traceLabel: "Rastro", healthLabel: "Saúde", healthState: { operational: "Operando", degraded: "Degradado", down: "Fora do ar", maintenance: "Em manutenção", unknown: "Desconhecido" }, modelUsageLabel: "Consumo por modelo", usageMetric: { tokens: "Tokens", cost: "Custo", requests: "Chamadas" }, costMeterLabel: "Custo", costMeterSpent: "Gasto", costMeterRemaining: "restantes", costMeterExceeded: "Acima do limite", costMeterNear: "O gasto passou do limite brando.", costMeterOver: "O limite foi atingido. As próximas chamadas estão bloqueadas.", memoryLabel: "Livro-razão de memória", memoryProvenance: "De onde isto veio", memoryOperation: { added: "Guardada", updated: "Atualizada", recalled: "Lembrada", forgotten: "Esquecida" }, memoryScope: { episodic: "Episódica", semantic: "Semântica", procedural: "Procedural" }, agentMessageLabel: "Recados entre agentes", agentMessageTo: "para", agentMessageBroadcast: "todos os agentes", agentMessageReason: "Por que foi por aqui", agentMessageKind: { request: "Pedido", response: "Resposta", handoff: "Passagem", broadcast: "Difusão", error: "Erro" }, automationWhen: "Quando", automationThen: "Então", automationEnabled: "Ativa", automationLastRun: "Última execução", automationResult: { success: "Concluiu", failure: "Falhou" }, graphLabel: "Grafo de dependências", agentState: { idle: "Ocioso", thinking: "Pensando", running: "Executando", paused: "Pausado", error: "Erro", completed: "Concluído" }, codeEditor: "Editor de código", chatLabel: "Conversa", chatMessage: "Mensagem", chatSend: "Enviar", qrCode: "Código QR", chartLabel: "Gráfico", copyCode: "Copiar código", tocLabel: "Nesta página", navigationToggle: "Navegação", sidebarLabel: "Lateral", universalState: { waiting_user: "Esperando alguém agir.", waiting_approval: "Esperando aprovação.", waiting_dependency: "Esperando outra coisa terminar.", offline: "Sem conexão. Isto foi carregado antes.", stale: "Isto pode estar desatualizado.", partial: "Parte disto não pôde ser carregada.", degraded: "Funcionando com capacidade reduzida." } };
+export const ptBR = { close: "Fechar", confirmCancel: "Cancelar", dataError: "Não foi possível carregar.", dataEmpty: "Ainda não há nada aqui", confirmProceed: "Continuar", paginationLabel: "Paginação", previous: "Anterior", next: "Próxima", breadcrumbLabel: "Breadcrumb", tabsLabel: "Abas", optionsLabel: "Opções", tableLabel: "Tabela", commandLabel: "Paleta de comandos", commandPlaceholder: "Digite um comando…", dismissNotification: "Dispensar notificação", toolbarLabel: "Barra de ferramentas", loading: "Carregando", otpDigit: "Dígito", stepperLabel: "Etapas", increment: "Aumentar", decrement: "Diminuir", comboboxEmpty: "Nenhum resultado", comboboxClear: "Limpar seleção", comboboxOpen: "Abrir lista", comboboxRemove: "Remover", comboboxLoading: "Carregando…", fileDropPrompt: "Arraste arquivos aqui ou clique para selecionar", fileAdded: "Arquivo adicionado", fileRemoved: "Arquivo removido", fileRemove: "Remover", fileTooLarge: "Arquivo maior que o limite", fileWrongType: "Tipo de arquivo não aceito", treeLabel: "Árvore", notificationsLabel: "Notificações", notificationMarkAll: "Marcar todas como lidas", notificationEmpty: "Nenhuma notificação", notificationUnread: "Não lida", notificationNew: "novas notificações", dataGridFilter: "Filtrar", dataGridEmpty: "Nenhum resultado", dataGridSelectAll: "Selecionar todas as linhas", dataGridSelectRow: "Selecionar linha", dataGridSelected: "selecionadas", dataGridClearSelection: "Limpar seleção", dataGridBulkLabel: "Ações em lote", dataGridColumns: "Colunas", dataGridResize: "Redimensionar coluna", dataGridStale: "Mostrando dados que podem estar desatualizados.", dataGridPartial: "Algumas linhas não puderam ser carregadas. O que aparece está incompleto.", dataGridError: "Não foi possível carregar as linhas.", dataGridDetails: "Detalhes", dataGridDetailPanel: "Detalhe da linha", dataGridExport: "Exportar", dataGridExportRows: "linhas", dataGridExportFiltered: "linhas filtradas", dataGridExportSelected: "linhas selecionadas", mediaPlayer: "Reprodutor de mídia", mediaPlay: "Reproduzir", mediaPause: "Pausar", mediaMute: "Silenciar", mediaUnmute: "Ativar som", mediaSeek: "Posição da reprodução", mediaVolume: "Volume", mediaCaptionsShow: "Ativar legendas", mediaCaptionsHide: "Desativar legendas", mediaSkipBack: "Voltar 10 segundos", mediaSkipForward: "Avançar 10 segundos", mediaFullscreenEnter: "Tela cheia", mediaFullscreenExit: "Sair da tela cheia", carouselLabel: "Carrossel", carouselSlide: "Slide", positionOf: "de", carouselPrev: "Slide anterior", carouselNext: "Próximo slide", galleryLabel: "Galeria", sortableLabel: "Lista ordenável", sortableHandle: "Reordenar", sortableHelp: "Aperte Espaço para pegar, e as setas para cima e para baixo para mover. Espaço solta, Esc devolve ao lugar.", sortableGrabbed: "Pego", sortableDropped: "Solto", sortableMoved: "Movido", sortableCanceled: "Devolvido", blockEditorLabel: "Blocos de conteúdo", blockLabel: "Bloco", blockRemove: "Remover bloco", uploadSending: "Enviando", uploadCancel: "Cancelar envio", uploadRetry: "Tentar envio novamente", uploadError: "Falha no envio", uploadCanceled: "Envio cancelado", uploadComplete: "Envio concluído", uploadPause: "Pausar envio", uploadResume: "Retomar envio", uploadPaused: "Pausado", uploadPending: "Aguardando", uploadChecksum: "Soma de verificação", uploadChecksumBad: "O servidor recebeu bytes diferentes dos enviados.", fileConflict: "Já existe um arquivo com este nome na fila", fileReplace: "Substituir", fileKeepBoth: "Manter os dois", fileSkip: "Pular", uploadReceipt: "Recibo", uploadReceiptCopy: "Copiar recibo", agentInspector: "Inspetor do agente", invocationLabel: "Invocação", invocationInput: "Entrada", invocationOutput: "Saída", taskQueueLabel: "Fila de tarefas", taskState: { queued: "Na fila", running: "Executando", completed: "Concluída", failed: "Falhou", blocked: "Bloqueada", paused: "Pausada" }, taskPriority: { low: "Baixa", medium: "Média", high: "Alta" }, approvalLabel: "Aprovação", approvalApprove: "Aprovar", approvalDeny: "Negar", approvalApproved: "Aprovado", approvalDenied: "Negado", approvalDeadline: "Decidir até", approvalRisk: { low: "Risco baixo", medium: "Risco médio", high: "Risco alto" }, permissionLabel: "Permissões de ferramenta", permissionAsk: "Perguntar", permissionAlways: "Sempre", permissionNever: "Nunca", eventStreamLabel: "Eventos", traceLabel: "Rastro", healthLabel: "Saúde", healthState: { operational: "Operando", degraded: "Degradado", down: "Fora do ar", maintenance: "Em manutenção", unknown: "Desconhecido" }, modelUsageLabel: "Consumo por modelo", usageMetric: { tokens: "Tokens", cost: "Custo", requests: "Chamadas" }, costMeterLabel: "Custo", costMeterSpent: "Gasto", costMeterRemaining: "restantes", costMeterExceeded: "Acima do limite", costMeterNear: "O gasto passou do limite brando.", costMeterOver: "O limite foi atingido. As próximas chamadas estão bloqueadas.", memoryLabel: "Livro-razão de memória", memoryProvenance: "De onde isto veio", memoryOperation: { added: "Guardada", updated: "Atualizada", recalled: "Lembrada", forgotten: "Esquecida" }, memoryScope: { episodic: "Episódica", semantic: "Semântica", procedural: "Procedural" }, agentMessageLabel: "Recados entre agentes", agentMessageTo: "para", agentMessageBroadcast: "todos os agentes", agentMessageReason: "Por que foi por aqui", agentMessageKind: { request: "Pedido", response: "Resposta", handoff: "Passagem", broadcast: "Difusão", error: "Erro" }, automationWhen: "Quando", automationThen: "Então", automationEnabled: "Ativa", automationLastRun: "Última execução", automationResult: { success: "Concluiu", failure: "Falhou" }, graphLabel: "Grafo de dependências", agentState: { idle: "Ocioso", thinking: "Pensando", running: "Executando", paused: "Pausado", error: "Erro", completed: "Concluído" }, codeEditor: "Editor de código", chatLabel: "Conversa", chatMessage: "Mensagem", chatSend: "Enviar", qrCode: "Código QR", chartLabel: "Gráfico", copyCode: "Copiar código", tocLabel: "Nesta página", navigationToggle: "Navegação", sidebarLabel: "Lateral", universalState: { waiting_user: "Esperando alguém agir.", waiting_approval: "Esperando aprovação.", waiting_dependency: "Esperando outra coisa terminar.", offline: "Sem conexão. Isto foi carregado antes.", stale: "Isto pode estar desatualizado.", partial: "Parte disto não pôde ser carregada.", degraded: "Funcionando com capacidade reduzida." } };
 // Sprite de ícones: CONFIGURAÇÃO DE APLICAÇÃO, então entra pelo provider, uma vez.
 // Antes o default absoluto "/aurea-icons.svg" vivia no Icon e 15 componentes declaravam
 // e repassavam `spriteUrl` à mão — 52 sítios de código. Consequência: aplicação servida
@@ -85,3 +85,27 @@ export function gridStateFromParams(params, filters) {
         state.columnFilters = colunas;
     return state;
 }
+const CHAVES_TELA = ["tab", "view", "detail"];
+// `into` preserva o que já estava, pelo mesmo motivo do `gridStateToParams`: uma aplicação real
+// tem `ref=`, `utm_*` e companhia na mesma URL, e serializar a tela não pode apagá-los. O que se
+// apaga é só o que ESTE formato escreve — senão um estado que saiu continuaria na URL.
+export function screenStateToParams(state, into) {
+    const p = gridStateToParams(state, into);
+    for (const k of CHAVES_TELA)
+        p.delete(k);
+    for (const k of CHAVES_TELA) {
+        const v = state[k];
+        if (v)
+            p.set(k, v);
+    }
+    return p;
+}
+export function screenStateFromParams(params, filters) {
+    const state = gridStateFromParams(params, filters);
+    for (const k of CHAVES_TELA) {
+        const v = params.get(k);
+        if (v)
+            state[k] = v;
+    }
+    return state;
+}

package/dist/system.d.ts

@@ -9,6 +9,15 @@ export declare function AureaProvider({ children, strings, direction, spriteUrl,
 }): React.JSX.Element;
 export type AureaToastType = "info" | "success" | "warning" | "danger";
 export declare const useToast: () => import("@base-ui/react").UseToastManagerReturnValue<any>;
+export type AureaThemeName = "dark" | "light";
+export type AureaDensity = "compact" | "comfortable" | "spacious";
+export declare function useAureaTheme(): {
+    theme: AureaThemeName | null;
+    density: AureaDensity | null;
+    setTheme: (t: AureaThemeName) => void;
+    setDensity: (d: AureaDensity) => void;
+    toggleTheme: () => void;
+};
 export type IconName = string;
 export interface IconProps extends React.SVGAttributes<SVGSVGElement> {
     name: IconName;

package/dist/system.js

@@ -20,6 +20,52 @@ export function AureaProvider({ children, strings, direction = "ltr", spriteUrl
     return _jsx(StringsContext.Provider, { value: value, children: _jsx(SpriteContext.Provider, { value: spriteUrl, children: _jsx(PortalContext.Provider, { value: portalContainer, children: _jsx(DirectionProvider, { direction: direction, children: _jsx(BaseToast.Provider, { children: _jsxs(BaseTooltip.Provider, { children: [children, _jsx(AureaToastViewport, {})] }) }) }) }) }) });
 }
 export const useToast = () => BaseToast.useToastManager();
+// useAureaTheme (M7): ler e trocar os DOIS eixos que a Aurea põe no <html> — `data-theme` e
+// `data-density`. Até aqui só existia `window.Aurea.setTheme` no `aurea.js`, que é vanilla: em
+// React não havia como saber o tema atual sem enfiar a mão no DOM, e um botão de tema não sabia
+// que ícone desenhar.
+//
+// O QUE ESTE HOOK NÃO FAZ, e é a parte mais importante dele — pesquisado em 13/08/2026, não
+// suposto. O `next-themes` já resolve persistência, preferência do sistema, sincronia entre abas
+// e o script embutido que evita o flash, e ele escreve **`data-theme` no <html>**, que é
+// exatamente o atributo que a Aurea lê. Ou seja: os dois já se encaixam sem código nosso.
+// Reescrever isso aqui seria trocar uma biblioteca mantida por uma cópia pior — e guardar
+// preferência de usuário é decisão da APLICAÇÃO, não da biblioteca de interface (é o mesmo
+// motivo pelo qual a persistência de tema do catálogo mora no catálogo).
+// O que ele faz é o que biblioteca nenhuma faz: **densidade**, que é eixo da Aurea e não existe
+// no `next-themes` nem em ninguém.
+//
+// `useSyncExternalStore` e não `useState`: o valor mora no DOM, e quem o troca pode ser outro —
+// o `next-themes`, um script no <head>, ou o `window.Aurea` de sempre. Assinar a mutação do
+// atributo é o que mantém o React em dia com quem manda de verdade.
+//
+// E `getServerSnapshot` devolve `null` de propósito. A armadilha está documentada no próprio
+// `next-themes`: no servidor o tema é **desconhecido**, e fingir um valor produz erro de
+// hidratação. Por isso o retorno é `theme: string|null` — enquanto for `null`, não desenhe UI que
+// dependa do tema. É a mesma regra do "delay rendering until mounted", só que sem um `mounted`
+// solto para o consumidor esquecer de checar.
+const assinaHtml = (cb) => {
+    if (typeof MutationObserver === "undefined")
+        return () => { };
+    const obs = new MutationObserver(cb);
+    obs.observe(document.documentElement, { attributes: true, attributeFilter: ["data-theme", "data-density"] });
+    return () => obs.disconnect();
+};
+const leAtributo = (nome) => () => typeof document === "undefined" ? null : document.documentElement.getAttribute(nome);
+const semServidor = () => null;
+export function useAureaTheme() {
+    const theme = React.useSyncExternalStore(assinaHtml, leAtributo("data-theme"), semServidor);
+    const density = React.useSyncExternalStore(assinaHtml, leAtributo("data-density"), semServidor);
+    return React.useMemo(() => ({
+        theme, density,
+        setTheme: (t) => { document.documentElement.dataset.theme = t; },
+        setDensity: (d) => { document.documentElement.dataset.density = d; },
+        // Alternar é sobre o que está NA TELA, então `null` (servidor, ou ninguém escolheu ainda)
+        // resolve para claro e vira escuro — e não o contrário, que deixaria o primeiro clique sem
+        // efeito visível em quem estava no claro do sistema.
+        toggleTheme: () => { document.documentElement.dataset.theme = theme === "dark" ? "light" : "dark"; },
+    }), [theme, density]);
+}
 function AureaToastList() {
     const { toasts } = BaseToast.useToastManager();
     const s = useAureaStrings();