@aurea-uds/react 0.5.0 → 0.6.0

package/dist/pure.d.ts

@@ -1,8 +1,17 @@
+import { type ReactElement } from "react";
 export declare const cx: (...v: Array<string | false | null | undefined>) => string;
+export declare function fundirRender(render: ReactElement | undefined, props: {
+    className?: string;
+} & object, padrao?: string): ReactElement;
+export type AureaTheme = "dark" | "light";
+export type AureaDensity = "compact" | "comfortable" | "spacious";
 export type UniversalState = "waiting_user" | "waiting_approval" | "waiting_dependency" | "offline" | "stale" | "partial" | "degraded";
 export declare const universalStates: readonly UniversalState[];
 export declare const stateSeverity: (state: UniversalState) => "info" | "warning";
 export interface AureaStrings {
+    passwordShow: string;
+    passwordHide: string;
+    skipToContent: string;
     close: string;
     confirmCancel: string;
     dataError: string;
@@ -168,6 +177,95 @@ export interface AureaStrings {
 export declare const defaultStrings: AureaStrings;
 export declare const ptBR: AureaStrings;
 export declare const defaultSpriteUrl = "/aurea-icons.svg";
+/** Os pontos da escala vêm de `escala.tsx`, que é GERADO da mesma leitura dos tokens que produz
+ *  as `@media`/`@container` do core. Até 22/08/2026 eles eram escritos aqui à mão, e isso era
+ *  seguro só enquanto ninguém comparava largura em JavaScript. Com o resolvedor de runtime do
+ *  `G-AXIS-06` deixou de ser: número repetido em CSS, tipo, `matchMedia` e observer são quatro
+ *  lugares para divergir. Agora há um. */
+export type { Breakpoint, ContainerBreakpoint } from "./escala.js";
+export { ESCALA, ESCALA_CONTAINER } from "./escala.js";
+import type { Breakpoint, ContainerBreakpoint } from "./escala.js";
+/** O valor, e SÓ o valor.
+ *
+ *  Todo callback de mudança do Base UI é chamado com DOIS argumentos — `(valor, eventDetails)` —
+ *  e a Aurea declara um só. Repassar o callback do consumidor cru ao motor entrega esse segundo
+ *  argumento de brinde: um objeto de evento do motor vazando por uma API pública que promete não
+ *  tê-lo. Em TypeScript isso é INVISÍVEL, porque argumento a mais nunca é erro de tipo — o que
+ *  torna o defeito silencioso e a assinatura, mentirosa.
+ *
+ *  O custo real é acoplamento: quem escrever `onValueChange={(v, e) => …}` passa a depender do
+ *  formato do evento de UMA versão do Base UI, e a Aurea deixa de poder trocar de motor sem
+ *  quebrar consumidor. O `G-API-02` já tinha corrigido isso UMA vez, no `onCheckedChange` do item
+ *  de menu, sem perguntar quem mais tinha o mesmo problema. Tinham outros SETE — medidos com
+ *  `grep -noE "on(Value|Pressed|Checked|Open|InputValue)Change=\{on[A-Za-z]+\}"` e conferidos um
+ *  a um contra o `.d.ts` do motor, que declara `eventDetails` nos sete.
+ *
+ *  Devolve `undefined` quando não há callback, para o motor continuar distinguindo "sem handler"
+ *  de "handler que não faz nada". */
+export declare function soOValor<T>(fn: ((v: T) => void) | undefined): ((v: T) => void) | undefined;
+export type Orientation = "horizontal" | "vertical";
+/** Um valor que pode ser simples, responsivo por VIEWPORT ou adaptativo por CONTAINER.
+ *
+ *  Os dois últimos são MUTUAMENTE EXCLUSIVOS por tipo (`never` no ramo oposto), e é decisão: um
+ *  valor que reage aos dois ao mesmo tempo teria precedência ambígua, e a API deixaria de dizer a
+ *  que ele responde — que é exatamente o que não pode acontecer. Quem precisa dos dois tem uma
+ *  pergunta de desenho para responder, não um default para herdar. */
+export type Responsive<T extends string> = T | {
+    base: T;
+    viewport: Partial<Record<Breakpoint, T>>;
+    container?: never;
+} | {
+    base: T;
+    container: Partial<Record<ContainerBreakpoint, T>>;
+    viewport?: never;
+};
+/** O valor BASE de um responsivo — o que vale antes de qualquer ponto da escala, e o que um
+ *  ambiente sem suporte a `@container` continua mostrando. */
+export declare function valorBase<T extends string>(v: Responsive<T> | undefined): T | undefined;
+/** `true` quando o valor pede a camada genérica (`size-*`) em vez da classe do componente. */
+export declare function ehResponsivo<T extends string>(v: Responsive<T> | undefined): boolean;
+/** As classes de um valor responsivo, para um eixo da camada compartilhada.
+ *
+ *  `eixo` é o nome da família de regras no core (hoje só `size`), e não o nome do componente: a
+ *  camada é genérica de propósito — a explosão combinatória (passos × pontos) fica lá, uma vez,
+ *  em vez de uma vez por peça.
+ *
+ *  Devolve `""` para valor simples: nesse caso o componente segue emitindo a própria classe
+ *  (`btn-sm`), que produz exatamente o mesmo computado. É o que mantém a mudança SOMATIVA — nenhum
+ *  consumidor existente muda de classe, e nenhuma baseline de pixel se mexe. */
+export declare function classesResponsivas<T extends string>(eixo: string, v: Responsive<T> | undefined): string;
+/** A PELE DE UM VALOR DE EIXO, para qualquer família e qualquer eixo.
+ *
+ *  Chamava-se `peleDeTamanho` até 22/08/2026, quando o eixo `orientation` entrou pela mesma
+ *  camada e o nome passou a mentir: a regra sempre foi "valor simples devolve a classe do
+ *  componente, valor responsivo devolve a camada genérica", e isso não tem nada de específico
+ *  de tamanho. O check 15 do validate.py lê o PRIMEIRO argumento desta função para saber que
+ *  classes o core pode legitimamente conter — se ela for renomeada de novo, ele muda junto.
+ *
+ *  Estava em `inputs.tsx` como função de módulo e servia só à família de campo. Subiu para cá ao
+ *  fechar as três famílias restantes do `G-AXIS-04` (marcação, identidade, glifo), porque a regra
+ *  é uma só e escrevê-la de novo em cada módulo é o "47 adaptações manuais independentes" que o
+ *  Victor proibiu.
+ *
+ *  `padrao` existe porque o degrau BASE não é `md` em toda família: o do Spinner é `sm`, e o core
+ *  reflete isso (`.spinner` já É o `sm`, e quem tem classe própria é o `md`). Presumir `md` como
+ *  base universal é o erro que esta atividade já cometeu duas vezes — uma no padding do campo,
+ *  outra na escala de glifo. Aqui ele é PARÂMETRO.
+ *
+ *  Valor simples devolve a classe de sempre (`input-sm`, `icon-lg`), byte por byte; valor
+ *  responsivo devolve a camada.
+ *
+ *  `eixo` é a FAMÍLIA DE CLASSES da camada responsiva, e ela não é sempre a mesma que `base`.
+ *  No `size` os degraus são valores compartilhados, então a família é uma só (`size-lg`) e o
+ *  default serve. Em `orientation` as regras são de cada componente — um `btn-group` vertical
+ *  não se parece com um `field` horizontal —, então a família é a do componente e a chamada
+ *  passa `base` de novo.
+ *
+ *  Consequência aceita: no eixo de orientação a classe do valor BASE (`btn-group-horizontal`)
+ *  é emitida sem ter regra no core, porque horizontal é o desenho de partida. Classe sem regra
+ *  não custa nada e mantém a forma da camada uniforme; o inverso — regra sem componente — é que
+ *  seria defeito, e é o que o check 15 pega. */
+export declare function peleDoEixo<T extends string>(base: string, valor: Responsive<T> | undefined, padrao?: string, eixo?: string): string | false;
 export interface GridState {
     sorting?: Array<{
         id: string;

package/dist/pure.js

@@ -14,17 +14,49 @@
 //
 // `.tsx` sem JSX de propósito: os checks 11, 19 e 26 varrem `packages/react/src/*.tsx`, e um
 // `.ts` aqui seria um arquivo que gate nenhum enxerga.
+import { cloneElement, createElement } from "react";
 export const cx = (...v) => v.filter(Boolean).join(" ");
+// ── `render`: a superfície é da Aurea, o ELEMENTO é de quem consome ───────────────────────────
+//
+// Nasceu do `G-A11Y-11`. O `Card` oferecia `variant="interactive"` — ponteiro de mão, elevação
+// no hover, e a descrição do próprio pattern dizendo *"carries the hover and the focus ring"* —
+// sobre uma `<div>` que não recebe foco nenhum. Falha de WCAG 2.1.1, e a mesma forma do
+// `G-A11Y-10`: a intenção estava escrita e a implementação a contradizia.
+//
+// A saída NÃO é `tabIndex={0}` na `<div>`. Uma superfície clicável pode prometer duas coisas
+// diferentes, e elas exigem elementos diferentes:
+//
+//   AÇÃO       clicar faz algo aqui              → <button>
+//   NAVEGAÇÃO  clicar leva a outro lugar         → <a href>
+//
+// O componente não pode adivinhar qual: escolher `<button>` sempre quebraria abrir-em-nova-aba
+// num cartão-link, e `tabIndex` numa `<div>` daria foco sem papel, sem tecla e sem nome
+// acessível — verde no gate e inútil para quem usa leitor de tela.
+//
+// Então quem sabe decide. `render` recebe o ELEMENTO e a Aurea funde a pele nele. É o idioma que
+// o `DropdownMenu`, o `Popover` e o `Combobox` já usam com a Base UI (`render={<Button/>}`), e é
+// a primeira parcela do `G-API-02` — o padrão "o motor entrega e a Aurea não passa adiante".
+export function fundirRender(render, props, padrao = "div") {
+    if (!render)
+        return createElement(padrao, props);
+    // As props do elemento de quem chama vêm DEPOIS das nossas, para que ele possa sobrescrever
+    // qualquer uma — e a classe é concatenada em vez de substituída, na mesma ordem do `cx` em
+    // todo componente da casa: a pele primeiro, o ajuste de quem usa depois.
+    const dele = (render.props ?? {});
+    return cloneElement(render, {
+        ...props, ...dele, className: cx(props.className, dele.className),
+    });
+}
 export const universalStates = ["waiting_user", "waiting_approval", "waiting_dependency", "offline", "stale", "partial", "degraded"];
 // Nenhum dos sete é FALHA: nos sete a tela AINDA SERVE, e é isso que os separa de `error`. Por
 // isso o teto de gravidade é `warning` e `danger` não aparece — quem espera é informado, quem
 // perdeu qualidade é avisado. Um `role="alert"` aqui interromperia o leitor de tela por uma
 // condição que não pede ação imediata, que é o oposto do que o papel serve.
 export const stateSeverity = (state) => state.startsWith("waiting_") ? "info" : "warning";
-export const defaultStrings = { close: "Close", confirmCancel: "Cancel", dataError: "This could not be loaded.", dataEmpty: "Nothing here yet", confirmProceed: "Continue", paginationLabel: "Pagination", previous: "Previous", next: "Next", breadcrumbLabel: "Breadcrumb", tabsLabel: "Tabs", optionsLabel: "Options", tableLabel: "Table", commandLabel: "Command palette", commandPlaceholder: "Type a command…", dismissNotification: "Dismiss notification", toolbarLabel: "Toolbar", loading: "Loading", otpDigit: "Digit", stepperLabel: "Steps", increment: "Increase", decrement: "Decrease", comboboxEmpty: "No results", comboboxClear: "Clear selection", comboboxOpen: "Open list", comboboxRemove: "Remove", comboboxLoading: "Loading…", fileDropPrompt: "Drag files here or click to select", fileAdded: "File added", fileRemoved: "File removed", fileRemove: "Remove", fileTooLarge: "File exceeds the size limit", fileWrongType: "File type not allowed", treeLabel: "Tree", notificationsLabel: "Notifications", notificationMarkAll: "Mark all as read", notificationEmpty: "No notifications", notificationUnread: "Unread", notificationNew: "new notifications", dataGridFilter: "Filter", dataGridEmpty: "No results", dataGridSelectAll: "Select all rows", dataGridSelectRow: "Select row", dataGridSelected: "selected", dataGridClearSelection: "Clear selection", dataGridBulkLabel: "Bulk actions", dataGridColumns: "Columns", dataGridResize: "Resize column", dataGridStale: "Showing data that may be out of date.", dataGridPartial: "Some rows could not be loaded. What you see is incomplete.", dataGridError: "The rows could not be loaded.", dataGridDetails: "Details", dataGridDetailPanel: "Row detail", dataGridExport: "Export", dataGridExportRows: "rows", dataGridExportFiltered: "filtered rows", dataGridExportSelected: "selected rows", mediaPlayer: "Media player", mediaPlay: "Play", mediaPause: "Pause", mediaMute: "Mute", mediaUnmute: "Unmute", mediaSeek: "Seek", mediaVolume: "Volume", mediaCaptionsShow: "Show captions", mediaCaptionsHide: "Hide captions", mediaSkipBack: "Skip back 10 seconds", mediaSkipForward: "Skip forward 10 seconds", mediaFullscreenEnter: "Enter full screen", mediaFullscreenExit: "Exit full screen", carouselLabel: "Carousel", carouselSlide: "Slide", positionOf: "of", carouselPrev: "Previous slide", carouselNext: "Next slide", galleryLabel: "Gallery", sortableLabel: "Sortable list", sortableHandle: "Reorder", sortableHelp: "Press Space to pick this up, then Arrow Up and Arrow Down to move it. Space drops it, Escape puts it back.", sortableGrabbed: "Picked up", sortableDropped: "Dropped", sortableMoved: "Moved", sortableCanceled: "Put back", blockEditorLabel: "Content blocks", blockLabel: "Block", blockRemove: "Remove block", uploadSending: "Uploading", uploadCancel: "Cancel upload", uploadRetry: "Retry upload", uploadError: "Upload failed", uploadCanceled: "Upload canceled", uploadComplete: "Upload complete", uploadPause: "Pause upload", uploadResume: "Resume upload", uploadPaused: "Paused", uploadPending: "Waiting", uploadChecksum: "Checksum", uploadChecksumBad: "The server received different bytes than the ones sent.", fileConflict: "A file with this name is already in the queue", fileReplace: "Replace", fileKeepBoth: "Keep both", fileSkip: "Skip", uploadReceipt: "Receipt", uploadReceiptCopy: "Copy receipt", agentInspector: "Agent inspector", invocationLabel: "Invocation", invocationInput: "Input", invocationOutput: "Output", taskQueueLabel: "Task queue", taskState: { queued: "Queued", running: "Running", completed: "Completed", failed: "Failed", blocked: "Blocked", paused: "Paused" }, taskPriority: { low: "Low", medium: "Medium", high: "High" }, approvalLabel: "Approval", approvalApprove: "Approve", approvalDeny: "Deny", approvalApproved: "Approved", approvalDenied: "Denied", approvalDeadline: "Decide by", approvalRisk: { low: "Low risk", medium: "Medium risk", high: "High risk" }, permissionLabel: "Tool permissions", permissionAsk: "Ask", permissionAlways: "Always", permissionNever: "Never", eventStreamLabel: "Events", traceLabel: "Trace", healthLabel: "Health", healthState: { operational: "Operational", degraded: "Degraded", down: "Down", maintenance: "Maintenance", unknown: "Unknown" }, modelUsageLabel: "Model usage", usageMetric: { tokens: "Tokens", cost: "Cost", requests: "Requests" }, costMeterLabel: "Cost", costMeterSpent: "Spent", costMeterRemaining: "left", costMeterExceeded: "Over the limit", costMeterNear: "Spending is past the soft limit.", costMeterOver: "The limit has been reached. Further calls are blocked.", memoryLabel: "Memory ledger", memoryProvenance: "Where this came from", memoryOperation: { added: "Added", updated: "Updated", recalled: "Recalled", forgotten: "Forgotten" }, memoryScope: { episodic: "Episodic", semantic: "Semantic", procedural: "Procedural" }, agentMessageLabel: "Agent messages", agentMessageTo: "to", agentMessageBroadcast: "all agents", agentMessageReason: "Why it went this way", agentMessageKind: { request: "Request", response: "Response", handoff: "Handoff", broadcast: "Broadcast", error: "Error" }, automationWhen: "When", automationThen: "Then", automationEnabled: "Enabled", automationLastRun: "Last run", automationResult: { success: "Succeeded", failure: "Failed" }, graphLabel: "Dependency graph", agentState: { idle: "Idle", thinking: "Thinking", running: "Running", paused: "Paused", error: "Error", completed: "Completed" }, codeEditor: "Code editor", chatLabel: "Conversation", chatMessage: "Message", chatSend: "Send", qrCode: "QR code", chartLabel: "Chart", copyCode: "Copy code", tocLabel: "On this page", navigationToggle: "Navigation", sidebarLabel: "Sidebar", bottomNavLabel: "Main", 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", 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", universalState: { waiting_user: "Waiting for someone to act.", waiting_approval: "Waiting for approval.", waiting_dependency: "Waiting for something else to finish.", offline: "No connection. This was loaded earlier.", stale: "This may be out of date.", partial: "Some of this could not be loaded.", degraded: "Working with reduced capability." } };
 // pt-BR preservado como locale (mesmos valores que já eram o default): passe
 // <AureaProvider strings={ptBR}> para restaurar português.
-export const ptBR = { close: "Fechar", confirmCancel: "Cancelar", dataError: "Não foi possível carregar.", dataEmpty: "Ainda não há nada aqui", confirmProceed: "Continuar", paginationLabel: "Paginação", previous: "Anterior", next: "Próxima", breadcrumbLabel: "Breadcrumb", tabsLabel: "Abas", optionsLabel: "Opções", tableLabel: "Tabela", commandLabel: "Paleta de comandos", commandPlaceholder: "Digite um comando…", dismissNotification: "Dispensar notificação", toolbarLabel: "Barra de ferramentas", loading: "Carregando", otpDigit: "Dígito", stepperLabel: "Etapas", increment: "Aumentar", decrement: "Diminuir", comboboxEmpty: "Nenhum resultado", comboboxClear: "Limpar seleção", comboboxOpen: "Abrir lista", comboboxRemove: "Remover", comboboxLoading: "Carregando…", fileDropPrompt: "Arraste arquivos aqui ou clique para selecionar", fileAdded: "Arquivo adicionado", fileRemoved: "Arquivo removido", fileRemove: "Remover", fileTooLarge: "Arquivo maior que o limite", fileWrongType: "Tipo de arquivo não aceito", treeLabel: "Árvore", notificationsLabel: "Notificações", notificationMarkAll: "Marcar todas como lidas", notificationEmpty: "Nenhuma notificação", notificationUnread: "Não lida", notificationNew: "novas notificações", dataGridFilter: "Filtrar", dataGridEmpty: "Nenhum resultado", dataGridSelectAll: "Selecionar todas as linhas", dataGridSelectRow: "Selecionar linha", dataGridSelected: "selecionadas", dataGridClearSelection: "Limpar seleção", dataGridBulkLabel: "Ações em lote", dataGridColumns: "Colunas", dataGridResize: "Redimensionar coluna", dataGridStale: "Mostrando dados que podem estar desatualizados.", dataGridPartial: "Algumas linhas não puderam ser carregadas. O que aparece está incompleto.", dataGridError: "Não foi possível carregar as linhas.", dataGridDetails: "Detalhes", dataGridDetailPanel: "Detalhe da linha", dataGridExport: "Exportar", dataGridExportRows: "linhas", dataGridExportFiltered: "linhas filtradas", dataGridExportSelected: "linhas selecionadas", mediaPlayer: "Reprodutor de mídia", mediaPlay: "Reproduzir", mediaPause: "Pausar", mediaMute: "Silenciar", mediaUnmute: "Ativar som", mediaSeek: "Posição da reprodução", mediaVolume: "Volume", mediaCaptionsShow: "Ativar legendas", mediaCaptionsHide: "Desativar legendas", mediaSkipBack: "Voltar 10 segundos", mediaSkipForward: "Avançar 10 segundos", mediaFullscreenEnter: "Tela cheia", mediaFullscreenExit: "Sair da tela cheia", carouselLabel: "Carrossel", carouselSlide: "Slide", positionOf: "de", carouselPrev: "Slide anterior", carouselNext: "Próximo slide", galleryLabel: "Galeria", sortableLabel: "Lista ordenável", sortableHandle: "Reordenar", sortableHelp: "Aperte Espaço para pegar, e as setas para cima e para baixo para mover. Espaço solta, Esc devolve ao lugar.", sortableGrabbed: "Pego", sortableDropped: "Solto", sortableMoved: "Movido", sortableCanceled: "Devolvido", blockEditorLabel: "Blocos de conteúdo", blockLabel: "Bloco", blockRemove: "Remover bloco", uploadSending: "Enviando", uploadCancel: "Cancelar envio", uploadRetry: "Tentar envio novamente", uploadError: "Falha no envio", uploadCanceled: "Envio cancelado", uploadComplete: "Envio concluído", uploadPause: "Pausar envio", uploadResume: "Retomar envio", uploadPaused: "Pausado", uploadPending: "Aguardando", uploadChecksum: "Soma de verificação", uploadChecksumBad: "O servidor recebeu bytes diferentes dos enviados.", fileConflict: "Já existe um arquivo com este nome na fila", fileReplace: "Substituir", fileKeepBoth: "Manter os dois", fileSkip: "Pular", uploadReceipt: "Recibo", uploadReceiptCopy: "Copiar recibo", agentInspector: "Inspetor do agente", invocationLabel: "Invocação", invocationInput: "Entrada", invocationOutput: "Saída", taskQueueLabel: "Fila de tarefas", taskState: { queued: "Na fila", running: "Executando", completed: "Concluída", failed: "Falhou", blocked: "Bloqueada", paused: "Pausada" }, taskPriority: { low: "Baixa", medium: "Média", high: "Alta" }, approvalLabel: "Aprovação", approvalApprove: "Aprovar", approvalDeny: "Negar", approvalApproved: "Aprovado", approvalDenied: "Negado", approvalDeadline: "Decidir até", approvalRisk: { low: "Risco baixo", medium: "Risco médio", high: "Risco alto" }, permissionLabel: "Permissões de ferramenta", permissionAsk: "Perguntar", permissionAlways: "Sempre", permissionNever: "Nunca", eventStreamLabel: "Eventos", traceLabel: "Rastro", healthLabel: "Saúde", healthState: { operational: "Operando", degraded: "Degradado", down: "Fora do ar", maintenance: "Em manutenção", unknown: "Desconhecido" }, modelUsageLabel: "Consumo por modelo", usageMetric: { tokens: "Tokens", cost: "Custo", requests: "Chamadas" }, costMeterLabel: "Custo", costMeterSpent: "Gasto", costMeterRemaining: "restantes", costMeterExceeded: "Acima do limite", costMeterNear: "O gasto passou do limite brando.", costMeterOver: "O limite foi atingido. As próximas chamadas estão bloqueadas.", memoryLabel: "Livro-razão de memória", memoryProvenance: "De onde isto veio", memoryOperation: { added: "Guardada", updated: "Atualizada", recalled: "Lembrada", forgotten: "Esquecida" }, memoryScope: { episodic: "Episódica", semantic: "Semântica", procedural: "Procedural" }, agentMessageLabel: "Recados entre agentes", agentMessageTo: "para", agentMessageBroadcast: "todos os agentes", agentMessageReason: "Por que foi por aqui", agentMessageKind: { request: "Pedido", response: "Resposta", handoff: "Passagem", broadcast: "Difusão", error: "Erro" }, automationWhen: "Quando", automationThen: "Então", automationEnabled: "Ativa", automationLastRun: "Última execução", automationResult: { success: "Concluiu", failure: "Falhou" }, graphLabel: "Grafo de dependências", agentState: { idle: "Ocioso", thinking: "Pensando", running: "Executando", paused: "Pausado", error: "Erro", completed: "Concluído" }, codeEditor: "Editor de código", chatLabel: "Conversa", chatMessage: "Mensagem", chatSend: "Enviar", qrCode: "Código QR", chartLabel: "Gráfico", copyCode: "Copiar código", tocLabel: "Nesta página", navigationToggle: "Navegação", sidebarLabel: "Lateral", bottomNavLabel: "Principal", 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", 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", 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
@@ -33,6 +65,92 @@ export const ptBR = { close: "Fechar", confirmCancel: "Cancelar", dataError: "N
 // foi corrigido nos fallbacks do catálogo e não aqui). O default segue o mesmo para quem
 // não configura nada; `Icon` aceita a prop como override local.
 export const defaultSpriteUrl = "/aurea-icons.svg";
+export { ESCALA, ESCALA_CONTAINER } from "./escala.js";
+/** O valor, e SÓ o valor.
+ *
+ *  Todo callback de mudança do Base UI é chamado com DOIS argumentos — `(valor, eventDetails)` —
+ *  e a Aurea declara um só. Repassar o callback do consumidor cru ao motor entrega esse segundo
+ *  argumento de brinde: um objeto de evento do motor vazando por uma API pública que promete não
+ *  tê-lo. Em TypeScript isso é INVISÍVEL, porque argumento a mais nunca é erro de tipo — o que
+ *  torna o defeito silencioso e a assinatura, mentirosa.
+ *
+ *  O custo real é acoplamento: quem escrever `onValueChange={(v, e) => …}` passa a depender do
+ *  formato do evento de UMA versão do Base UI, e a Aurea deixa de poder trocar de motor sem
+ *  quebrar consumidor. O `G-API-02` já tinha corrigido isso UMA vez, no `onCheckedChange` do item
+ *  de menu, sem perguntar quem mais tinha o mesmo problema. Tinham outros SETE — medidos com
+ *  `grep -noE "on(Value|Pressed|Checked|Open|InputValue)Change=\{on[A-Za-z]+\}"` e conferidos um
+ *  a um contra o `.d.ts` do motor, que declara `eventDetails` nos sete.
+ *
+ *  Devolve `undefined` quando não há callback, para o motor continuar distinguindo "sem handler"
+ *  de "handler que não faz nada". */
+export function soOValor(fn) {
+    return fn ? (v) => { fn(v); } : undefined;
+}
+/** O valor BASE de um responsivo — o que vale antes de qualquer ponto da escala, e o que um
+ *  ambiente sem suporte a `@container` continua mostrando. */
+export function valorBase(v) {
+    return v === undefined ? undefined : typeof v === "string" ? v : v.base;
+}
+/** `true` quando o valor pede a camada genérica (`size-*`) em vez da classe do componente. */
+export function ehResponsivo(v) {
+    return typeof v === "object" && v !== null;
+}
+/** As classes de um valor responsivo, para um eixo da camada compartilhada.
+ *
+ *  `eixo` é o nome da família de regras no core (hoje só `size`), e não o nome do componente: a
+ *  camada é genérica de propósito — a explosão combinatória (passos × pontos) fica lá, uma vez,
+ *  em vez de uma vez por peça.
+ *
+ *  Devolve `""` para valor simples: nesse caso o componente segue emitindo a própria classe
+ *  (`btn-sm`), que produz exatamente o mesmo computado. É o que mantém a mudança SOMATIVA — nenhum
+ *  consumidor existente muda de classe, e nenhuma baseline de pixel se mexe. */
+export function classesResponsivas(eixo, v) {
+    if (v === undefined || typeof v === "string")
+        return "";
+    const fora = [`${eixo}-${v.base}`];
+    const mapa = v.viewport ?? v.container;
+    const prefixo = v.viewport ? "vp" : "ct";
+    for (const [ponto, valor] of Object.entries(mapa ?? {})) {
+        if (valor)
+            fora.push(`${prefixo}-${ponto}:${eixo}-${valor}`);
+    }
+    return fora.join(" ");
+}
+/** A PELE DE UM VALOR DE EIXO, para qualquer família e qualquer eixo.
+ *
+ *  Chamava-se `peleDeTamanho` até 22/08/2026, quando o eixo `orientation` entrou pela mesma
+ *  camada e o nome passou a mentir: a regra sempre foi "valor simples devolve a classe do
+ *  componente, valor responsivo devolve a camada genérica", e isso não tem nada de específico
+ *  de tamanho. O check 15 do validate.py lê o PRIMEIRO argumento desta função para saber que
+ *  classes o core pode legitimamente conter — se ela for renomeada de novo, ele muda junto.
+ *
+ *  Estava em `inputs.tsx` como função de módulo e servia só à família de campo. Subiu para cá ao
+ *  fechar as três famílias restantes do `G-AXIS-04` (marcação, identidade, glifo), porque a regra
+ *  é uma só e escrevê-la de novo em cada módulo é o "47 adaptações manuais independentes" que o
+ *  Victor proibiu.
+ *
+ *  `padrao` existe porque o degrau BASE não é `md` em toda família: o do Spinner é `sm`, e o core
+ *  reflete isso (`.spinner` já É o `sm`, e quem tem classe própria é o `md`). Presumir `md` como
+ *  base universal é o erro que esta atividade já cometeu duas vezes — uma no padding do campo,
+ *  outra na escala de glifo. Aqui ele é PARÂMETRO.
+ *
+ *  Valor simples devolve a classe de sempre (`input-sm`, `icon-lg`), byte por byte; valor
+ *  responsivo devolve a camada.
+ *
+ *  `eixo` é a FAMÍLIA DE CLASSES da camada responsiva, e ela não é sempre a mesma que `base`.
+ *  No `size` os degraus são valores compartilhados, então a família é uma só (`size-lg`) e o
+ *  default serve. Em `orientation` as regras são de cada componente — um `btn-group` vertical
+ *  não se parece com um `field` horizontal —, então a família é a do componente e a chamada
+ *  passa `base` de novo.
+ *
+ *  Consequência aceita: no eixo de orientação a classe do valor BASE (`btn-group-horizontal`)
+ *  é emitida sem ter regra no core, porque horizontal é o desenho de partida. Classe sem regra
+ *  não custa nada e mantém a forma da camada uniforme; o inverso — regra sem componente — é que
+ *  seria defeito, e é o que o check 15 pega. */
+export function peleDoEixo(base, valor, padrao = "md", eixo = "size") {
+    const v = valorBase(valor);
+    return ehResponsivo(valor) ? classesResponsivas(eixo, valor) : (!!v && v !== padrao && `${base}-${v}`);
+}
 // Formato: `sort=-nome,execucoes` (o `-` é descendente) · `q=texto` · `page=2` ·
 // `f.<coluna>=valor`, repetido quando a coluna é faceta. Só entra o que está
 // ativo, então grade sem filtro nenhum deixa a URL limpa.

package/dist/qrcode.d.ts

@@ -1,9 +1,10 @@
 import React from "react";
 import { type ErrorCorrection } from "qr";
+import { type Responsive } from "./pure.js";
 export type QRCodeSize = "sm" | "md" | "lg";
 export interface QRCodeProps extends Omit<React.SVGAttributes<SVGSVGElement>, "children"> {
     value: string;
-    size?: QRCodeSize;
+    size?: Responsive<QRCodeSize>;
     ecc?: ErrorCorrection;
     quietZone?: number;
     label?: string;

package/dist/qrcode.js

@@ -8,6 +8,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 // instalar um gerador de QR — que é exatamente o achado A5 visto de perto.
 import React from "react";
 import encodeQR from "qr";
+import { peleDoEixo } from "./pure.js";
 import { cx, useAureaStrings } from "./internal.js";
 // QRCode: dado escaneável com a geometria suave da Aurea — módulos REDONDOS (dots) e
 // olhos circulares, não quadrados. Miolo de alto contraste FIXO (não segue o tema: dark
@@ -15,7 +16,7 @@ import { cx, useAureaStrings } from "./internal.js";
 // --qr-quiet no CSS. Matriz da lib `qr` (0-dep, Apache-2.0, Paul Miller); o desenho é
 // nosso. ecc default "quartile": dots cobrem menos área que quadrados, então mais
 // correção de erro preserva a escaneabilidade. ponytail: um estilo (dots) só.
-export function QRCode({ value, size = "md", ecc = "quartile", quietZone = 4, label, className, ...props }) {
+export function QRCode({ value, size, ecc = "quartile", quietZone = 4, label, className, ...props }) {
     const s = useAureaStrings();
     const name = label ?? `${s.qrCode}: ${value}`;
     const m = encodeQR(value, "raw", { ecc, border: quietZone });
@@ -31,5 +32,5 @@ export function QRCode({ value, size = "md", ecc = "quartile", quietZone = 4, la
     // olho redondo: anel externo (raio 3.5) → furo (2.5, cor do fundo) → centro (1.5).
     // os raios preservam a proporção 7:5:3 do finder, então o leitor ainda o reconhece.
     const eyeShapes = eyes.map(([ex, ey], i) => { const cx = ex + 3.5, cy = ey + 3.5; return _jsxs(React.Fragment, { children: [_jsx("circle", { className: "qr-mod", cx: cx, cy: cy, r: 3.5 }), _jsx("circle", { className: "qr-eye-gap", cx: cx, cy: cy, r: 2.5 }), _jsx("circle", { className: "qr-mod", cx: cx, cy: cy, r: 1.5 })] }, `eye${i}`); });
-    return _jsxs("svg", { className: cx("qrcode", size !== "md" && `qrcode-${size}`, className), role: "img", "aria-label": name, viewBox: `0 0 ${n} ${n}`, ...props, children: [_jsx("title", { children: name }), eyeShapes, dots] });
+    return _jsxs("svg", { className: cx("qrcode", peleDoEixo("qrcode", size), className), role: "img", "aria-label": name, viewBox: `0 0 ${n} ${n}`, ...props, children: [_jsx("title", { children: name }), eyeShapes, dots] });
 }

package/dist/responsivo-runtime.d.ts

@@ -0,0 +1,20 @@
+import { type ReactNode, type RefObject } from "react";
+import { type Responsive } from "./pure.js";
+/** O contêiner Aurea como PRIMITIVE. Declara o contêiner para o CSS (`container-scope`) e publica
+ *  o elemento para quem precisar medi-lo — os dois pelo mesmo elemento, por construção. */
+export declare function ContainerScope({ children, className, ...props }: {
+    children?: ReactNode;
+    className?: string;
+} & React.HTMLAttributes<HTMLDivElement>): import("react").JSX.Element;
+/** RESOLVE um `Responsive<T>` no valor único que vale agora.
+ *
+ *  Genérico de propósito: o `G-AXIS-06` chegou por `orientation`, mas nada aqui sabe o que é
+ *  orientação. Qualquer eixo COMPORTAMENTAL futuro usa este mesmo resolvedor — foi o que o Victor
+ *  pediu ao recusar um `useResponsiveOrientation`.
+ *
+ *  SSR/RSC: o servidor devolve sempre o valor BASE, deterministicamente. A hidratação casa com
+ *  ele — `useSyncExternalStore` usa o snapshot de servidor durante a hidratação e só então
+ *  re-renderiza com o do cliente —, e o contêiner só é medido depois da montagem, quando existe
+ *  elemento para medir. Valor simples não assina nada: nem `matchMedia`, nem observer, nem
+ *  estado que dependa de hidratação. */
+export declare function useValorResponsivo<T extends string>(valor: Responsive<T> | undefined, padrao: T, ancora?: RefObject<HTMLElement | null>): T;

package/dist/responsivo-runtime.js

@@ -0,0 +1,201 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+// RESOLUÇÃO RESPONSIVA EM RUNTIME — a infraestrutura do `G-AXIS-06`.
+//
+// POR QUE ELA EXISTE. O eixo responsivo nasceu CSS-first, e para `size` isso está certo: mudar um
+// degrau de escala não muda o que o componente FAZ. Para `orientation` em componente que navega
+// por seta, muda: o `aria-orientation` decide que par de setas move o foco, e CSS não escreve
+// atributo. Medido no banco de prova — no `Tabs` horizontal, ArrowDown/ArrowUp ficam PARADOS.
+// Desenhar em coluna por CSS e continuar anunciando `horizontal` deixaria a interface visualmente
+// vertical e semanticamente horizontal. A decisão do Victor (22/08/2026, ADR-0019) é que
+// CSS-first vale para apresentação, e resolução em runtime é permitida — e necessária — quando o
+// que está em jogo é semântica, teclado ou comportamento do motor.
+//
+// A REGRA QUE ESTE ARQUIVO OBEDECE: o valor responsivo RESOLVIDO é a única fonte de verdade. Ele
+// vai para o motor; o motor publica `data-orientation` e `aria-orientation` e ajusta o teclado; a
+// pele reage ao atributo publicado. Em nenhum momento o CSS decide a orientação por conta própria
+// e o JavaScript corre atrás para consertar o atributo — isso seria duas fontes de verdade e uma
+// janela em que visual e comportamento divergem.
+//
+// O MECANISMO MUDA COM A NATUREZA DO VALOR, e é de propósito:
+//
+//     valor simples   →  nada. Nenhum listener, nenhum observer, nenhum estado.
+//     viewport        →  matchMedia          (é o que a janela expõe, e é barato)
+//     container       →  ResizeObserver      (não há outra forma de medir um elemento)
+//
+// A API pública não muda: continua `Responsive<T>` com os mesmos três formatos.
+import { createContext, useContext, useLayoutEffect, useMemo, useRef, useState, useSyncExternalStore } from "react";
+import { ESCALA, ESCALA_CONTAINER, PONTOS_DESC, PONTOS_CONTAINER_DESC } from "./escala.js";
+import { cx, valorBase } from "./pure.js";
+// ── o contêiner Aurea, identificado sem heurística ─────────────────────────────────────────────
+//
+// O Victor foi explícito: *"não quero heurística — vamos observar o parentElement e provavelmente
+// é ele"*. O elemento que o observer mede tem de ser EXATAMENTE o que a API responsiva considera.
+//
+// Quem define o contêiner no CSS é `.container-scope { container:aurea / inline-size }`, e
+// `@container aurea` casa com o ancestral mais próximo que tenha esse nome. Então a regra do JS é
+// a MESMA REGRA, não uma parecida: `closest(".container-scope")`. Não é palpite sobre qual
+// elemento seja — é o mesmo seletor que o navegador usa para responder a `@container`.
+//
+// O contexto existe por cima disso, para o caso explícito: quem monta um `<ContainerScope>` passa
+// a referência adiante e nem precisa da busca. Os dois caminhos apontam para o mesmo elemento, e
+// há teste cobrando isso.
+const ContainerAurea = createContext(null);
+/** O contêiner Aurea como PRIMITIVE. Declara o contêiner para o CSS (`container-scope`) e publica
+ *  o elemento para quem precisar medi-lo — os dois pelo mesmo elemento, por construção. */
+export function ContainerScope({ children, className, ...props }) {
+    const ref = useRef(null);
+    return _jsx(ContainerAurea.Provider, { value: ref, children: _jsx("div", { ref: ref, className: cx("container-scope", className), ...props, children: children }) });
+}
+// ── matchMedia compartilhado ───────────────────────────────────────────────────────────────────
+// Um `MediaQueryList` por PONTO, não por componente. Sete pontos no total, para a aplicação
+// inteira, e o navegador já avalia essas media queries de qualquer jeito por causa do CSS.
+//
+// AUSÊNCIA das APIs não pode quebrar: `jsdom` não implementa `matchMedia` nem `ResizeObserver`, e
+// consumidor que testa em jsdom é caso comum, não exótico. Sem essas APIs o valor fica no BASE —
+// que é o mesmo comportamento do servidor, e portanto o degradar correto: a interface aparece
+// coerente, só não adapta. Quebrar seria transformar uma limitação de ambiente em erro de runtime.
+const temMatchMedia = () => typeof window !== "undefined" && typeof window.matchMedia === "function";
+const mqls = new Map();
+const mql = (px) => {
+    const q = `(min-width:${px}px)`;
+    let m = mqls.get(q);
+    if (!m) {
+        m = window.matchMedia(q);
+        mqls.set(q, m);
+    }
+    return m;
+};
+// UM ouvinte real por ponto para a APLICAÇÃO INTEIRA, com um conjunto de interessados por cima.
+// `useSyncExternalStore` chama `subscribe` por componente, então a versão ingênua registrava sete
+// ouvintes por componente responsivo — linear no número de componentes, e medido: 7 para um,
+// 70 para dez. Aqui é 7 para sempre, e o teste de escala cobra isso.
+const interessadosVp = new Set();
+let ouvindoVp = false;
+const avisarTodos = () => { for (const f of interessadosVp)
+    f(); };
+function assinarViewport(avisar) {
+    if (!temMatchMedia())
+        return () => { };
+    interessadosVp.add(avisar);
+    if (!ouvindoVp) {
+        for (const px of Object.values(ESCALA))
+            mql(px).addEventListener("change", avisarTodos);
+        ouvindoVp = true;
+    }
+    return () => { interessadosVp.delete(avisar); };
+}
+/** O ponto mais alto que a janela alcança, ou `null` abaixo do primeiro. `min-width` quer dizer
+ *  que o ÚLTIMO ponto atingido vence, então a varredura é do maior para o menor. */
+function pontoDaViewport() {
+    if (!temMatchMedia())
+        return null;
+    for (const p of PONTOS_DESC)
+        if (mql(ESCALA[p]).matches)
+            return p;
+    return null;
+}
+// ── ResizeObserver compartilhado ───────────────────────────────────────────────────────────────
+// UM observer para o documento inteiro, com um registro de callbacks por elemento — e não um
+// observer por componente. Não é infraestrutura especulativa: é a forma mais simples que não
+// multiplica objetos, e o custo real está medido em `audit/activity-2/20-G-AXIS-06-CUSTO.md`.
+const inscritos = new Map();
+let observer = null;
+function observarElemento(el, avisar) {
+    if (typeof ResizeObserver === "undefined")
+        return () => { };
+    if (!observer) {
+        observer = new ResizeObserver((entradas) => {
+            for (const e of entradas) {
+                // `borderBoxSize` é o que `@container ... (min-width)` consulta — a caixa de conteúdo
+                // daria outro número em qualquer elemento com padding, e as duas respostas divergiriam
+                // justamente onde o Victor exigiu que fossem a mesma.
+                const largura = e.borderBoxSize?.[0]?.inlineSize ?? e.contentRect.width;
+                for (const f of inscritos.get(e.target) ?? [])
+                    f(largura);
+            }
+        });
+    }
+    let jogo = inscritos.get(el);
+    if (!jogo) {
+        jogo = new Set();
+        inscritos.set(el, jogo);
+        observer.observe(el);
+    }
+    jogo.add(avisar);
+    return () => {
+        jogo.delete(avisar);
+        if (jogo.size === 0) {
+            inscritos.delete(el);
+            observer.unobserve(el);
+        }
+    };
+}
+function pontoDaLargura(largura) {
+    for (const p of PONTOS_CONTAINER_DESC)
+        if (largura >= ESCALA_CONTAINER[p])
+            return p;
+    return null;
+}
+// ── a resolução ────────────────────────────────────────────────────────────────────────────────
+/** O valor de um mapa de pontos, dado o ponto alcançado. Percorre do alcançado para baixo e
+ *  devolve o primeiro que o mapa declara — um mapa esparso (`{md:"x"}`) continua valendo em `lg`,
+ *  que é a semântica de `min-width` e a mesma da camada CSS. */
+function doMapa(mapa, alcancado, ordemDesc, base) {
+    if (!alcancado)
+        return base;
+    let vendo = false;
+    for (const p of ordemDesc) {
+        if (p === alcancado)
+            vendo = true;
+        if (vendo && mapa[p] !== undefined)
+            return mapa[p];
+    }
+    return base;
+}
+const semAssinatura = () => () => { };
+/** RESOLVE um `Responsive<T>` no valor único que vale agora.
+ *
+ *  Genérico de propósito: o `G-AXIS-06` chegou por `orientation`, mas nada aqui sabe o que é
+ *  orientação. Qualquer eixo COMPORTAMENTAL futuro usa este mesmo resolvedor — foi o que o Victor
+ *  pediu ao recusar um `useResponsiveOrientation`.
+ *
+ *  SSR/RSC: o servidor devolve sempre o valor BASE, deterministicamente. A hidratação casa com
+ *  ele — `useSyncExternalStore` usa o snapshot de servidor durante a hidratação e só então
+ *  re-renderiza com o do cliente —, e o contêiner só é medido depois da montagem, quando existe
+ *  elemento para medir. Valor simples não assina nada: nem `matchMedia`, nem observer, nem
+ *  estado que dependa de hidratação. */
+export function useValorResponsivo(valor, padrao, ancora) {
+    const base = (valorBase(valor) ?? padrao);
+    const porViewport = typeof valor === "object" && valor !== null && valor.viewport ? valor.viewport : null;
+    const porContainer = typeof valor === "object" && valor !== null && valor.container ? valor.container : null;
+    // VIEWPORT — `useSyncExternalStore` porque a fonte é externa e síncrona, e porque ele é o único
+    // jeito de a hidratação usar o valor de servidor sem aviso e ainda assim corrigir no mesmo
+    // commit seguinte, em vez de esperar um efeito.
+    const pontoVp = useSyncExternalStore(porViewport ? assinarViewport : semAssinatura, () => (porViewport ? pontoDaViewport() : null), () => null);
+    // CONTAINER — o elemento só existe depois da montagem, então aqui é estado + efeito de layout.
+    // O primeiro render do cliente devolve o base, igual ao do servidor; a medição entra em
+    // seguida. Foi por isso que não usei `useSyncExternalStore` também aqui: não há snapshot
+    // síncrono antes de haver elemento.
+    const doContexto = useContext(ContainerAurea);
+    const [largura, setLargura] = useState(null);
+    useLayoutEffect(() => {
+        if (!porContainer)
+            return;
+        // A ÂNCORA é o elemento raiz do próprio componente, e ela é obrigatória para o caminho de
+        // busca: sem um nó no documento não há de onde subir. O contexto vem primeiro quando existe,
+        // porque aí o contêiner é explícito e não precisa ser procurado.
+        const el = doContexto?.current ?? ancora?.current?.closest(".container-scope") ?? null;
+        if (!el)
+            return;
+        setLargura(el.getBoundingClientRect().width);
+        return observarElemento(el, setLargura);
+    }, [porContainer, doContexto, ancora]);
+    return useMemo(() => {
+        if (porViewport)
+            return doMapa(porViewport, pontoVp, PONTOS_DESC, base);
+        if (porContainer)
+            return doMapa(porContainer, largura === null ? null : pontoDaLargura(largura), PONTOS_CONTAINER_DESC, base);
+        return base;
+    }, [porViewport, porContainer, pontoVp, largura, base]);
+}

package/dist/system.d.ts

@@ -1,16 +1,23 @@
 import React, { type ReactNode } from "react";
-import { type AureaStrings } from "./internal.js";
-export declare function AureaProvider({ children, strings, direction, spriteUrl, portalContainer }: {
+import { type Responsive } from "./pure.js";
+import { type AureaStrings, type AureaTheme, type AureaDensity } from "./internal.js";
+export declare function AureaProvider({ children, strings, direction, spriteUrl, portalContainer, theme, defaultTheme, onThemeChange, density, defaultDensity, onDensityChange }: {
     children: ReactNode;
     strings?: Partial<AureaStrings>;
     direction?: "ltr" | "rtl";
     spriteUrl?: string;
     portalContainer?: HTMLElement | null;
+    theme?: AureaTheme;
+    defaultTheme?: AureaTheme;
+    onThemeChange?: (theme: AureaTheme) => void;
+    density?: AureaDensity;
+    defaultDensity?: AureaDensity;
+    onDensityChange?: (density: AureaDensity) => void;
 }): React.JSX.Element;
 export type AureaToastType = "info" | "success" | "warning" | "danger";
 export declare const useToast: () => import("@base-ui/react").UseToastManagerReturnValue<any>;
 export type AureaThemeName = "dark" | "light";
-export type AureaDensity = "compact" | "comfortable" | "spacious";
+export type { AureaDensity };
 export declare function useAureaTheme(): {
     theme: AureaThemeName | null;
     density: AureaDensity | null;
@@ -19,9 +26,10 @@ export declare function useAureaTheme(): {
     toggleTheme: () => void;
 };
 export type IconName = string;
+export type IconSize = "sm" | "md" | "lg" | "xl";
 export interface IconProps extends React.SVGAttributes<SVGSVGElement> {
     name: IconName;
     spriteUrl?: string;
-    size?: "sm" | "md" | "lg" | "xl";
+    size?: Responsive<IconSize>;
 }
 export declare function Icon({ name, spriteUrl, size, className, ...props }: IconProps): React.JSX.Element;