@softize/opus 15.2.2 → 16.1.0

package/src/ui/components/primitives/drawer.tsx

@@ -6,27 +6,19 @@ import { cn } from "../../lib/cn.ts";
 import { focusRing } from "./control.ts";
 import { overlayClasses } from "./dialog.tsx";
 
-function Drawer({
-  ...props
-}: React.ComponentProps<typeof DrawerPrimitive.Root>) {
+function Drawer({ ...props }: React.ComponentProps<typeof DrawerPrimitive.Root>) {
   return <DrawerPrimitive.Root data-slot="drawer" {...props} />;
 }
 
-function DrawerTrigger({
-  ...props
-}: React.ComponentProps<typeof DrawerPrimitive.Trigger>) {
+function DrawerTrigger({ ...props }: React.ComponentProps<typeof DrawerPrimitive.Trigger>) {
   return <DrawerPrimitive.Trigger data-slot="drawer-trigger" {...props} />;
 }
 
-function DrawerClose({
-  ...props
-}: React.ComponentProps<typeof DrawerPrimitive.Close>) {
+function DrawerClose({ ...props }: React.ComponentProps<typeof DrawerPrimitive.Close>) {
   return <DrawerPrimitive.Close data-slot="drawer-close" {...props} />;
 }
 
-function DrawerPortal({
-  ...props
-}: React.ComponentProps<typeof DrawerPrimitive.Portal>) {
+function DrawerPortal({ ...props }: React.ComponentProps<typeof DrawerPrimitive.Portal>) {
   return <DrawerPrimitive.Portal data-slot="drawer-portal" {...props} />;
 }
 
@@ -37,10 +29,7 @@ function DrawerOverlay({
   return (
     <DrawerPrimitive.Overlay
       data-slot="drawer-overlay"
-      className={cn(
-        overlayClasses,
-        className,
-      )}
+      className={cn(overlayClasses, className)}
       {...props}
     />
   );
@@ -51,6 +40,7 @@ function DrawerContent({
   children,
   side = "right",
   showCloseButton = true,
+  "aria-describedby": ariaDescribedBy,
   ...props
 }: React.ComponentProps<typeof DrawerPrimitive.Content> & {
   side?: "top" | "right" | "bottom" | "left";
@@ -73,6 +63,7 @@ function DrawerContent({
             "inset-x-0 bottom-0 h-auto border-t data-[state=closed]:slide-out-to-bottom data-[state=open]:slide-in-from-bottom",
           className,
         )}
+        aria-describedby={ariaDescribedBy}
         {...props}
       >
         {children}
@@ -125,10 +116,7 @@ function DrawerFooter({ className, ...props }: React.ComponentProps<"div">) {
   );
 }
 
-function DrawerTitle({
-  className,
-  ...props
-}: React.ComponentProps<typeof DrawerPrimitive.Title>) {
+function DrawerTitle({ className, ...props }: React.ComponentProps<typeof DrawerPrimitive.Title>) {
   return (
     <DrawerPrimitive.Title
       data-slot="drawer-title"
@@ -138,19 +126,6 @@ function DrawerTitle({
   );
 }
 
-function DrawerDescription({
-  className,
-  ...props
-}: React.ComponentProps<typeof DrawerPrimitive.Description>) {
-  return (
-    <DrawerPrimitive.Description
-      data-slot="drawer-description"
-      className={cn("text-sm text-muted-foreground", className)}
-      {...props}
-    />
-  );
-}
-
 export {
   Drawer,
   DrawerTrigger,
@@ -160,5 +135,4 @@ export {
   DrawerBody,
   DrawerFooter,
   DrawerTitle,
-  DrawerDescription,
 };

package/src/ui/docs/content/action-form-dialog.md

@@ -5,28 +5,30 @@ para outra página. O consumidor controla `open`; depois de uma execução bem-s
 fecha o modal. O cabeçalho e o rodapé permanecem visíveis enquanto os campos podem rolar.
 
 ```tsx preview
-const [open, setOpen] = useState(false)
+const [open, setOpen] = useState(false);
 
 render(
   <DocBrowserActionProvider>
-    <Button onClick={() => setOpen(true)}><Plus /> Novo workspace</Button>
+    <Button onClick={() => setOpen(true)}>
+      <Plus /> Novo workspace
+    </Button>
     <ActionFormDialog
       open={open}
       onOpenChange={setOpen}
       title="Novo workspace"
-      description="O workspace agrupa os repositórios e agentes do cliente."
       action={docWorkspaceCreate}
       submitLabel="Criar workspace"
     />
   </DocBrowserActionProvider>,
-)
+);
 ```
 
 ## Propriedades de ActionFormDialog
 
-| Propriedade | Tipo | Padrão | Descrição |
-|---|---|---|---|
-| `open / onOpenChange` | `boolean / (open: boolean) => void` | | Estado controlado do modal. `onOpenChange(false)` é chamado no sucesso e ao cancelar. |
-| `title / description` | `string` | | Conteúdo do cabeçalho; `description` é opcional. |
-| `submitLabel` | `string` | `'Salvar'` | Resultado da ação principal. Em criação, informe `Criar {recurso}`; em edição, `Salvar alterações`. |
-| `…ActionFormProps` | `action, defaultValues, onSuccess, fieldOptions…` | | Demais propriedades repassadas ao `ActionForm` interno. |
+| Propriedade           | Tipo                                              | Padrão     | Descrição                                                                                           |
+| --------------------- | ------------------------------------------------- | ---------- | --------------------------------------------------------------------------------------------------- |
+| `open / onOpenChange` | `boolean / (open: boolean) => void`               |            | Estado controlado do modal. `onOpenChange(false)` é chamado no sucesso e ao cancelar.               |
+| `title`               | `string`                                          |            | Nome da tarefa exibido no cabeçalho.                                                                |
+| `intro`               | `ReactNode`                                       |            | Contexto relevante no início do corpo, como texto ou `Alert`.                                       |
+| `submitLabel`         | `string`                                          | `'Salvar'` | Resultado da ação principal. Em criação, informe `Criar {recurso}`; em edição, `Salvar alterações`. |
+| `…ActionFormProps`    | `action, defaultValues, onSuccess, fieldOptions…` |            | Demais propriedades repassadas ao `ActionForm` interno.                                             |

package/src/ui/docs/content/action-list-dialog.md

@@ -6,7 +6,7 @@ outras actions. O consumidor compõe os itens por `children`; o modal mantém os
 ações.
 
 ```tsx preview col
-const [open, setOpen] = useState(false)
+const [open, setOpen] = useState(false);
 
 render(
   <DocBrowserActionProvider>
@@ -17,7 +17,6 @@ render(
       open={open}
       onOpenChange={setOpen}
       title="Workspaces"
-      description="Back-office"
       actions={
         <Button size="sm" variant="outline">
           <Plus /> Workspace
@@ -28,17 +27,22 @@ render(
       {(workspaces) => (
         <div className="space-y-2">
           {workspaces.map((w) => (
-            <div key={w.id} className="flex items-center gap-2 rounded-md border border-border p-3">
+            <div
+              key={w.id}
+              className="flex items-center gap-2 rounded-md border border-border p-3"
+            >
               <span className="text-sm font-semibold">{w.name}</span>
               <DictionaryValue dict={docWorkspaceStatus} value={w.status} />
-              <span className="ml-auto text-xs text-muted-foreground">{w.agents} agentes</span>
+              <span className="ml-auto text-xs text-muted-foreground">
+                {w.agents} agentes
+              </span>
             </div>
           ))}
         </div>
       )}
     </ActionListDialog>
   </DocBrowserActionProvider>,
-)
+);
 ```
 
 ## Estado adicional do consumidor
@@ -59,15 +63,16 @@ corpo do modal.
 
 ## Propriedades de ActionListDialog
 
-| Propriedade | Tipo | Padrão | Descrição |
-|---|---|---|---|
-| `action / input` | `ListAction / TInput` | | O contrato e os filtros — mudou o input, re-busca; `invalidates` de forms/triggers refaz sozinho. |
-| `open / onOpenChange` | `boolean / (open) => void` | | Controle do modal — de quem orquestra. |
-| `title / description` | `string` | | O DialogHeader fixo (em geral, o que é a lista e de quem). |
-| `children` | `(items, refetch) => ReactNode` | | O layout dos itens (cards/linhas) — os estados já saíram daqui. |
-| `note` | `ReactNode \| (items) => ReactNode` | `"N no total"` | Nota à esquerda da toolbar — o default é derivado dos itens. |
-| `actions` | `ReactNode` | | Ação à direita da toolbar — em geral o botão de criar. |
-| `empty` | `(items) => boolean` | `items.length === 0` | Sobrepõe o vazio derivado. |
-| `loading` | `boolean` | | Carga extra agregada à do fetch (query irmã). |
-| `emptyMessage / errorMessage / retryLabel` | `string` | | Textos dos estados; `retryLabel` nomeia a ação somente com ícone e seu tooltip. |
-| `className` | `string` | `sm:max-w-3xl` | Largura do DialogContent. |
+| Propriedade                                | Tipo                                | Padrão               | Descrição                                                                                         |
+| ------------------------------------------ | ----------------------------------- | -------------------- | ------------------------------------------------------------------------------------------------- |
+| `action / input`                           | `ListAction / TInput`               |                      | O contrato e os filtros — mudou o input, re-busca; `invalidates` de forms/triggers refaz sozinho. |
+| `open / onOpenChange`                      | `boolean / (open) => void`          |                      | Controle do modal — de quem orquestra.                                                            |
+| `title`                                    | `string`                            |                      | Nome da lista exibido no cabeçalho fixo.                                                          |
+| `intro`                                    | `ReactNode`                         |                      | Contexto relevante no início do corpo, como texto ou `Alert`.                                     |
+| `children`                                 | `(items, refetch) => ReactNode`     |                      | O layout dos itens (cards/linhas) — os estados já saíram daqui.                                   |
+| `note`                                     | `ReactNode \| (items) => ReactNode` | `"N no total"`       | Nota à esquerda da toolbar — o default é derivado dos itens.                                      |
+| `actions`                                  | `ReactNode`                         |                      | Ação à direita da toolbar — em geral o botão de criar.                                            |
+| `empty`                                    | `(items) => boolean`                | `items.length === 0` | Sobrepõe o vazio derivado.                                                                        |
+| `loading`                                  | `boolean`                           |                      | Carga extra agregada à do fetch (query irmã).                                                     |
+| `emptyMessage / errorMessage / retryLabel` | `string`                            |                      | Textos dos estados; `retryLabel` nomeia a ação somente com ícone e seu tooltip.                   |
+| `className`                                | `string`                            | `sm:max-w-3xl`       | Largura do DialogContent.                                                                         |

package/src/ui/docs/content/button.md

@@ -21,16 +21,16 @@ altura da linha; os `icon-*` são quadrados para botões só de ícone, que exig
 há texto visível. O glifo dentro do controle acompanha o tamanho (0.875rem em `xs` e `sm`, 1rem em
 `default`, 1.25rem em `lg`), a menos que o ícone traga um `size-*` próprio.
 
-| Nome | Medida | Uso |
-|---|---|---|
-| `xs` | 1.5rem | Ação dentro de um campo (`InputGroupButton`). |
-| `sm` | 2rem | Toolbar e cabeçalho densos, ao lado de `Select` e `Tabs` `sm`. |
-| `default` | 2.25rem | A linha padrão, a mesma de `Input`. |
-| `lg` | 2.5rem | Chamada principal com mais área de toque. |
-| `icon-xs` | 1.5rem | Ação só de ícone dentro de um campo ou de uma linha densa; é o quadrado de `ActionTrigger` com `icon`. |
+| Nome      | Medida  | Uso                                                                                                                              |
+| --------- | ------- | -------------------------------------------------------------------------------------------------------------------------------- |
+| `xs`      | 1.5rem  | Ação dentro de um campo (`InputGroupButton`).                                                                                    |
+| `sm`      | 2rem    | Toolbar e cabeçalho densos, ao lado de `Select` e `Tabs` `sm`.                                                                   |
+| `default` | 2.25rem | A linha padrão, a mesma de `Input`.                                                                                              |
+| `lg`      | 2.5rem  | Chamada principal com mais área de toque.                                                                                        |
+| `icon-xs` | 1.5rem  | Ação só de ícone dentro de um campo ou de uma linha densa; é o quadrado de `ActionTrigger` com `icon`.                           |
 | `icon-sm` | 1.75rem | Ação só de ícone em composições compactas que precisam de mais presença; também é o quadrado das setas do pager de `ActionList`. |
-| `icon` | 2.25rem | Ação só de ícone na linha padrão. |
-| `icon-lg` | 2.5rem | Ação só de ícone ao lado de um `lg`. |
+| `icon`    | 2.25rem | Ação só de ícone na linha padrão.                                                                                                |
+| `icon-lg` | 2.5rem  | Ação só de ícone ao lado de um `lg`.                                                                                             |
 
 ```tsx preview
 <Button size="xs">Mínimo</Button>
@@ -63,20 +63,22 @@ buttonVariants serve para o caso sem filho único.
 
 ```tsx preview
 <Button asChild variant="outline">
-  <a href="#" onClick={(e) => e.preventDefault()}>Abrir documentação</a>
+  <a href="#" onClick={(e) => e.preventDefault()}>
+    Abrir documentação
+  </a>
 </Button>
 ```
 
 ## Propriedades de Button
 
-| Propriedade | Tipo | Padrão | Descrição |
-|---|---|---|---|
-| `context` | `'neutral' \| 'primary' \| 'danger'` | `'primary'` | A hierarquia ou o risco comunicado pela ação. |
-| `variant` | `'solid' \| 'subtle' \| 'outline' \| 'ghost' \| 'link'` | `'solid'` | O tratamento visual aplicado ao contexto. |
-| `size` | `'xs' \| 'sm' \| 'default' \| 'lg' \| 'icon-xs' \| 'icon-sm' \| 'icon' \| 'icon-lg'` | `'default'` | A medida na escala única dos controles (tabela acima). Os `icon-*` são quadrados para botões só de ícone, com `aria-label`. |
-| `asChild` | `boolean` | `false` | Renderiza como o filho (Radix Slot) em vez de `<button>` — para âncoras e afins. |
-| `busy` | `boolean` | `false` | Ação em andamento (depois do clique): mostra Spinner + desabilita. Não é "carregando" de conteúdo (que é Spinner/Skeleton em um nível de página). |
-| `icon` | `React.ReactNode` | | Ícone à esquerda, como nó (ex.: `icon={<Plus />}`); o glifo segue o `size`. No busy é trocado pelo Spinner — não soma. |
+| Propriedade | Tipo                                                                                 | Padrão      | Descrição                                                                                                                                         |
+| ----------- | ------------------------------------------------------------------------------------ | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `context`   | `'neutral' \| 'primary' \| 'danger'`                                                 | `'primary'` | A hierarquia ou o risco comunicado pela ação.                                                                                                     |
+| `variant`   | `'solid' \| 'subtle' \| 'outline' \| 'ghost' \| 'link'`                              | `'solid'`   | O tratamento visual aplicado ao contexto.                                                                                                         |
+| `size`      | `'xs' \| 'sm' \| 'default' \| 'lg' \| 'icon-xs' \| 'icon-sm' \| 'icon' \| 'icon-lg'` | `'default'` | A medida na escala única dos controles (tabela acima). Os `icon-*` são quadrados para botões só de ícone, com `aria-label`.                       |
+| `asChild`   | `boolean`                                                                            | `false`     | Renderiza como o filho (Radix Slot) em vez de `<button>` — para âncoras e afins.                                                                  |
+| `busy`      | `boolean`                                                                            | `false`     | Ação em andamento (depois do clique): mostra Spinner + desabilita. Não é "carregando" de conteúdo (que é Spinner/Skeleton em um nível de página). |
+| `icon`      | `React.ReactNode`                                                                    |             | Ícone à esquerda, como nó (ex.: `icon={<Plus />}`); o glifo segue o `size`. No busy é trocado pelo Spinner — não soma.                            |
 
 ## ButtonGroup
 
@@ -100,9 +102,15 @@ conectar bordas. Esse modo atende ações icon-only em barras e linhas de listag
 
 ```tsx preview
 <ButtonGroup mode="spaced">
-  <Button variant="ghost" size="icon" aria-label="Recarregar"><RotateCw /></Button>
-  <Button variant="ghost" size="icon" aria-label="Exibição"><SlidersHorizontal /></Button>
-  <Button context="primary" size="icon" aria-label="Novo item"><Plus /></Button>
+  <Button variant="ghost" size="icon" aria-label="Recarregar">
+    <RotateCw />
+  </Button>
+  <Button variant="ghost" size="icon" aria-label="Exibição">
+    <SlidersHorizontal />
+  </Button>
+  <Button context="primary" size="icon" aria-label="Novo item">
+    <Plus />
+  </Button>
 </ButtonGroup>
 ```
 
@@ -132,7 +140,9 @@ semântica de outro elemento, como `label`.
     <GitBranch />
     empresa-x-api
   </ButtonGroupText>
-  <Button variant="outline" icon={<RotateCw />}>Sincronizar</Button>
+  <Button variant="outline" icon={<RotateCw />}>
+    Sincronizar
+  </Button>
 </ButtonGroup>
 ```
 
@@ -142,28 +152,35 @@ semântica de outro elemento, como `label`.
 
 ```tsx preview col-start
 <ButtonGroup orientation="vertical">
-  <Button variant="outline" size="icon" aria-label="Rodar sessão"><Play /></Button>
-  <Button variant="outline" size="icon" aria-label="Pausar sessão"><Pause /></Button>
-  <Button variant="outline" size="icon" aria-label="Reiniciar sessão"><RotateCw /></Button>
+  <Button variant="outline" size="icon" aria-label="Rodar sessão">
+    <Play />
+  </Button>
+  <Button variant="outline" size="icon" aria-label="Pausar sessão">
+    <Pause />
+  </Button>
+  <Button variant="outline" size="icon" aria-label="Reiniciar sessão">
+    <RotateCw />
+  </Button>
 </ButtonGroup>
 ```
 
 ### Propriedades de ButtonGroup
 
-| Propriedade | Tipo | Padrão | Descrição |
-|---|---|---|---|
-| `orientation` | `'horizontal' \| 'vertical'` | `'horizontal'` | Direção do bloco e do colapso das bordas. |
-| `mode` | `'connected' \| 'spaced'` | `'connected'` | Conecta as bordas dos controles ou preserva cada controle com intervalo compacto. |
-| `shape` | `'default' \| 'pill'` | `'default'` | Geometria das extremidades externas do grupo. |
+| Propriedade    | Tipo                         | Padrão         | Descrição                                                                                 |
+| -------------- | ---------------------------- | -------------- | ----------------------------------------------------------------------------------------- |
+| `orientation`  | `'horizontal' \| 'vertical'` | `'horizontal'` | Direção do bloco e do colapso das bordas.                                                 |
+| `mode`         | `'connected' \| 'spaced'`    | `'connected'`  | Conecta as bordas dos controles ou preserva cada controle com intervalo compacto.         |
+| `shape`        | `'default' \| 'pill'`        | `'default'`    | Geometria das extremidades externas do grupo.                                             |
+| `distribution` | `'content' \| 'equal'`       | `'content'`    | Mantém a largura do conteúdo ou divide igualmente o espaço disponível entre os controles. |
 
 ### Propriedades de ButtonGroupSeparator
 
-| Propriedade | Tipo | Padrão | Descrição |
-|---|---|---|---|
+| Propriedade   | Tipo                         | Padrão       | Descrição                                                     |
+| ------------- | ---------------------------- | ------------ | ------------------------------------------------------------- |
 | `orientation` | `'horizontal' \| 'vertical'` | `'vertical'` | Direção do traço divisor; use vertical em grupos horizontais. |
 
 ### Propriedades de ButtonGroupText
 
-| Propriedade | Tipo | Padrão | Descrição |
-|---|---|---|---|
-| `asChild` | `boolean` | `false` | Renderiza como o filho para assumir outra semântica sem perder o estilo. |
+| Propriedade | Tipo      | Padrão  | Descrição                                                                |
+| ----------- | --------- | ------- | ------------------------------------------------------------------------ |
+| `asChild`   | `boolean` | `false` | Renderiza como o filho para assumir outra semântica sem perder o estilo. |

package/src/ui/docs/content/communication.md

@@ -16,14 +16,14 @@ muda apenas quando o produto ou os componentes Opus mudam.
 
 ## Língua e termos no Opus
 
-| Camada | Convenção local |
-|---|---|
-| Identificadores de código, arquivos, diretórios e domínios | Inglês |
-| Nomes de action e rota | Inglês, no formato `resource.verb` |
-| Colunas e tabelas de banco | Inglês, em `snake_case` |
-| Enums, status e chaves de dicionário | Inglês, inclusive em exemplos e fixtures (`active`, não `ativo`) |
-| Texto de UI visível | pt-BR; o contrato fornece o label humano para valores técnicos |
-| Comentários e documentação deste repositório | pt-BR |
+| Camada                                                     | Convenção local                                                  |
+| ---------------------------------------------------------- | ---------------------------------------------------------------- |
+| Identificadores de código, arquivos, diretórios e domínios | Inglês                                                           |
+| Nomes de action e rota                                     | Inglês, no formato `resource.verb`                               |
+| Colunas e tabelas de banco                                 | Inglês, em `snake_case`                                          |
+| Enums, status e chaves de dicionário                       | Inglês, inclusive em exemplos e fixtures (`active`, não `ativo`) |
+| Texto de UI visível                                        | pt-BR; o contrato fornece o label humano para valores técnicos   |
+| Comentários e documentação deste repositório               | pt-BR                                                            |
 
 `Opus` e `Softize` são nomes próprios em prosa (`o Opus`, `a Softize`). Tokens técnicos
 preservam a grafia de código: `opus check`, `@softize/opus`, `opus.json` e
@@ -39,21 +39,21 @@ O componente ou o contrato Opus classifica cada texto antes de a Base aplicar a
 Essa classificação decide, por exemplo, se o conteúdo é um fragmento estrutural ou uma
 frase. Não copie as regras da Base para cá.
 
-| Superfície Opus | Papel enviado à Base |
-|---|---|
-| `label`, botão de confirmação e filhos de `Button` | `button` |
-| `title`, `CardTitle`, `DialogTitle` | `title` |
-| `description`, `hint`, `help` | `description` ou `helper-text` |
-| `messages.success` e `messages.error` | `success` e `error` |
-| `confirm.message`, `DialogDescription` | `dialog-body` |
-| label de campo, filtro ou opção | `label` ou `menu-item` |
-| placeholder de campo ou busca | `placeholder` |
-| `Select.emptyText` e grupos de opção | `empty-state` e `heading` |
-| confirmação local do `ActionTrigger` | `title`, `dialog-body` e `button` |
-| `dialog.alert/confirm/prompt/choose` — `title`, `description`/`body`, `action`/`cancel`, `actions[].label` | `title`, `dialog-body`, `button` (e `placeholder` no `prompt`) |
-| filhos de `TooltipContent` | `label` |
-| `LabelHelp.help` | `helper-text` |
-| `emptyMessage`, `errorMessage`, `retryLabel` de `DataState`, `PageState`, `ActionList`, `ActionListDialog` e `ActionView` | `empty-state`, `error`, `button` |
+| Superfície Opus                                                                                                           | Papel enviado à Base                                           |
+| ------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------- |
+| `label`, botão de confirmação e filhos de `Button`                                                                        | `button`                                                       |
+| `title`, `CardTitle`, `DialogTitle`                                                                                       | `title`                                                        |
+| `description`, `hint`, `help`                                                                                             | `description` ou `helper-text`                                 |
+| `messages.success` e `messages.error`                                                                                     | `success` e `error`                                            |
+| `confirm.message`, `dialog.*().body` e texto relevante no `DialogBody`                                                    | `dialog-body`                                                  |
+| label de campo, filtro ou opção                                                                                           | `label` ou `menu-item`                                         |
+| placeholder de campo ou busca                                                                                             | `placeholder`                                                  |
+| `Select.emptyText` e grupos de opção                                                                                      | `empty-state` e `heading`                                      |
+| confirmação local do `ActionTrigger`                                                                                      | `title`, `dialog-body` e `button`                              |
+| `dialog.alert/confirm/prompt/choose` — `title`, `body`, `action`/`cancel`, `actions[].label`                              | `title`, `dialog-body`, `button` (e `placeholder` no `prompt`) |
+| filhos de `TooltipContent`                                                                                                | `label`                                                        |
+| `LabelHelp.help`                                                                                                          | `helper-text`                                                  |
+| `emptyMessage`, `errorMessage`, `retryLabel` de `DataState`, `PageState`, `ActionList`, `ActionListDialog` e `ActionView` | `empty-state`, `error`, `button`                               |
 
 O tooltip entra como `label` porque nomeia um controle icon-only: é um fragmento curto, sem
 ponto final, e a Base não define um papel próprio para tooltip. Texto de ajuda que precisa de
@@ -64,11 +64,11 @@ frase completa pertence ao `help` de um campo (contrato ou `LabelHelp`), não ao
 Quem vê o gate reprovar ou precisa de uma dispensa deve saber o que o extrator alcança sem
 declaração adicional:
 
-- **Diálogos imperativos.** `dialog.confirm({ title, description, action })` e as demais
+- **Diálogos imperativos.** `dialog.confirm({ title, body, action })` e as demais
   respostas (`alert`, `prompt`, `choose`) entram no inventário como se fossem props de um
   `ActionFormDialog`; o campo do diagnóstico é `dialog.confirm().title`,
   `dialog.choose().actions[0].label` etc. Constantes locais resolvem normalmente. Uma função
-  que devolve template (`description: describe(nome)`) gera o diagnóstico `content` habitual e
+  que devolve template (`body: describe(nome)`) gera o diagnóstico `content` habitual e
   se declara em `copy.dynamic` como `message-template`. Opções construídas em tempo de execução
   ou mutadas depois de declaradas reprovam como estrutura, porque nenhum texto pode ser
   atribuído a elas.
@@ -121,7 +121,7 @@ dispensados por `copy.dynamic`; ausência de conteúdo também continua bloquean
       {
         "source": "src/sessions.tsx",
         "line": 58,
-        "field": "<DialogDescription> children",
+        "field": "dialog.confirm().body",
         "kind": "message-template",
         "role": "dialog-body",
         "text": "Excluir {nome}?",