@aurea-uds/react 0.17.0 → 0.19.1

package/dist/communication.d.ts

@@ -1,6 +1,17 @@
 import React, { type ReactNode } from "react";
 import { type IconName } from "./system.js";
 import { type BadgeVariant } from "./feedback.js";
+export type ChatDirection = "incoming" | "outgoing";
+export interface MessageAttachment {
+    id: string;
+    kind: "image" | "video" | "file";
+    src?: string;
+    alt?: string;
+    name?: string;
+    bytes?: number;
+    duration?: number;
+    href?: string;
+}
 export interface ChatMessage {
     id: string;
     body: ReactNode;
@@ -14,18 +25,60 @@ export interface ChatMessage {
         label: ReactNode;
         variant?: BadgeVariant;
     };
+    direction?: ChatDirection;
+    attachments?: MessageAttachment[];
+    replyTo?: {
+        id: string;
+        author?: ReactNode;
+        body: ReactNode;
+    };
+    forwardedFrom?: ReactNode;
+    edited?: boolean;
+    day?: string;
 }
-export declare function MessageList({ messages, label, className }: {
+export interface MessageListProps {
     messages: ChatMessage[];
     label?: string;
     className?: string;
-}): React.JSX.Element;
-export declare function MessageComposer({ onSend, placeholder, label, icon, sendLabel, disabled, className }: {
-    onSend: (text: string) => void;
+    hasMoreBefore?: boolean;
+    hasMoreAfter?: boolean;
+    loadingBefore?: boolean;
+    loadingAfter?: boolean;
+    onReachStart?: () => void;
+    onReachEnd?: () => void;
+    onOpenAttachment?: (message: ChatMessage, attachment: MessageAttachment) => void;
+}
+export declare function MessageList({ messages, label, className, hasMoreBefore, hasMoreAfter, loadingBefore, loadingAfter, onReachStart, onReachEnd, onOpenAttachment }: MessageListProps): React.JSX.Element;
+export interface ComposerReply {
+    id: string;
+    author?: ReactNode;
+    body: ReactNode;
+}
+export interface ComposerEdit {
+    id: string;
+    body: string;
+}
+export interface ComposerAttach {
+    accept?: string;
+    maxSize?: number;
+    multiple?: boolean;
+}
+export interface MessageSendDetails {
+    files: File[];
+    replyToId?: string;
+    editingId?: string;
+}
+export declare function MessageComposer({ onSend, placeholder, label, icon, sendLabel, disabled, className, attach, replyTo, onCancelReply, editing, onCancelEdit }: {
+    onSend: (text: string, details?: MessageSendDetails) => void;
     placeholder?: string;
     label?: string;
     icon?: IconName;
     sendLabel?: string;
     disabled?: boolean;
     className?: string;
+    attach?: boolean | ComposerAttach;
+    replyTo?: ComposerReply | null;
+    onCancelReply?: () => void;
+    editing?: ComposerEdit | null;
+    onCancelEdit?: () => void;
 }): React.JSX.Element;

package/dist/communication.js

@@ -1,5 +1,5 @@
 "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.
@@ -9,21 +9,244 @@ import { InputGroup, InputGroupAddon } from "./inputs.js";
 import { Icon } from "./system.js";
 import { IconButton } from "./actions.js";
 import { Avatar } from "./identity.js";
-import { Badge } from "./feedback.js";
-export function MessageList({ messages, label, className }) {
+import { Badge, Spinner } from "./feedback.js";
+import { formatSize, matchesAccept } from "./file-input.js";
+// A AN-02 põe álbum na mensagem com a `Gallery` que já existe. `media` mora no "resto" do DAG,
+// como este módulo, e não importa `communication` — não há ciclo.
+import { Gallery } from "./media.js";
+// O contêiner que rola é o ancestral com `overflow` de rolagem, ou a página.
+function rolador(el) {
+    for (let p = el.parentElement; p; p = p.parentElement) {
+        const o = getComputedStyle(p).overflowY;
+        if (o === "auto" || o === "scroll" || o === "overlay")
+            return p;
+    }
+    return document.scrollingElement ?? document.documentElement;
+}
+const ehPagina = (sc) => sc === document.scrollingElement || sc === document.documentElement;
+function useVigia(alvo, ligado, avisar, deps) {
+    const cb = React.useRef(avisar);
+    cb.current = avisar;
+    React.useEffect(() => {
+        const el = alvo.current;
+        if (!el || !ligado || typeof IntersectionObserver === "undefined")
+            return;
+        const sc = rolador(el);
+        const obs = new IntersectionObserver(es => { if (es.some(e => e.isIntersecting))
+            cb.current?.(); }, { root: ehPagina(sc) ? null : sc });
+        obs.observe(el);
+        return () => obs.disconnect();
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [ligado, ...deps]);
+}
+export function MessageList({ messages, label, className, hasMoreBefore, hasMoreAfter, loadingBefore, loadingAfter, onReachStart, onReachEnd, onOpenAttachment }) {
     const s = useAureaStrings();
-    return _jsx("div", { className: cx("stack", className), role: "log", "aria-live": "polite", "aria-label": label ?? s.chatLabel, children: messages.map(m => _jsxs("div", { className: "message", children: [m.avatar ? _jsx(Avatar, { src: m.avatar.src, fallback: m.avatar.fallback }) : _jsx("span", {}), _jsxs("div", { className: "message-bubble", children: [(m.author || m.time) && _jsxs("div", { className: "label", children: [_jsx("span", { children: m.author }), m.time && _jsx("span", { className: "hint", children: m.time })] }), m.body, m.status && _jsx("div", { className: "message-status", children: _jsxs(Badge, { variant: m.status.variant, children: [_jsx("i", { className: "status-dot" }), m.status.label] }) })] })] }, m.id)) });
+    const janela = !!onReachStart || !!onReachEnd;
+    const raiz = React.useRef(null);
+    const topo = React.useRef(null);
+    const fim = React.useRef(null);
+    const ancora = React.useRef(null);
+    const noFim = React.useRef(true);
+    const ultimoAntes = React.useRef(undefined);
+    const montou = React.useRef(false);
+    const [anuncio, setAnuncio] = React.useState("");
+    const hasMoreAfterRef = React.useRef(hasMoreAfter);
+    hasMoreAfterRef.current = hasMoreAfter;
+    // A posição de quem está no alto da tela, e se a última está à vista. Lida a cada rolagem e
+    // depois de cada troca: entre uma troca e outra, só a rolagem move as mensagens.
+    const medir = React.useCallback(() => {
+        const el = raiz.current;
+        if (!el)
+            return;
+        const sc = rolador(el), pag = ehPagina(sc);
+        const alto = pag ? 0 : sc.getBoundingClientRect().top, baixo = pag ? window.innerHeight : sc.getBoundingClientRect().bottom;
+        const itens = el.querySelectorAll("[data-message-id]");
+        // A âncora é a primeira que COMEÇA dentro da tela, e não a primeira que aparece: medido no banco
+        // em 04/10/2026, um álbum cortado no alto cresceu 480 px quando as fotos chegaram — para baixo
+        // dele —, o topo dele não andou, e a conversa inteira desceu sem a conta perceber. Se nenhuma
+        // começa na tela (uma mensagem maior que ela), vale a que está à vista.
+        ancora.current = null;
+        let vista;
+        for (const it of Array.from(itens)) {
+            const r = it.getBoundingClientRect();
+            if (r.bottom <= alto)
+                continue;
+            vista ??= it;
+            if (r.top >= alto) {
+                ancora.current = { id: it.dataset.messageId, top: r.top };
+                break;
+            }
+        }
+        if (!ancora.current && vista)
+            ancora.current = { id: vista.dataset.messageId, top: vista.getBoundingClientRect().top };
+        const ultimo = itens[itens.length - 1];
+        noFim.current = !ultimo || ultimo.getBoundingClientRect().bottom <= baixo + 1;
+    }, []);
+    React.useEffect(() => {
+        if (!janela || !raiz.current)
+            return;
+        const sc = rolador(raiz.current), alvo = ehPagina(sc) ? window : sc;
+        alvo.addEventListener("scroll", medir, { passive: true });
+        return () => alvo.removeEventListener("scroll", medir);
+    }, [janela, medir]);
+    const ultimoId = messages[messages.length - 1]?.id;
+    React.useLayoutEffect(() => {
+        const el = raiz.current;
+        if (!janela || !el) {
+            ultimoAntes.current = ultimoId;
+            return;
+        }
+        const sc = rolador(el);
+        const irAoFim = () => { sc.scrollTop = sc.scrollHeight; };
+        const antes = ultimoAntes.current;
+        // Chegou mensagem no fim: a última de antes continua na lista, e não é mais a última.
+        const ia = antes === undefined ? -1 : messages.findIndex(m => m.id === antes);
+        const chegou = montou.current && ia >= 0 && ia < messages.length - 1;
+        if (!montou.current) {
+            irAoFim();
+            montou.current = true;
+        }
+        else if (chegou && noFim.current && !hasMoreAfter)
+            irAoFim();
+        else if (ancora.current) {
+            const it = el.querySelector(`[data-message-id="${CSS.escape(ancora.current.id)}"]`);
+            if (it)
+                sc.scrollTop += it.getBoundingClientRect().top - ancora.current.top;
+        }
+        if (chegou) {
+            const novo = el.querySelector(`[data-message-id="${CSS.escape(ultimoId)}"]`);
+            setAnuncio(novo?.textContent ?? "");
+        }
+        ultimoAntes.current = ultimoId;
+        medir();
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [messages]);
+    // A ALTURA MUDA DEPOIS DE MONTAR — a fonte chega, a foto decodifica, o app troca um texto — e
+    // nenhuma rolagem acontece para avisar. Medido no banco em 04/10/2026: a conversa abria na #4992
+    // e não na última. Então se observa o tamanho da lista: quem estava no fim continua no fim; quem
+    // não estava mantém a mensagem do alto onde ela estava.
+    React.useEffect(() => {
+        const el = raiz.current;
+        if (!janela || !el || typeof ResizeObserver === "undefined")
+            return;
+        const ro = new ResizeObserver(() => {
+            const sc = rolador(el);
+            if (noFim.current && !hasMoreAfterRef.current)
+                sc.scrollTop = sc.scrollHeight;
+            else if (ancora.current) {
+                const it = el.querySelector(`[data-message-id="${CSS.escape(ancora.current.id)}"]`);
+                if (it)
+                    sc.scrollTop += it.getBoundingClientRect().top - ancora.current.top;
+            }
+            medir();
+        });
+        ro.observe(el);
+        return () => ro.disconnect();
+    }, [janela, medir]);
+    useVigia(topo, janela && !!hasMoreBefore && !loadingBefore, onReachStart, [messages.length]);
+    useVigia(fim, janela && !!hasMoreAfter && !loadingAfter, onReachEnd, [messages.length]);
+    return _jsxs(_Fragment, { children: [_jsxs("div", { ref: raiz, className: cx("stack", className), role: "log", "aria-live": janela ? "off" : "polite", "aria-busy": (janela && (loadingBefore || loadingAfter)) || undefined, "aria-label": label ?? s.chatLabel, children: [janela && hasMoreBefore && _jsx("div", { ref: topo, className: "message-more", children: loadingBefore && _jsx(Spinner, {}) }), messages.map((m, i) => {
+                        const lado = m.direction;
+                        const midia = (m.attachments ?? []).filter(a => a.kind !== "file" && a.src);
+                        const arquivos = (m.attachments ?? []).filter(a => a.kind === "file");
+                        const dia = m.day != null && m.day !== messages[i - 1]?.day;
+                        return _jsxs(React.Fragment, { children: [dia && _jsx("div", { className: "message-day", children: _jsx(Badge, { children: m.day }) }), _jsxs("div", { className: cx("message", lado === "outgoing" && "message-out", lado === "incoming" && "message-in"), "data-message-id": m.id, children: [lado === "outgoing" ? null : m.avatar ? _jsx(Avatar, { src: m.avatar.src, fallback: m.avatar.fallback }) : _jsx("span", {}), _jsxs("div", { className: "message-bubble", children: [(m.author || m.time || m.edited) && _jsxs("div", { className: "label", children: [_jsx("span", { children: m.author }), (m.time || m.edited) && _jsxs("span", { className: "hint", children: [m.edited && _jsxs(_Fragment, { children: [s.chatEdited, m.time != null && " · "] }), m.time] })] }), m.forwardedFrom != null && _jsxs("div", { className: "message-forwarded", children: [_jsx(Icon, { name: "share-fat", size: "sm" }), _jsxs("span", { children: [s.chatForwardedFrom, " ", m.forwardedFrom] })] }), m.replyTo && _jsx("div", { className: "message-quote", children: _jsxs("span", { className: "message-quote-text", children: [_jsx("span", { className: "message-quote-title", children: m.replyTo.author }), _jsx("span", { className: "message-quote-body", children: m.replyTo.body })] }) }), midia.length > 0 && _jsx(Gallery, { className: "message-album", label: s.chatAttachments, zoom: !onOpenAttachment, ratio: midia.length === 1 ? "4/3" : "1/1", items: midia.map(a => ({ id: a.id, src: a.src, alt: a.alt ?? a.name ?? "", kind: a.kind === "video" ? "video" : "image", duration: a.duration })), onSelect: onOpenAttachment ? (id => { const a = midia.find(x => x.id === id); if (a)
+                                                        onOpenAttachment(m, a); }) : undefined }), arquivos.length > 0 && _jsx("ul", { className: "file-list", "aria-label": s.chatAttachments, children: arquivos.map(a => _jsxs("li", { className: "file-item", children: [_jsx(Icon, { name: "file-text" }), a.href ? _jsx("a", { className: "file-name", href: a.href, download: a.name ?? true, children: a.name ?? a.href }) : _jsx("span", { className: "file-name", children: a.name }), a.bytes != null && _jsx("span", { className: "file-size", children: formatSize(a.bytes) })] }, a.id)) }), m.body, m.status && _jsx("div", { className: "message-status", children: _jsxs(Badge, { variant: m.status.variant, children: [_jsx("i", { className: "status-dot" }), m.status.label] }) })] })] })] }, m.id);
+                    }), janela && hasMoreAfter && _jsx("div", { ref: fim, className: "message-more", children: loadingAfter && _jsx(Spinner, {}) })] }), janela && _jsx("span", { className: "sr-only", role: "status", "aria-live": "polite", children: anuncio })] });
 }
-// Composer: <form> sobre InputGroup + .input; Enter envia (submit nativo) e limpa.
-// Texto é estado interno (não controlado — controlar de fora só com demanda real,
-// precedente MediaPlayer/FileInput). Não envia texto vazio/só-espaço; o botão de
-// envio desabilita enquanto vazio. O input sempre tem nome acessível (aria-label),
-// pois placeholder não serve de nome. ponytail: input de uma linha; textarea +
-// Shift+Enter quando surgir demanda de multilinha.
-export function MessageComposer({ onSend, placeholder, label, icon, sendLabel, disabled, className }) {
+export function MessageComposer({ onSend, placeholder, label, icon, sendLabel, disabled, className, attach, replyTo, onCancelReply, editing, onCancelEdit }) {
     const s = useAureaStrings();
     const [text, setText] = React.useState("");
-    const submit = (e) => { e.preventDefault(); const t = text.trim(); if (!t)
-        return; onSend(t); setText(""); };
-    return _jsxs("form", { className: cx("message-composer", className), onSubmit: submit, children: [_jsxs(InputGroup, { children: [icon && _jsx(InputGroupAddon, { children: _jsx(Icon, { name: icon }) }), _jsx("input", { className: "input", value: text, disabled: disabled, placeholder: placeholder, "aria-label": label ?? s.chatMessage, onChange: e => setText(e.target.value) })] }), _jsx(IconButton, { type: "submit", variant: "primary", icon: "paper-plane-tilt", label: sendLabel ?? s.chatSend, disabled: disabled || !text.trim() })] });
+    const [anexos, setAnexos] = React.useState([]);
+    const [recusados, setRecusados] = React.useState([]);
+    const [aviso, setAviso] = React.useState("");
+    const campo = React.useRef(null);
+    const seletor = React.useRef(null);
+    const seq = React.useRef(0);
+    const opcoes = attach === true ? {} : attach || undefined;
+    const editandoId = editing?.id;
+    const respondendoId = replyTo?.id;
+    // O texto antigo entra quando a edição COMEÇA (muda o id), e sai quando ela acaba — sem isso o
+    // texto da mensagem editada ficava no campo como rascunho de mensagem nova.
+    const editouAntes = React.useRef(undefined);
+    React.useEffect(() => {
+        if (editandoId !== undefined) {
+            setText(editing?.body ?? "");
+            campo.current?.focus();
+        }
+        else if (editouAntes.current !== undefined)
+            setText("");
+        editouAntes.current = editandoId;
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [editandoId]);
+    React.useEffect(() => { if (respondendoId !== undefined)
+        campo.current?.focus(); }, [respondendoId]);
+    // As URLs das miniaturas vivem enquanto o anexo vive; desmontar solta todas (o FileInput faz igual).
+    const anexosRef = React.useRef(anexos);
+    anexosRef.current = anexos;
+    React.useEffect(() => () => anexosRef.current.forEach(a => a.url && URL.revokeObjectURL(a.url)), []);
+    const soltar = (lista) => lista.forEach(a => a.url && URL.revokeObjectURL(a.url));
+    const escolher = (lista) => {
+        if (!lista)
+            return;
+        const novos = [], fora = [];
+        for (const file of Array.from(lista)) {
+            if (!matchesAccept(file, opcoes?.accept))
+                fora.push({ name: file.name, reason: s.fileWrongType });
+            else if (opcoes?.maxSize != null && file.size > opcoes.maxSize)
+                fora.push({ name: file.name, reason: s.fileTooLarge });
+            else
+                novos.push({ id: `a${seq.current++}`, file, url: file.type.startsWith("image/") && typeof URL.createObjectURL === "function" ? URL.createObjectURL(file) : undefined });
+        }
+        setRecusados(fora);
+        if (novos.length) {
+            if (opcoes?.multiple === false) {
+                soltar(anexos);
+                setAnexos(novos.slice(0, 1));
+            }
+            else
+                setAnexos(prev => [...prev, ...novos]);
+            setAviso(`${s.fileAdded}: ${novos.map(a => a.file.name).join(", ")}`);
+        }
+        if (seletor.current)
+            seletor.current.value = "";
+    };
+    const remover = (a) => { soltar([a]); setAnexos(prev => prev.filter(x => x.id !== a.id)); setAviso(`${s.fileRemoved}: ${a.file.name}`); campo.current?.focus(); };
+    const podeAnexar = !!opcoes && editandoId === undefined;
+    const vazio = !text.trim() && !(podeAnexar && anexos.length);
+    const submit = (e) => {
+        e.preventDefault();
+        if (vazio)
+            return;
+        const t = text.trim();
+        // O segundo argumento só vai quando o app usa uma prop nova: quem chamava `onSend(texto)` e
+        // conferia a chamada exata continua recebendo exatamente isso.
+        if (!opcoes && replyTo == null && editing == null)
+            onSend(t);
+        else
+            onSend(t, { files: podeAnexar ? anexos.map(a => a.file) : [], replyToId: editandoId === undefined ? respondendoId : undefined, editingId: editandoId });
+        setText("");
+        soltar(anexos);
+        setAnexos([]);
+        setRecusados([]);
+    };
+    const aoTeclar = (e) => {
+        if (e.key !== "Escape")
+            return;
+        if (editandoId !== undefined && onCancelEdit) {
+            e.preventDefault();
+            onCancelEdit();
+        }
+        else if (respondendoId !== undefined && onCancelReply) {
+            e.preventDefault();
+            onCancelReply();
+        }
+    };
+    const citacao = editing
+        ? _jsxs("div", { className: "message-quote", children: [_jsx(Icon, { name: "pencil-simple", size: "sm" }), _jsxs("span", { className: "message-quote-text", children: [_jsx("span", { className: "message-quote-title", children: s.chatEditing }), _jsx("span", { className: "message-quote-body", children: editing.body })] }), onCancelEdit && _jsx(IconButton, { variant: "ghost", size: "sm", icon: "x", label: s.chatEditCancel, onClick: onCancelEdit })] })
+        : replyTo
+            ? _jsxs("div", { className: "message-quote", children: [_jsx(Icon, { name: "arrow-bend-up-left", size: "sm" }), _jsxs("span", { className: "message-quote-text", children: [_jsxs("span", { className: "message-quote-title", children: [s.chatReplyTo, replyTo.author != null && _jsxs(_Fragment, { children: [" ", replyTo.author] })] }), _jsx("span", { className: "message-quote-body", children: replyTo.body })] }), onCancelReply && _jsx(IconButton, { variant: "ghost", size: "sm", icon: "x", label: s.chatReplyCancel, onClick: onCancelReply })] })
+            : null;
+    const temFaixa = !!citacao || (podeAnexar && (anexos.length > 0 || recusados.length > 0));
+    return _jsxs("form", { className: cx("message-composer", className), onSubmit: submit, children: [_jsxs(InputGroup, { children: [icon && _jsx(InputGroupAddon, { children: _jsx(Icon, { name: icon }) }), temFaixa && _jsxs("div", { className: "input-group-addon input-group-addon-start input-group-addon-block message-composer-context", children: [citacao, podeAnexar && anexos.length > 0 && _jsx("ul", { className: "file-list", "aria-label": s.chatAttachments, children: anexos.map(a => _jsxs("li", { className: "file-item", children: [a.url ? _jsx("img", { className: "file-thumb", src: a.url, alt: "" }) : _jsx(Icon, { name: "file-text" }), _jsx("span", { className: "file-name", children: a.file.name }), _jsx("span", { className: "file-size", children: formatSize(a.file.size) }), _jsx(IconButton, { variant: "ghost", size: "sm", icon: "x", label: `${s.fileRemove} ${a.file.name}`, onClick: () => remover(a) })] }, a.id)) }), podeAnexar && recusados.map((r, n) => _jsxs("span", { className: "field-error", children: [r.reason, ": ", r.name] }, n))] }), _jsx("input", { ref: campo, className: "input", value: text, disabled: disabled, placeholder: placeholder, "aria-label": label ?? s.chatMessage, onChange: e => setText(e.target.value), onKeyDown: aoTeclar }), podeAnexar && _jsx(InputGroupAddon, { side: "end", children: _jsx(IconButton, { variant: "ghost", size: "sm", icon: "paperclip", label: s.chatAttach, disabled: disabled, onClick: () => seletor.current?.click() }) })] }), podeAnexar && _jsx("input", { ref: seletor, type: "file", hidden: true, accept: opcoes?.accept, multiple: opcoes?.multiple !== false, onChange: e => escolher(e.target.files) }), _jsx(IconButton, { type: "submit", variant: "primary", icon: editing ? "check" : "paper-plane-tilt", label: editing ? s.chatSave : (sendLabel ?? s.chatSend), disabled: disabled || vazio }), podeAnexar && _jsx("span", { className: "sr-only", role: "status", "aria-live": "polite", children: aviso })] });
 }

package/dist/feedback.d.ts

@@ -1,2 +1,2 @@
 export * from "./feedback-client.js";
-export { Badge, formatBadgeCount, Progress, Skeleton, type BadgeVariant, type BadgeEmphasis, type BadgeSize, type BadgePlacement, type BadgeProps } from "./markup.js";
+export { Badge, formatBadgeCount, Progress, Skeleton, type BadgeVariant, type BadgeEmphasis, type BadgeSize, type BadgePlacement, type BadgeProps, type ProgressProps, type ProgressTone } from "./markup.js";

package/dist/file-input.d.ts

@@ -26,6 +26,7 @@ export declare function matchesAccept(file: {
     name: string;
     type: string;
 }, accept?: string): boolean;
+export declare function formatSize(bytes: number): string;
 export declare function FileInput({ accept, maxSize, multiple, onFilesChange, upload, label, hint, id, className, initialQueue, onQueueChange, preview, checksum }: {
     accept?: string;
     maxSize?: number;

package/dist/file-input.js

@@ -57,7 +57,9 @@ async function somaSha256(file) {
 // nova, zero branch novo.
 const ATIVOS = new Set(["pending", "uploading", "paused"]);
 const restaurar = (q) => ({ ...q, restored: true, status: ATIVOS.has(q.status) ? "canceled" : q.status });
-function formatSize(bytes) {
+// Exportada para dentro do pacote (não sai no barril): o `MessageComposer` mostra o tamanho do
+// anexo no mesmo formato da fila daqui (AN-03).
+export function formatSize(bytes) {
     if (bytes < 1024)
         return `${bytes} B`;
     const units = ["KB", "MB", "GB"];

package/dist/index.d.ts

@@ -2,7 +2,7 @@ export { cx, defaultStrings, ptBR, defaultSpriteUrl, gridStateToParams, gridStat
 export { useAureaStrings, useSpriteUrl, useTheme, useDensity } from "./internal.js";
 export { type Responsive, type Breakpoint, type ContainerBreakpoint, type Orientation, ESCALA, ESCALA_CONTAINER } from "./pure.js";
 export { ContainerScope, useValorResponsivo } from "./responsivo-runtime.js";
-export { AspectRatio, InputGroup, InputGroupAddon, Label, Card, Stack, Cluster, Grid, KPI, DataList, Timeline, Prose, Text, Heading, Paragraph, Code, Badge, Progress, Skeleton, AvatarGroup, LogStream, MediaPlayerShell, Topbar, Kbd, Textarea, Checkbox, Radio, Switch, Range, formatBadgeCount, type BadgeVariant, type BadgeEmphasis, type BadgeSize, type BadgePlacement, type BadgeProps, type AvatarSize, type TopbarVariant, type TextProps, type HeadingProps, type ParagraphProps, type CodeProps, type TypographyType, type TypographyColor, type TypographyWeight, type TypographyAlign, type HeadingLevel, type ParagraphSize } from "./markup.js";
+export { AspectRatio, InputGroup, InputGroupAddon, Label, Card, Stack, Cluster, Grid, KPI, DataList, Timeline, Prose, Text, Heading, Paragraph, Code, Badge, Progress, Skeleton, AvatarGroup, LogStream, MediaPlayerShell, Topbar, Kbd, Textarea, Checkbox, Radio, Switch, Range, formatBadgeCount, type BadgeVariant, type BadgeEmphasis, type BadgeSize, type BadgePlacement, type BadgeProps, type ProgressProps, type ProgressTone, type AvatarSize, type TopbarVariant, type TextProps, type HeadingProps, type ParagraphProps, type CodeProps, type TypographyType, type TypographyColor, type TypographyWeight, type TypographyAlign, type HeadingLevel, type ParagraphSize } from "./markup.js";
 export * from "./system.js";
 export * from "./actions.js";
 export * from "./feedback.js";

package/dist/layout-client.d.ts

@@ -1,7 +1,7 @@
 import { type HTMLAttributes, type RefAttributes, type ReactNode } from "react";
 import { type Orientation, type Responsive } from "./pure.js";
 import { type TopbarVariant, type SidebarVariant, type SidebarItem } from "./navigation.js";
-export declare function AppShell({ brand, navigation, navItems, currentNavId, navLabel, topbar, topbarVariant, topbarDivider, sidebarVariant, sidebarCollapsed, contentVariant, children, className, ...props }: HTMLAttributes<HTMLDivElement> & RefAttributes<HTMLDivElement> & {
+export declare function AppShell({ brand, navigation, navItems, currentNavId, navLabel, topbar, topbarVariant, topbarDivider, sidebarVariant, sidebarCollapsed, sidebarCollapsible, defaultSidebarCollapsed, onSidebarCollapsedChange, contentVariant, children, className, ...props }: HTMLAttributes<HTMLDivElement> & RefAttributes<HTMLDivElement> & {
     brand: ReactNode;
     navigation?: ReactNode;
     navItems?: SidebarItem[];
@@ -11,7 +11,14 @@ export declare function AppShell({ brand, navigation, navItems, currentNavId, na
     topbarVariant?: Exclude<TopbarVariant, "pill">;
     topbarDivider?: boolean;
     sidebarVariant?: SidebarVariant;
+    /** A lateral em trilha de ícones. Controlado: quem passa decide (e o `onSidebarCollapsedChange` avisa). */
     sidebarCollapsed?: boolean;
+    /** AN-01: o botão de recolher na junção do menu com o conteúdo, e a trilha sozinha entre 1024 e 1279 de largura. */
+    sidebarCollapsible?: boolean;
+    /** AN-01: começa recolhida, sem controlar. A escolha vale até a janela cruzar 1280. */
+    defaultSidebarCollapsed?: boolean;
+    /** AN-01: avisa cada troca — pelo botão, ou pela largura cruzando 1280. Guardar a preferência é do app. */
+    onSidebarCollapsedChange?: (collapsed: boolean) => void;
     contentVariant?: "surface" | "plain";
 }): import("react").JSX.Element;
 export type SeparatorSpacing = "none" | "tight" | "normal" | "loose";

package/dist/layout-client.js

@@ -3,12 +3,14 @@ import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-run
 // 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 { useEffect, useRef } from "react";
+import { useEffect, useRef, useState, useSyncExternalStore } from "react";
 import { Separator as BaseSeparator } from "@base-ui/react/separator";
+import { useDirection } from "@base-ui/react/direction-provider";
 import { cx, useAureaStrings } from "./internal.js";
 import { useValorResponsivo } from "./responsivo-runtime.js";
 import { ESCALA } from "./escala.js";
 import { IconButton } from "./actions.js";
+import { Tooltip } from "./overlays.js";
 import { Sidebar, Topbar } from "./navigation.js";
 // ── Auxiliar de topo: mora ANTES do primeiro export, e a posição é obrigatória ───────────────
 // O check 22 mede o corpo de um componente do `export` dele até o PRÓXIMO export — fatia longa
@@ -120,10 +122,65 @@ function useGavetaFechaNoDesktop() {
 // fundo, borda e raio do `.card`), e todo `Card` lá dentro virava caixa dentro de caixa igual — um
 // app gastou 14 `!important` para apagá-la. `surface`, a caixa, continua o padrão.
 // B-07: `topbarDivider` repassa a linha de baixo para a barra `flush` que o shell monta.
-export function AppShell({ brand, navigation, navItems, currentNavId, navLabel, topbar, topbarVariant = "floating", topbarDivider, sidebarVariant, sidebarCollapsed, contentVariant = "surface", children, className, ...props }) {
+// AN-01 (03/10/2026): O BOTÃO DE RECOLHER E A TRILHA SOZINHA. Um consumidor viu numa janela de 1508:
+// a lateral sempre aberta, sem botão, e diminuir a janela não a recolhia — só virava gaveta abaixo de
+// 1024. O modo trilha existia (`sidebarCollapsed`, `.sidebar-collapsed`), mas só controlado e sem
+// gatilho. A referência é a `Sidebar` do shadcn que o ReUI usa no `c-sidebar-2` (o HeroUI não tem
+// moldura de app): estado aberto/recolhido, controlado e não controlado, um gatilho, e o nome em
+// dica na trilha. O lugar do botão é o que o Victor marcou: no alto, na junção do menu com o
+// conteúdo. E a trilha sozinha em tela média vem do pedido — a referência não a tem.
+//
+// Tudo LIGADO por `sidebarCollapsible`: sem ele o shell é o de antes, e quem já usa
+// `sidebarCollapsed` com o próprio botão não ganha um segundo.
+const MEDIA_MEDIA = `(min-width: ${ESCALA.lg}px) and (max-width: ${ESCALA.xl - 1}px)`;
+const MEDIA_ESTREITA = `(max-width: ${ESCALA.lg - 1}px)`;
+// A largura pela API do navegador, e não por `resize`: o `useSyncExternalStore` dá a resposta certa
+// já no primeiro desenho do lado do cliente, e no servidor (sem janela) diz "não" — a folha cuida da
+// tela estreita sozinha, então o HTML do servidor não mostra nada errado.
+function useLargura(query) {
+    return useSyncExternalStore((avisar) => {
+        if (typeof window === "undefined" || typeof window.matchMedia !== "function")
+            return () => { };
+        const mq = window.matchMedia(query);
+        mq.addEventListener?.("change", avisar);
+        return () => mq.removeEventListener?.("change", avisar);
+    }, () => typeof window !== "undefined" && typeof window.matchMedia === "function" && window.matchMedia(query).matches, () => false);
+}
+export function AppShell({ brand, navigation, navItems, currentNavId, navLabel, topbar, topbarVariant = "floating", topbarDivider, sidebarVariant, sidebarCollapsed, sidebarCollapsible, defaultSidebarCollapsed, onSidebarCollapsedChange, contentVariant = "surface", children, className, ...props }) {
     const s = useAureaStrings();
     useGavetaFechaNoDesktop();
-    return _jsxs("div", { className: cx("app-shell", topbarVariant === "flush" && "app-shell-flush", className), ...props, children: [_jsx("a", { className: "skip-link", href: `#${SHELL_MAIN_ID}`, children: s.skipToContent }), _jsx(Topbar, { variant: topbarVariant, divider: topbarDivider, brand: _jsxs(_Fragment, { children: [_jsx(IconButton, { className: "nav-toggle", icon: "list", label: s.navigationToggle, popoverTarget: SHELL_NAV_ID }), brand] }), children: topbar }), _jsx(Sidebar, { id: SHELL_NAV_ID, popover: "auto", variant: sidebarVariant, collapsed: sidebarCollapsed, items: navItems, current: currentNavId, label: navLabel, onToggle: focoDaGaveta, children: navigation }), _jsx("main", { id: SHELL_MAIN_ID, tabIndex: -1, className: cx("content", contentVariant === "plain" && "content-plain"), children: children })] });
+    const controlado = sidebarCollapsed !== undefined;
+    // `null` = ninguém escolheu, e vale a largura.
+    const [escolha, setEscolha] = useState(defaultSidebarCollapsed ?? null);
+    const media = useLargura(MEDIA_MEDIA), estreita = useLargura(MEDIA_ESTREITA);
+    const recolhida = controlado ? !!sidebarCollapsed : (escolha ?? (!!sidebarCollapsible && media));
+    // NA GAVETA A LATERAL NUNCA É TRILHA. Abaixo de 1024 ela abre por cima de tudo, com espaço para o
+    // nome; recolhida ali, era uma gaveta de ícones sem nome — também para quem já passava
+    // `sidebarCollapsed` (medido em 03/10/2026, na mesma conferência).
+    const efetiva = recolhida && !estreita;
+    const aviso = useRef(onSidebarCollapsedChange);
+    aviso.current = onSidebarCollapsedChange;
+    // Cruzar 1280 é mudar de contexto: a escolha da pessoa sai e a largura volta a mandar. Pelo
+    // evento do navegador, e não comparando desenhos, para a hidratação não contar como cruzamento.
+    useEffect(() => {
+        if (!sidebarCollapsible || typeof window === "undefined" || typeof window.matchMedia !== "function")
+            return;
+        const mq = window.matchMedia(MEDIA_MEDIA);
+        const aoCruzar = (e) => { if (!controlado)
+            setEscolha(null); aviso.current?.(e.matches); };
+        mq.addEventListener?.("change", aoCruzar);
+        return () => mq.removeEventListener?.("change", aoCruzar);
+    }, [sidebarCollapsible, controlado]);
+    const alternar = () => { const nova = !recolhida; if (!controlado)
+        setEscolha(nova); onSidebarCollapsedChange?.(nova); };
+    const rotulo = efetiva ? s.sidebarExpand : s.sidebarCollapse;
+    // A seta aponta para onde a lateral vai: recolher é para o começo da linha, abrir é para o fim. Na
+    // escrita da direita para a esquerda o começo é a direita — pela direção do provedor, e não por
+    // `:dir(rtl)` na folha (ver a nota do `.sidebar-toggle` no core).
+    // A condição vai escrita no `icon=` do botão, e não numa variável: é ali que o check 46 lê os
+    // ícones que o shell desenha.
+    const paraOComeco = !efetiva, direita = useDirection() === "rtl";
+    return _jsxs("div", { className: cx("app-shell", topbarVariant === "flush" && "app-shell-flush", sidebarCollapsible && "app-shell-collapsible", className), ...props, children: [_jsx("a", { className: "skip-link", href: `#${SHELL_MAIN_ID}`, children: s.skipToContent }), _jsx(Topbar, { variant: topbarVariant, divider: topbarDivider, brand: _jsxs(_Fragment, { children: [_jsx(IconButton, { className: "nav-toggle", icon: "list", label: s.navigationToggle, popoverTarget: SHELL_NAV_ID }), brand] }), children: topbar }), sidebarCollapsible && _jsx("div", { className: "sidebar-toggle-slot", children: _jsx(Tooltip, { content: rotulo, side: "right", children: _jsx(IconButton, { className: "sidebar-toggle", size: "xs", icon: paraOComeco === direita ? "caret-right" : "caret-left", label: rotulo, "aria-expanded": !efetiva, "aria-controls": SHELL_NAV_ID, onClick: alternar }) }) }), _jsx(Sidebar, { id: SHELL_NAV_ID, popover: "auto", variant: sidebarVariant, collapsed: efetiva, items: navItems, current: currentNavId, label: navLabel, onToggle: focoDaGaveta, children: navigation }), _jsx("main", { id: SHELL_MAIN_ID, tabIndex: -1, className: cx("content", contentVariant === "plain" && "content-plain"), children: children })] });
 }
 export function Separator({ orientation, spacing = "none", className, ...props }) {
     const ancora = useRef(null);

package/dist/markup.d.ts

@@ -47,14 +47,21 @@ export interface ClusterProps extends DivProps {
     wrap?: boolean;
 }
 export declare function Cluster({ gap, align, justify, wrap, className, ...props }: ClusterProps): React.JSX.Element;
+/**
+ * A largura mínima da coluna, por nome — AN-08 (03/10/2026). O HeroUI não tem `Grid`, e nenhum dos
+ * quatro números é novo: cada um já mede uma grade ou uma caixa da Aurea (ver `.grid-min-*` no CSS).
+ * `md` é o padrão de sempre.
+ */
+export type GridMin = "xs" | "sm" | "md" | "lg";
 export interface GridProps extends DivProps {
     /** `tight` (--space-2), `normal` (o de sempre, --space-4) ou `loose` (--space-6). */
     gap?: LayoutGap;
     /**
-     * Largura mínima de cada coluna, em unidade de CSS (`"10rem"`, `"155px"`). Padrão `15rem`. É o
-     * `--grid-min` que o CSS sempre leu e que nenhum tipo mostrava.
+     * Largura mínima de cada coluna. Por nome (AN-08): `xs` 8rem, `sm` 12rem, `md` 15rem (o padrão)
+     * ou `lg` 20rem. Ou em unidade de CSS (`"10rem"`, `"155px"`) — o `--grid-min` que o CSS sempre
+     * leu. Até a 0.17, `"sm"` passava pelo tipo e a grade virava UMA coluna, sem aviso.
      */
-    min?: string;
+    min?: GridMin | (string & {});
     /** Número fixo de colunas, iguais. Com ele, `min` deixa de valer. */
     columns?: number;
 }
@@ -139,10 +146,21 @@ export interface BadgeProps extends HTMLAttributes<HTMLSpanElement>, RefAttribut
     badgeContent?: ReactNode;
 }
 export declare function Badge({ variant, emphasis, size, dot, leading, trailing, image, imageAlt, count, max, showZero, fit, anchor, anchorShape, invisible, badgeContent, children, className, ...props }: BadgeProps): React.JSX.Element;
-export declare function Progress({ value, label }: {
-    value: number;
+/** O tom da barra: a mesma lista fechada do `ButtonTone`. Pausado é `neutral`; falha é `danger`. */
+export type ProgressTone = "brand" | "neutral" | "success" | "warning" | "danger" | "info";
+export interface ProgressProps {
+    /** 0 a 100; fora disso é grampeado. **Sem `value`, a barra é indeterminada** (AN-07): o total
+     *  ainda não se sabe, e um pedaço corre pelo trilho, no lugar de um 0% que parece parado. */
+    value?: number;
+    /** O nome que o leitor de tela anuncia. Não aparece. */
     label?: string;
-}): React.JSX.Element;
+    /** O texto de apoio, no alto à direita — o `ProgressBar.Output` do HeroUI: velocidade, tempo
+     *  que falta, bytes. Em texto, vai junto no `aria-valuetext`. */
+    detail?: ReactNode;
+    tone?: ProgressTone;
+    className?: string;
+}
+export declare function Progress({ value, label, detail, tone, className }: ProgressProps): React.JSX.Element;
 export declare function Skeleton({ className, ...props }: HTMLAttributes<HTMLDivElement> & RefAttributes<HTMLDivElement>): React.JSX.Element;
 export declare function AvatarGroup({ children, max, total, label, size, className }: {
     children: ReactNode;

package/dist/markup.js

@@ -48,11 +48,14 @@ function CardMedia({ className, ...props }) { return _jsx("div", { className: cx
 Card.Media = CardMedia;
 export function Stack({ gap, align, className, ...props }) { return _jsx("div", { className: cx("stack", gap && gap !== "normal" && `stack-gap-${gap}`, align && align !== "stretch" && `stack-align-${align}`, className), ...props }); }
 export function Cluster({ gap, align, justify, wrap, className, ...props }) { return _jsx("div", { className: cx("cluster", gap && gap !== "normal" && `cluster-gap-${gap}`, align && align !== "center" && `cluster-align-${align}`, justify && justify !== "start" && `cluster-justify-${justify}`, wrap === false && "cluster-nowrap", className), ...props }); }
+const GRID_MIN = new Set(["xs", "sm", "md", "lg"]);
 export function Grid({ gap, min, columns, className, style, ...props }) {
-    const vars = min != null || columns != null
-        ? { ...(min != null ? { "--grid-min": min } : {}), ...(columns != null ? { "--grid-cols": String(columns) } : {}), ...style }
+    const nome = min != null && GRID_MIN.has(min);
+    const medida = min != null && !nome ? min : undefined;
+    const vars = medida != null || columns != null
+        ? { ...(medida != null ? { "--grid-min": medida } : {}), ...(columns != null ? { "--grid-cols": String(columns) } : {}), ...style }
         : style;
-    return _jsx("div", { className: cx("grid", gap && gap !== "normal" && `grid-gap-${gap}`, columns != null && "grid-fixed", className), style: vars, ...props });
+    return _jsx("div", { className: cx("grid", gap && gap !== "normal" && `grid-gap-${gap}`, nome && min !== "md" && `grid-min-${min}`, columns != null && "grid-fixed", className), style: vars, ...props });
 }
 // ── Data Display ─────────────────────────────────────────────────────────────────────────────
 export function KPI({ label, value, trend, className, ...props }) { return _jsxs(Card, { className: cx("kpi", className), ...props, children: [_jsx("span", { className: "muted", children: label }), _jsx("strong", { children: value }), trend && _jsx("small", { children: trend })] }); }
@@ -88,7 +91,19 @@ export function Badge({ variant = "neutral", emphasis = "soft", size = "md", dot
     // botão do sino é anunciado "sino 8" e ninguém sabe o que é o 8.
     return _jsxs("span", { className: "badge-anchor", children: [children, !escondido && React.cloneElement(chip, { "aria-hidden": true })] });
 }
-export function Progress({ value, label }) { const pct = Math.max(0, Math.min(100, value)); return _jsx("div", { children: _jsx("div", { className: "progress", role: "progressbar", "aria-label": label, "aria-valuemin": 0, "aria-valuemax": 100, "aria-valuenow": pct, children: _jsx("span", { style: { width: `${pct}%` } }) }) }); }
+// AN-07 (03/10/2026). Tudo novo é acréscimo: com `value` e sem `detail` nem `tone`, a marcação é a
+// de antes, mais a classe da caixa de fora. A anatomia é a do `ProgressBar` do HeroUI 3.2.6: a
+// saída no alto à direita, o trilho embaixo, e sem `aria-valuenow` quando não há total.
+export function Progress({ value, label, detail, tone = "brand", className }) {
+    const semTotal = value == null || Number.isNaN(value);
+    const pct = semTotal ? undefined : Math.max(0, Math.min(100, value));
+    const temApoio = detail != null && detail !== false && detail !== "";
+    // Texto vai no `aria-valuetext`, e o desenho dele sai do leitor de tela para não ser lido duas
+    // vezes. Apoio que não é texto (um ícone, um link) fica onde está, para o leitor achar sozinho.
+    const emTexto = temApoio && (typeof detail === "string" || typeof detail === "number") ? String(detail) : undefined;
+    const valuetext = emTexto == null ? undefined : pct == null ? emTexto : `${pct}%, ${emTexto}`;
+    return _jsxs("div", { className: cx("progress-field", className), children: [temApoio && _jsx("div", { className: "progress-detail", "aria-hidden": emTexto != null || undefined, children: detail }), _jsx("div", { className: cx("progress", semTotal && "progress-indeterminate", tone !== "brand" && `progress-tone-${tone}`), role: "progressbar", "aria-label": label, "aria-valuemin": 0, "aria-valuemax": 100, "aria-valuenow": pct, "aria-valuetext": valuetext, children: _jsx("span", { style: pct == null ? undefined : { width: `${pct}%` } }) })] });
+}
 export function Skeleton({ className, ...props }) { return _jsx("div", { className: cx("skeleton", className), "aria-hidden": "true", ...props }); }
 // ── Identity ─────────────────────────────────────────────────────────────────────────────────
 // `React.Children` não é hook — é utilitário de leitura de `children`, e roda no servidor.

package/dist/media-client.d.ts

@@ -27,11 +27,14 @@ export interface ImageProps extends Omit<React.ImgHTMLAttributes<HTMLImageElemen
     render?: React.ReactElement;
 }
 export declare function Image({ ratio, fit, alt, className, style, render, onError, ...props }: ImageProps): React.JSX.Element;
+export type GalleryItemKind = "image" | "video";
 export interface GalleryItem {
     id: string;
     src: string;
     alt: string;
     caption?: ReactNode;
+    kind?: GalleryItemKind;
+    duration?: number;
 }
 export interface GalleryProps extends Omit<HTMLAttributes<HTMLUListElement>, "onSelect">, RefAttributes<HTMLUListElement> {
     items: GalleryItem[];
@@ -40,8 +43,14 @@ export interface GalleryProps extends Omit<HTMLAttributes<HTMLUListElement>, "on
     onSelect?: (id: string) => void;
     zoom?: boolean;
     ratio?: string;
+    selectionMode?: "single" | "multiple";
+    selectedIds?: string[];
+    onSelectionChange?: (ids: string[]) => void;
+    hasMore?: boolean;
+    loading?: boolean;
+    onReachEnd?: () => void;
 }
-export declare function Gallery({ items, label, selected, onSelect, zoom, ratio, className, ...props }: GalleryProps): React.JSX.Element;
+export declare function Gallery({ items, label, selected, onSelect, zoom, ratio, selectionMode, selectedIds, onSelectionChange, hasMore, loading, onReachEnd, className, ...props }: GalleryProps): React.JSX.Element;
 export interface CarouselProps extends Omit<HTMLAttributes<HTMLDivElement>, "children">, RefAttributes<HTMLDivElement> {
     children?: ReactNode;
     label?: string;

package/dist/media-client.js

@@ -11,6 +11,8 @@ import { IconButton } from "./actions.js";
 // A galeria AMPLIA num Dialog, e o Dialog já existe (trava do item L2). O import é para `overlays`,
 // que como este módulo mora no "resto" do DAG e não importa `media` — não há ciclo.
 import { Dialog } from "./overlays.js";
+// AN-05: o tempo do vídeo e a linha de "carregando mais" reusam peças que já existem.
+import { Badge, Spinner } from "./feedback.js";
 // MediaPlayer (Fase 5): headless sobre <video>/<audio> nativos — o MOTOR de mídia é
 // o browser; o componente só liga estado (play/tempo/buffer/volume/legenda) às
 // classes .media-* já existentes. Sem CSS estrutural novo: o vídeo preenche o
@@ -143,23 +145,45 @@ export function Image({ ratio, fit, alt, className, style, render, onError, ...p
         return _jsx("span", { className: cx("image", "image-broken", fit === "contain" && "image-contain", className), style: estilo, role: "img", "aria-label": alt, children: _jsx(Icon, { name: "image" }) });
     return elemento;
 }
-export function Gallery({ items, label, selected, onSelect, zoom, ratio = "1/1", className, ...props }) {
+export function Gallery({ items, label, selected, onSelect, zoom, ratio = "1/1", selectionMode = "single", selectedIds, onSelectionChange, hasMore, loading, onReachEnd, className, ...props }) {
     const s = useAureaStrings();
     const [ampliado, setAmpliado] = React.useState(null);
-    const interativo = !!onSelect || !!zoom;
+    const multipla = selectionMode === "multiple";
+    const interativo = !!onSelect || !!zoom || multipla;
     const aberto = items.find(i => i.id === ampliado);
-    return _jsxs(_Fragment, { children: [_jsx("ul", { className: cx("gallery", className), "aria-label": label ?? s.galleryLabel, ...props, children: items.map(i => {
+    const escolhidos = new Set(selectedIds);
+    const alternar = (id) => onSelectionChange?.(escolhidos.has(id) ? (selectedIds ?? []).filter(x => x !== id) : [...(selectedIds ?? []), id]);
+    const fimRef = React.useRef(null);
+    const avisar = React.useRef(onReachEnd);
+    avisar.current = onReachEnd;
+    React.useEffect(() => {
+        const fim = fimRef.current;
+        if (!fim || !hasMore || loading || typeof IntersectionObserver === "undefined")
+            return;
+        const obs = new IntersectionObserver(entradas => { if (entradas.some(e => e.isIntersecting))
+            avisar.current?.(); });
+        obs.observe(fim);
+        return () => obs.disconnect();
+    }, [hasMore, loading, items.length]);
+    return _jsxs(_Fragment, { children: [_jsx("ul", { className: cx("gallery", className), "aria-label": label ?? s.galleryLabel, "aria-busy": loading || undefined, ...props, children: items.map(i => {
                     // LEGENDA VISÍVEL TORNA A MINIATURA DECORATIVA, e quem exigiu isso foi o axe, não a
                     // teoria: com `alt` e legenda dizendo a mesma coisa, ele reprova `image-redundant-alt` e o
                     // leitor de tela anuncia o texto DUAS vezes seguidas. É a regra de figura com legenda do
                     // WAI — quando o texto ao lado já diz, a imagem entra com `alt=""`. O `alt` de verdade não
                     // se perde: ele continua nomeando a foto AMPLIADA, que é onde não há legenda ao lado.
-                    const miolo = _jsxs(_Fragment, { children: [_jsx(Image, { src: i.src, alt: i.caption != null ? "" : i.alt, ratio: ratio }), i.caption != null && _jsx("span", { className: "gallery-caption", children: i.caption })] });
+                    const foto = _jsx(Image, { src: i.src, alt: i.caption != null ? "" : i.alt, ratio: ratio });
+                    const video = i.kind === "video";
+                    const miolo = _jsxs(_Fragment, { children: [video
+                                ? _jsxs("span", { className: "gallery-media", children: [foto, _jsxs(Badge, { className: "gallery-duration", children: [_jsx(Icon, { name: "play", size: "sm" }), _jsx("span", { className: "sr-only", children: ` ${s.galleryVideo}, ` }), i.duration != null && clockTime(i.duration)] })] })
+                                : foto, i.caption != null && _jsx("span", { className: "gallery-caption", children: i.caption })] });
+                    const marcado = multipla ? escolhidos.has(i.id) : i.id === selected;
                     return _jsx("li", { className: "gallery-item", children: interativo
-                            ? _jsx("button", { type: "button", className: cx("gallery-tile", i.id === selected && "is-selected"), "aria-current": i.id === selected ? "true" : undefined, onClick: () => { onSelect?.(i.id); if (zoom)
-                                    setAmpliado(i.id); }, children: miolo })
+                            ? (multipla
+                                ? _jsx("button", { type: "button", className: cx("gallery-tile", marcado && "is-selected"), "aria-pressed": marcado, onClick: () => alternar(i.id), children: miolo })
+                                : _jsx("button", { type: "button", className: cx("gallery-tile", marcado && "is-selected"), "aria-current": marcado ? "true" : undefined, onClick: () => { onSelect?.(i.id); if (zoom)
+                                        setAmpliado(i.id); }, children: miolo }))
                             : miolo }, i.id);
-                }) }), zoom && _jsx(Dialog, { open: !!aberto, title: aberto ? (aberto.caption ?? aberto.alt) : "", onClose: () => setAmpliado(null), children: aberto && _jsx(Image, { src: aberto.src, alt: aberto.alt, fit: "contain" }) })] });
+                }) }), hasMore && _jsx("div", { ref: fimRef, className: "gallery-more", children: loading && _jsx(Spinner, {}) }), zoom && !multipla && _jsx(Dialog, { open: !!aberto, title: aberto ? (aberto.caption ?? aberto.alt) : "", onClose: () => setAmpliado(null), children: aberto && _jsx(Image, { src: aberto.src, alt: aberto.alt, fit: "contain" }) })] });
 }
 // ── Carousel (PLANO-1.0, item L1) ────────────────────────────────────────────────────────────
 // MARCAÇÃO, NÃO MOTOR — e a pergunta que o item mandava decidir primeiro ("se `scroll-snap` do

package/dist/navigation-client.d.ts

@@ -56,11 +56,14 @@ export interface TreeNode {
     label: ReactNode;
     icon?: IconName;
     children?: TreeNode[];
+    hasChildren?: boolean;
 }
-export declare function TreeView({ items, defaultExpandedIds, onSelect, label, className }: {
+export declare function TreeView({ items, defaultExpandedIds, onSelect, onExpand, selectedId, label, className }: {
     items: TreeNode[];
     defaultExpandedIds?: string[];
     onSelect?: (node: TreeNode) => void;
+    onExpand?: (node: TreeNode) => void | Promise<unknown>;
+    selectedId?: string | null;
     label?: string;
     className?: string;
 }): ReactElement<unknown, string | React.JSXElementConstructor<any>>;
@@ -97,6 +100,11 @@ export declare function BottomNav({ items, current, variant, indicator, width, l
     width?: BottomNavWidth;
     label?: string;
 }): React.JSX.Element;
+export interface NavListIndicator {
+    icon: IconName;
+    /** O que o sinal quer dizer ("Fixada"). Sai da tela e fica para o leitor de tela. */
+    label: string;
+}
 export interface NavListItem {
     id: string;
     label: ReactNode;
@@ -108,6 +116,13 @@ export interface NavListItem {
     disabled?: boolean;
     /** O link do roteador do app (M-01). Linha com `render` é linha com destino: leva a seta, como a com `href`. */
     render?: ReactElement;
+    /** A foto da linha (AN-04) — o mesmo formato do `ChatMessage.avatar`. Toma o lugar do `icon`. */
+    avatar?: {
+        src?: string;
+        fallback?: ReactNode;
+    };
+    /** Os sinais ao lado do `value` (AN-04): fixada, silenciada. Pequenos e apagados, cada um com nome. */
+    indicators?: NavListIndicator[];
 }
 export declare function NavList({ items, className, ...props }: HTMLAttributes<HTMLUListElement> & RefAttributes<HTMLUListElement> & {
     items: NavListItem[];

package/dist/navigation-client.js

@@ -5,18 +5,20 @@ import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-run
 // internal → system → actions → feedback → inputs → navigation → layout → data-display → resto.
 import React, { useRef } from "react";
 import { Tabs as BaseTabs } from "@base-ui/react/tabs";
+import { useDirection } from "@base-ui/react/direction-provider";
 import { Autocomplete as BaseAutocomplete } from "@base-ui/react/autocomplete";
 import { useValorResponsivo } from "./responsivo-runtime.js";
 import { cx, fundirRender, useAureaStrings, usePortalContainer } from "./internal.js";
 import { Kbd } from "./markup.js";
 import { Icon } from "./system.js";
 import { Button } from "./actions.js";
-import { Badge } from "./feedback.js";
+import { Badge, Spinner } from "./feedback.js";
 import { SearchField } from "./inputs.js";
 // `overlays` PASSOU A VIR ANTES de `navigation` no DAG (18/08/2026, MAP.md §DAG). Ele só
 // importa `internal`, `system` e `actions` — todos anteriores —, então não há ciclo: o que
 // mudou foi a ORDEM documentada, que colocava overlays no "resto" sem motivo medido.
 import { Tooltip } from "./overlays.js";
+import { Avatar } from "./identity-client.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) => {
@@ -89,6 +91,7 @@ function useSecaoEmVista(items, ligado, nav) {
     }, [ids, ligado]);
     return ligado ? atual : undefined;
 }
+const temFilhos = (node) => !!node.children?.length || !!node.hasChildren;
 function flattenVisible(nodes, expanded, level = 1, parentId, acc = []) {
     for (const node of nodes) {
         acc.push({ node, level, parentId });
@@ -97,31 +100,46 @@ function flattenVisible(nodes, expanded, level = 1, parentId, acc = []) {
     }
     return acc;
 }
-export function TreeView({ items, defaultExpandedIds, onSelect, label, className }) {
+export function TreeView({ items, defaultExpandedIds, onSelect, onExpand, selectedId, label, className }) {
     const s = useAureaStrings();
     const baseId = React.useId();
     const [expanded, setExpanded] = React.useState(() => new Set(defaultExpandedIds));
-    const [selected, setSelected] = React.useState();
+    const [selectedInterno, setSelected] = React.useState();
+    const selected = selectedId !== undefined ? (selectedId ?? undefined) : selectedInterno;
+    const [carregando, setCarregando] = React.useState(() => new Set());
     const [active, setActive] = React.useState(() => items[0]?.id);
     const rootRef = React.useRef(null);
+    const rtl = useDirection() === "rtl";
     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)
+    const marcar = (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 tirarDaCarga = (id) => setCarregando(prev => { const n = new Set(prev); n.delete(id); return n; });
+    const toggle = (node, open) => {
+        marcar(node.id, open);
+        if (!open || !onExpand)
+            return;
+        const r = onExpand(node);
+        if (node.children?.length || !r || typeof r.then !== "function")
+            return;
+        setCarregando(prev => new Set(prev).add(node.id));
+        r.then(() => tirarDaCarga(node.id), () => { tirarDaCarga(node.id); marcar(node.id, false); });
+    };
+    const select = (node) => { if (selectedId === undefined)
+        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";
+        const cur = visible[idx], hasChildren = temFilhos(cur.node), isOpen = expanded.has(cur.node.id);
+        const rtlDom = getComputedStyle(e.currentTarget).direction === "rtl";
+        const expandKey = rtlDom ? "ArrowLeft" : "ArrowRight", collapseKey = rtlDom ? "ArrowRight" : "ArrowLeft";
         switch (e.key) {
             case "ArrowDown":
                 e.preventDefault();
@@ -136,14 +154,14 @@ export function TreeView({ items, defaultExpandedIds, onSelect, label, className
             case expandKey:
                 e.preventDefault();
                 if (hasChildren && !isOpen)
-                    toggle(cur.node.id, true);
-                else if (hasChildren && isOpen)
+                    toggle(cur.node, true);
+                else if (isOpen && cur.node.children?.length)
                     focusId(cur.node.children[0].id);
                 break;
             case collapseKey:
                 e.preventDefault();
                 if (hasChildren && isOpen)
-                    toggle(cur.node.id, false);
+                    toggle(cur.node, false);
                 else if (cur.parentId)
                     focusId(cur.parentId);
                 break;
@@ -160,14 +178,14 @@ export function TreeView({ items, defaultExpandedIds, onSelect, label, className
                 e.preventDefault();
                 select(cur.node);
                 if (hasChildren)
-                    toggle(cur.node.id, !isOpen);
+                    toggle(cur.node, !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: "caret-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);
+            const hasChildren = temFilhos(node), isOpen = expanded.has(node.id), isSelected = selected === node.id, isLoading = isOpen && carregando.has(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-busy": isLoading || undefined, "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, !isOpen); }, children: [isLoading ? _jsx(Spinner, { decorative: true, className: "tree-twist" }) : hasChildren ? _jsx(Icon, { name: "caret-right", size: "sm", className: cx("tree-twist", rtl && "tree-twist-rtl") }) : _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 })] }), isOpen && !!node.children?.length && renderNodes(node.children, level + 1)] }, node.id);
         }) }));
     return renderNodes(items, 1);
 }
@@ -256,7 +274,7 @@ export function BottomNav({ items, current, variant = "floating", indicator = "n
 }
 export function NavList({ items, className, ...props }) {
     return _jsx("ul", { className: cx("nav-list", className), ...props, children: items.map(it => {
-            const miolo = _jsxs(_Fragment, { children: [it.icon && _jsx(Icon, { name: it.icon }), _jsxs("span", { className: "nav-list-text", children: [_jsx("span", { className: "nav-list-label", children: it.label }), it.description != null && _jsx("span", { className: "nav-list-description", children: it.description })] }), it.value != null && _jsx("span", { className: "nav-list-value", children: it.value }), (it.href || it.render) && _jsx(Icon, { name: "caret-right", size: "sm", className: "nav-list-chevron" })] });
+            const miolo = _jsxs(_Fragment, { children: [it.avatar ? _jsx(Avatar, { src: it.avatar.src, fallback: it.avatar.fallback }) : it.icon && _jsx(Icon, { name: it.icon }), _jsxs("span", { className: "nav-list-text", children: [_jsx("span", { className: "nav-list-label", children: it.label }), it.description != null && _jsx("span", { className: "nav-list-description", children: it.description })] }), it.indicators && it.indicators.length > 0 && _jsx("span", { className: "nav-list-indicators", children: it.indicators.map(x => _jsxs("span", { children: [_jsx(Icon, { name: x.icon, size: "sm" }), _jsx("span", { className: "sr-only", children: x.label })] }, x.label)) }), it.value != null && _jsx("span", { className: "nav-list-value", children: it.value }), (it.href || it.render) && _jsx(Icon, { name: "caret-right", size: "sm", className: "nav-list-chevron" })] });
             return _jsx("li", { children: it.render && !it.disabled
                     ? fundirRender(it.render, { className: "nav-list-row", onClick: it.onClick, children: miolo }, "a")
                     : it.href && !it.disabled

package/dist/pure.d.ts

@@ -88,6 +88,7 @@ export interface AureaStrings {
     carouselPrev: string;
     carouselNext: string;
     galleryLabel: string;
+    galleryVideo: string;
     sortableLabel: string;
     sortableHandle: string;
     sortableHelp: string;
@@ -166,12 +167,23 @@ export interface AureaStrings {
     chatLabel: string;
     chatMessage: string;
     chatSend: string;
+    chatAttach: string;
+    chatAttachments: string;
+    chatReplyTo: string;
+    chatReplyCancel: string;
+    chatEditing: string;
+    chatEditCancel: string;
+    chatSave: string;
+    chatEdited: string;
+    chatForwardedFrom: string;
     qrCode: string;
     chartLabel: string;
     copyCode: string;
     tocLabel: string;
     navigationToggle: string;
     sidebarLabel: string;
+    sidebarCollapse: string;
+    sidebarExpand: string;
     bottomNavLabel: string;
     themeToDark: string;
     themeToLight: string;

package/dist/pure.js

@@ -53,10 +53,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 = { passwordShow: "Show password", passwordHide: "Hide password", skipToContent: "Skip to content", 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", mediaEmbedOpen: "Open the video on its own site", 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", bottomNavLabel: "Main", themeToDark: "Switch to dark theme", themeToLight: "Switch to light theme", 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 = { passwordShow: "Show password", passwordHide: "Hide password", skipToContent: "Skip to content", 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", mediaEmbedOpen: "Open the video on its own site", carouselLabel: "Carousel", carouselSlide: "Slide", positionOf: "of", carouselPrev: "Previous slide", carouselNext: "Next slide", galleryLabel: "Gallery", galleryVideo: "Video", 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", chatAttach: "Attach file", chatAttachments: "Attachments", chatReplyTo: "Replying to", chatReplyCancel: "Cancel reply", chatEditing: "Editing message", chatEditCancel: "Cancel editing", chatSave: "Save", chatEdited: "edited", chatForwardedFrom: "Forwarded from", qrCode: "QR code", chartLabel: "Chart", copyCode: "Copy code", tocLabel: "On this page", navigationToggle: "Navigation", sidebarLabel: "Sidebar", sidebarCollapse: "Collapse sidebar", sidebarExpand: "Expand sidebar", bottomNavLabel: "Main", themeToDark: "Switch to dark theme", themeToLight: "Switch to light theme", 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 = { passwordShow: "Mostrar senha", passwordHide: "Ocultar senha", skipToContent: "Pular para o conteúdo", 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", mediaEmbedOpen: "Abrir o vídeo no site de origem", 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", bottomNavLabel: "Principal", themeToDark: "Mudar para o tema escuro", themeToLight: "Mudar para o tema claro", 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 = { passwordShow: "Mostrar senha", passwordHide: "Ocultar senha", skipToContent: "Pular para o conteúdo", 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", mediaEmbedOpen: "Abrir o vídeo no site de origem", carouselLabel: "Carrossel", carouselSlide: "Slide", positionOf: "de", carouselPrev: "Slide anterior", carouselNext: "Próximo slide", galleryLabel: "Galeria", galleryVideo: "Vídeo", 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", chatAttach: "Anexar arquivo", chatAttachments: "Anexos", chatReplyTo: "Respondendo a", chatReplyCancel: "Cancelar resposta", chatEditing: "Editando mensagem", chatEditCancel: "Cancelar edição", chatSave: "Salvar", chatEdited: "editada", chatForwardedFrom: "Encaminhada de", qrCode: "Código QR", chartLabel: "Gráfico", copyCode: "Copiar código", tocLabel: "Nesta página", navigationToggle: "Navegação", sidebarLabel: "Lateral", sidebarCollapse: "Recolher o menu", sidebarExpand: "Abrir o menu", bottomNavLabel: "Principal", themeToDark: "Mudar para o tema escuro", themeToLight: "Mudar para o tema claro", 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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aurea-uds/react",
-  "version": "0.17.0",
+  "version": "0.19.1",
   "description": "Os componentes React da Aurea UDS. Importe @aurea-uds/fonts/css e @aurea-uds/core/css junto.",
   "keywords": [
     "aurea",