@softize/opus 12.11.0 → 13.1.0

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

@@ -4,11 +4,10 @@ title: Atualizar o Opus
 
 # Atualizar o Opus
 
-Projeto em produção fica meses sem tocar no Opus — e um dia precisa pular várias
-versões de uma vez. O ritual é o mesmo para humano e IA, e não depende de memória:
-cada etapa está documentada ou é verificada por um gate que informa o que precisa ser corrigido.
+Use este fluxo para atualizar o Opus por uma ou várias versões. O changelog explica as mudanças e os
+gates apontam as adaptações necessárias no projeto.
 
-## 1. Saber que está atrás
+## 1. Identificar a versão disponível
 
 O **Maestro** compara o pin (`opus.json`) com a versão instalada e com a fonte a cada
 sessão — o alerta no rodapé diz a distância (`v2.9.0 → v2.15.2`) e o **Atualizar** faz
@@ -16,7 +15,7 @@ a parte mecânica: bump da dependência, re-materialização da camada de IA (sk
 hooks, agentes) e re-sync do bloco gerenciado do CLAUDE.md. Fora do Maestro:
 `pnpm outdated @softize/opus`.
 
-## 2. Saber o que mudou
+## 2. Ler as mudanças acumuladas
 
 O changelog **viaja no pacote** — depois do bump, está em
 `node_modules/@softize/opus/CHANGELOG.md`. Uma entrada por versão; quando quebra,
@@ -26,7 +25,7 @@ A esteira de release **recusa** publicar versão sem entrada — o arquivo não
 - **minor** (2.9 → 2.10): compatível; leia por curiosidade.
 - **major** (2.x → 3.0): pare nas seções Breaking de cada versão pulada, na ordem.
 
-## 3. Deixar os gates cobrarem o resto
+## 3. Executar as verificações
 
 O Opus ship source: o que quebrou aparece com arquivo e linha. Rode, na ordem:
 
@@ -38,8 +37,8 @@ pnpm manifest:check   # a spec projetada ficou fresca?
 opus db migrate       # schema em dia (drift-check embutido)
 ```
 
-Verde em tudo = atualizado de verdade. O bump entra no PR como qualquer mudança de
-código — atualização de base passa por review, não por fé.
+Com todas as verificações verdes, revise a atualização como qualquer outra mudança de código antes
+de entregá-la.
 
 ## Pulou muitas versões?
 

package/src/ui/docs/doc-client.tsx

@@ -8,7 +8,7 @@ import { QueryClient, QueryClientProvider } from '@tanstack/react-query'
 import { z } from 'zod'
 import { attachLogicalType, defineContract, error } from '../../core/index.ts'
 import type { ActionDef, ActionResult, ClientAdapter, LogicalTypeMeta, Paginated } from '../../core/index.ts'
-import { TbdlibProvider } from '../react.tsx'
+import { OpusProvider } from '../react.tsx'
 
 // — Dados enlatados (domínio da casa) —
 export interface DocBrowserWorkspace {
@@ -37,7 +37,7 @@ export const docWorkspaceStatus: LogicalTypeMeta = {
     keys: [...STATUS],
     entries: {
       active: { label: 'Ativo', context: 'success', description: 'Agentes em operação para o cliente.' },
-      onboarding: { label: 'Onboarding', context: 'warning' },
+      onboarding: { label: 'Em integração', context: 'warning' },
       paused: { label: 'Pausado' },
     },
     presentation: 'status',
@@ -59,7 +59,7 @@ export const docWorkspaceCreate = defineContract({
   }),
   output: z.object({ id: z.string() }),
   fields: {
-    name: { label: 'Nome', placeholder: 'Ex.: Empresa X', hint: 'Digite "Softize" pra ver o erro de servidor.' },
+    name: { label: 'Nome', placeholder: 'Ex.: Empresa X', help: 'Digite “Softize” para ver o erro de servidor.' },
     status: { label: 'Status' },
     contact: { label: 'Contato', placeholder: 'email@cliente.com' },
     notes: { label: 'Observações', placeholder: 'Contexto do onboarding…' },
@@ -100,7 +100,7 @@ export const docWorkspaceList = defineContract({
         kind: 'static',
         items: [
           { value: 'active', label: 'Ativo' },
-          { value: 'onboarding', label: 'Onboarding' },
+          { value: 'onboarding', label: 'Em integração' },
           { value: 'paused', label: 'Pausado' },
         ],
       },
@@ -225,7 +225,7 @@ const queryClient = new QueryClient()
 export function DocBrowserActionProvider({ children }: { children: React.ReactNode }): React.ReactElement {
   return (
     <QueryClientProvider client={queryClient}>
-      <TbdlibProvider client={docClient}>{children}</TbdlibProvider>
+      <OpusProvider client={docClient}>{children}</OpusProvider>
     </QueryClientProvider>
   )
 }

package/src/ui/docs/doc.tsx

@@ -18,6 +18,10 @@ import {
   TableHead,
   TableHeader,
   TableRow,
+  Tooltip,
+  TooltipContent,
+  TooltipProvider,
+  TooltipTrigger,
   cn,
 } from '../react.tsx'
 
@@ -72,8 +76,8 @@ export function DocPage({
           </p>
         )}
         {meta?.deprecated !== undefined && (
-          <div className="max-w-2xl rounded-lg border border-amber-500/30 bg-amber-500/10 px-3 py-2 text-sm leading-relaxed text-foreground">
-            <span className="font-medium">Deprecated{meta.deprecated.since !== undefined ? ` desde ${meta.deprecated.since}` : ''}.</span>{' '}
+          <div className="max-w-2xl rounded-lg border border-context-warning-border bg-context-warning-subtle px-3 py-2 text-sm leading-relaxed text-foreground">
+            <span className="font-medium">Descontinuado{meta.deprecated.since !== undefined ? ` desde ${meta.deprecated.since}` : ''}.</span>{' '}
             Use <InlineMd text={meta.deprecated.alternative} />.
           </div>
         )}
@@ -211,17 +215,25 @@ export function CodeBlock({
     // overflow-hidden: os filhos (fade incluso) são CLIPADOS no raio do contêiner — sem
     // isso, o overlay desenhava um segundo arco nos cantos (a "borda dobrada").
     <div className={cn('group relative overflow-hidden rounded-lg border border-border bg-muted/40', className)}>
-      <button
-        onClick={() => {
-          void navigator.clipboard.writeText(clean)
-          setCopied(true)
-          setTimeout(() => setCopied(false), 1500)
-        }}
-        title="Copiar código"
-        className="absolute right-2 top-2 z-20 rounded-md p-1.5 text-muted-foreground opacity-0 transition-opacity hover:bg-muted hover:text-foreground group-hover:opacity-100"
-      >
-        {copied ? <Check className="h-3.5 w-3.5" /> : <Copy className="h-3.5 w-3.5" />}
-      </button>
+      {/* Provider próprio: a doc também é montada fora do shell do app (standalone, testes). */}
+      <TooltipProvider delayDuration={200}>
+      <Tooltip>
+        <TooltipTrigger asChild>
+          <button
+            onClick={() => {
+              void navigator.clipboard.writeText(clean)
+              setCopied(true)
+              setTimeout(() => setCopied(false), 1500)
+            }}
+            aria-label="Copiar código"
+            className="absolute right-2 top-2 z-20 rounded-md p-1.5 text-muted-foreground opacity-0 transition-opacity hover:bg-muted hover:text-foreground group-hover:opacity-100 focus-visible:opacity-100"
+          >
+            {copied ? <Check className="h-3.5 w-3.5" /> : <Copy className="h-3.5 w-3.5" />}
+          </button>
+        </TooltipTrigger>
+        <TooltipContent>{copied ? 'Copiado' : 'Copiar código'}</TooltipContent>
+      </Tooltip>
+      </TooltipProvider>
 
       <div ref={contentRef} className={cn('relative', collapsed && 'max-h-44 overflow-hidden')}>
         <Highlight code={clean} language={lang} theme={codeTheme}>
@@ -279,7 +291,7 @@ export function PropsTable({ rows }: { rows: PropRow[] }): React.ReactElement {
       <Table>
         <TableHeader>
           <TableRow>
-            <TableHead className="w-[18%]">Prop</TableHead>
+            <TableHead className="w-[18%]">Propriedade</TableHead>
             <TableHead className="w-[30%]">Tipo</TableHead>
             <TableHead className="w-[12%]">Padrão</TableHead>
             <TableHead>Descrição</TableHead>

package/src/ui/docs/registry.tsx

@@ -27,6 +27,7 @@ import authMd from "./content/auth.md?raw";
 import auditMd from "./content/audit.md?raw";
 import eventsMd from "./content/events.md?raw";
 import logMd from "./content/log.md?raw";
+import observabilityMd from "./content/observability.md?raw";
 import queueMd from "./content/queue.md?raw";
 import schedulerMd from "./content/scheduler.md?raw";
 import actionsMd from "./content/actions.md?raw";
@@ -46,8 +47,6 @@ import customizationMd from "./content/customization.md?raw";
 // — Componentes —
 import accordionMd from "./content/accordion.md?raw";
 import alertMd from "./content/alert.md?raw";
-import alertDialogMd from "./content/alert-dialog.md?raw";
-import confirmMd from "./content/confirm.md?raw";
 import aspectRatioMd from "./content/aspect-ratio.md?raw";
 import avatarMd from "./content/avatar.md?raw";
 import badgeMd from "./content/badge.md?raw";
@@ -55,7 +54,6 @@ import dotMd from "./content/dot.md?raw";
 import dockMd from "./content/dock.md?raw";
 import breadcrumbMd from "./content/breadcrumb.md?raw";
 import buttonMd from "./content/button.md?raw";
-import buttonGroupMd from "./content/button-group.md?raw";
 import calendarMd from "./content/calendar.md?raw";
 import cardMd from "./content/card.md?raw";
 import metricCardMd from "./content/metric-card.md?raw";
@@ -77,7 +75,6 @@ import menuMd from "./content/menu.md?raw";
 import emptyMd from "./content/empty.md?raw";
 import fieldMd from "./content/field.md?raw";
 import inputMd from "./content/input.md?raw";
-import inputGroupMd from "./content/input-group.md?raw";
 import inputOtpMd from "./content/input-otp.md?raw";
 import itemMd from "./content/item.md?raw";
 import kbdMd from "./content/kbd.md?raw";
@@ -99,7 +96,6 @@ import tabsMd from "./content/tabs.md?raw";
 import textareaMd from "./content/textarea.md?raw";
 import toastMd from "./content/toast.md?raw";
 import toggleMd from "./content/toggle.md?raw";
-import toggleGroupMd from "./content/toggle-group.md?raw";
 import tooltipMd from "./content/tooltip.md?raw";
 import truncateMd from "./content/truncate.md?raw";
 
@@ -122,7 +118,6 @@ import actionTriggerMd from "./content/action-trigger.md?raw";
 import actionSearchDialogMd from "./content/action-list-dialog.md?raw";
 import pageMd from "./content/page.md?raw";
 import contentMd from "./content/content.md?raw";
-import pageStateMd from "./content/page-state.md?raw";
 import sidebarMd from "./content/sidebar.md?raw";
 import splitMd from "./content/split.md?raw";
 import routerMd from "./content/router.md?raw";
@@ -139,6 +134,8 @@ export interface DocEntry {
 export interface DocGroup {
   /** Sub-rótulo opcional dentro da seção (ex.: Primitivos). Ausente = páginas direto na seção. */
   label?: string;
+  /** Ícone opcional apresentado no nó expansível do grupo. */
+  icon?: React.ReactNode;
   pages: DocEntry[];
 }
 
@@ -178,7 +175,7 @@ const comp =
     </DocPage>
   );
 
-/** O palco dos patterns no scope dos previews: ícones + client fake + contratos de mentira. */
+/** O palco dos patterns no scope dos previews: ícones, cliente simulado e contratos de exemplo. */
 const patternScope = {
   ...iconScope,
   DocBrowserActionProvider,
@@ -224,13 +221,13 @@ export const PROTOCOL_SECTIONS: DocSection[] = [
         pages: [
           {
             slug: "getting-started",
-            title: "Getting started",
+            title: "Primeiros passos",
             render: doc(gettingStartedMd),
           },
           { slug: "cycle", title: "Evolução contínua", render: doc(cycleMd) },
           {
             slug: "upgrading",
-            title: "Atualizar a base",
+            title: "Atualizar o Opus",
             render: doc(upgradingMd),
           },
         ],
@@ -291,6 +288,12 @@ export const PROTOCOL_SECTIONS: DocSection[] = [
             render: doc(eventsMd),
           },
           { slug: "log", title: "Log", badge: "log", render: doc(logMd) },
+          {
+            slug: "observability",
+            title: "Observabilidade",
+            badge: "observability",
+            render: doc(observabilityMd),
+          },
           {
             slug: "queue",
             title: "Filas",
@@ -334,7 +337,7 @@ export const UI_SECTIONS: DocSection[] = [
         pages: [
           {
             slug: "como-consumir",
-            title: "Getting started",
+            title: "Como consumir",
             render: doc(uiMd),
           },
         ],
@@ -346,10 +349,10 @@ export const UI_SECTIONS: DocSection[] = [
     groups: [
       {
         pages: [
-          { slug: "tokens", title: "Tokens & Tema", render: doc(tokensMd) },
+          { slug: "tokens", title: "Tokens e tema", render: doc(tokensMd) },
           {
             slug: "semantic-context",
-            title: "Contexto & Variante",
+            title: "Contexto e variante",
             render: doc(semanticContextMd),
           },
           {
@@ -371,6 +374,7 @@ export const UI_SECTIONS: DocSection[] = [
     groups: [
       {
         label: "Fundamentos",
+        icon: <lucideIcons.Blocks className="size-4" />,
         pages: [
           {
             slug: "router",
@@ -381,6 +385,7 @@ export const UI_SECTIONS: DocSection[] = [
       },
       {
         label: "Layout",
+        icon: <lucideIcons.PanelsTopLeft className="size-4" />,
         pages: [
           {
             slug: "split",
@@ -402,11 +407,6 @@ export const UI_SECTIONS: DocSection[] = [
             title: "Content",
             render: pattern("Content", "content", contentMd),
           },
-          {
-            slug: "page-state",
-            title: "Page State",
-            render: pattern("Page State", "page-state", pageStateMd),
-          },
           {
             slug: "accordion",
             title: "Accordion",
@@ -442,6 +442,7 @@ export const UI_SECTIONS: DocSection[] = [
       },
       {
         label: "Actions",
+        icon: <lucideIcons.Zap className="size-4" />,
         pages: [
           {
             slug: "action-form",
@@ -498,6 +499,7 @@ export const UI_SECTIONS: DocSection[] = [
       },
       {
         label: "IA",
+        icon: <lucideIcons.Sparkles className="size-4" />,
         pages: [
           { slug: "ask", title: "Ask", render: comp("Ask", "ask", askMd) },
           { slug: "chat", title: "Chat", render: comp("Chat", "chat", chatMd) },
@@ -510,6 +512,7 @@ export const UI_SECTIONS: DocSection[] = [
       },
       {
         label: "Formulário",
+        icon: <lucideIcons.TextCursorInput className="size-4" />,
         pages: [
           {
             slug: "calendar",
@@ -536,11 +539,6 @@ export const UI_SECTIONS: DocSection[] = [
             title: "Input",
             render: comp("Input", "input", inputMd),
           },
-          {
-            slug: "input-group",
-            title: "Input Group",
-            render: comp("Input Group", "input-group", inputGroupMd),
-          },
           {
             slug: "input-otp",
             title: "Input OTP",
@@ -580,31 +578,23 @@ export const UI_SECTIONS: DocSection[] = [
       },
       {
         label: "Botões",
+        icon: <lucideIcons.MousePointerClick className="size-4" />,
         pages: [
           {
             slug: "button",
             title: "Button",
             render: comp("Button", "button", buttonMd),
           },
-          {
-            slug: "button-group",
-            title: "Button Group",
-            render: comp("Button Group", "button-group", buttonGroupMd),
-          },
           {
             slug: "toggle",
             title: "Toggle",
             render: comp("Toggle", "toggle", toggleMd),
           },
-          {
-            slug: "toggle-group",
-            title: "Toggle Group",
-            render: comp("Toggle Group", "toggle-group", toggleGroupMd),
-          },
         ],
       },
       {
         label: "Navegação",
+        icon: <lucideIcons.Compass className="size-4" />,
         pages: [
           {
             slug: "breadcrumb",
@@ -626,6 +616,7 @@ export const UI_SECTIONS: DocSection[] = [
       },
       {
         label: "Exibição",
+        icon: <lucideIcons.Eye className="size-4" />,
         pages: [
           {
             slug: "avatar",
@@ -689,17 +680,13 @@ export const UI_SECTIONS: DocSection[] = [
       },
       {
         label: "Feedback",
+        icon: <lucideIcons.MessageCircleWarning className="size-4" />,
         pages: [
           {
             slug: "alert",
             title: "Alert",
             render: comp("Alert", "alert", alertMd),
           },
-          {
-            slug: "confirm",
-            title: "Dialog (imperativo)",
-            render: comp("Dialog (imperativo)", "confirm", confirmMd),
-          },
           {
             slug: "data-state",
             title: "Data State",
@@ -734,12 +721,8 @@ export const UI_SECTIONS: DocSection[] = [
       },
       {
         label: "Sobreposição",
+        icon: <lucideIcons.Layers className="size-4" />,
         pages: [
-          {
-            slug: "alert-dialog",
-            title: "Alert Dialog",
-            render: comp("Alert Dialog", "alert-dialog", alertDialogMd),
-          },
           {
             slug: "dialog",
             title: "Dialog",

package/src/ui/docs/standalone.tsx

@@ -66,7 +66,7 @@ export interface MountDocsOptions {
   basePath?: string
   /** Elemento alvo. Default: `#root` (cria um se faltar). */
   el?: HTMLElement
-  /** Título no topo. Default `Components` (o site-base passa `opus`). */
+  /** Título no topo. Default `Componentes` (o site-base passa `opus`). */
   title?: string
   /** Legenda ao lado do título. Default `a verdade visual deste projeto`. */
   subtitle?: string
@@ -78,7 +78,7 @@ export interface MountDocsOptions {
 /** Monta a doc na página. Chamado pelo entry do plugin opusDocs (depois de importar o CSS do app). */
 export function mountDocs(options: MountDocsOptions = {}): void {
   const basePath = options.basePath ?? '/__docs'
-  const title = options.title ?? 'Components'
+  const title = options.title ?? 'Componentes'
   const subtitle = options.subtitle ?? 'a verdade visual deste projeto'
   // Tema persistido pela própria doc; senão, a preferência do sistema.
   let saved: string | null = null

package/src/ui/drivers/react.tsx

@@ -2,11 +2,11 @@
  * @softize/opus/ui/react — React driver
  *
  * Hooks + Provider pra invocar actions client-side.
- *   - `TbdlibProvider` — injeta ClientAdapter no contexto
+ *   - `OpusProvider` — injeta ClientAdapter no contexto (`TbdlibProvider` é alias em retirada)
  *   - `useAction(action)` — invoca actions simple/form/view
  *   - `useLookupAction(action)` — variante pra search (output Paginated)
  *
- * Compatível com React 18 e 19. Não dona estado global de cache —
+ * Requer React 19 (peer `react@^19`). Não dona estado global de cache —
  * cada hook mantém o seu (suficiente pra v0). Integração com
  * TanStack Query fica em `@softize/opus/client/tanstack` no futuro.
  */
@@ -58,14 +58,14 @@ export interface DictLike {
   options(): Array<{ value: string; label: string }>
 }
 
-interface TbdlibContextValue {
+interface OpusContextValue {
   client: ClientAdapter
   dicts: Record<string, DictLike>
 }
 
-const TbdlibContext = createContext<TbdlibContextValue | null>(null)
+const OpusContext = createContext<OpusContextValue | null>(null)
 
-export interface TbdlibProviderProps {
+export interface OpusProviderProps {
   client: ClientAdapter
   /** Dicionários por ref — resolvem `options: { kind: 'dictionary', ref }` de
    *  filters/fields (ActionList/ActionForm). Campo de dict sem registro aqui ainda
@@ -74,20 +74,25 @@ export interface TbdlibProviderProps {
   children: ReactNode
 }
 
-export function TbdlibProvider({
+export function OpusProvider({
   client,
   dicts,
   children,
-}: TbdlibProviderProps): ReactNode {
-  const value = useMemo<TbdlibContextValue>(() => ({ client, dicts: dicts ?? {} }), [client, dicts])
-  return <TbdlibContext.Provider value={value}>{children}</TbdlibContext.Provider>
+}: OpusProviderProps): ReactNode {
+  const value = useMemo<OpusContextValue>(() => ({ client, dicts: dicts ?? {} }), [client, dicts])
+  return <OpusContext.Provider value={value}>{children}</OpusContext.Provider>
 }
 
+/** @deprecated Renomeado para `OpusProvider`; o alias segue até a próxima série. */
+export const TbdlibProvider = OpusProvider
+/** @deprecated Use `OpusProviderProps`. */
+export type TbdlibProviderProps = OpusProviderProps
+
 function useClient(): ClientAdapter {
-  const ctx = useContext(TbdlibContext)
+  const ctx = useContext(OpusContext)
   if (ctx === null) {
     throw new Error(
-      'useAction/useLookupAction must be used inside <TbdlibProvider>',
+      'useAction/useLookupAction precisam estar dentro de <OpusProvider>.',
     )
   }
   return ctx.client
@@ -98,7 +103,7 @@ const NO_DICTS: Record<string, DictLike> = {}
 /** Dicts do provider. Default {} — inclusive fora do provider: o resolvedor cai
  *  nos fallbacks (estáticas do spec, meta do `t.dict`) sem exigir registry. */
 export function useDicts(): Record<string, DictLike> {
-  return useContext(TbdlibContext)?.dicts ?? NO_DICTS
+  return useContext(OpusContext)?.dicts ?? NO_DICTS
 }
 
 // =============================================================================

package/src/ui/lib/action-errors.ts

@@ -0,0 +1,45 @@
+/**
+ * O que a pessoa pode ler quando uma action falha.
+ *
+ * Categorias cuja frase do SERVIDOR vence o rótulo do contrato: "Este agente tem 3 conversas —
+ * desabilite em vez de excluir" é acionável; "Falha ao excluir" não. É ALLOWLIST de propósito —
+ * erro inesperado carrega texto técnico cru (uma violação de FK viraria
+ * `violates foreign key constraint "user_unit_id_fkey"` para quem só clicou no botão), então
+ * categoria desconhecida cai no texto genérico, o lado seguro de errar. `authorization` e
+ * `authentication` entram porque o runtime já responde em pt-BR ("Acesso negado",
+ * "Autenticação necessária") e a pessoa precisa saber que o problema é de permissão, não de rede.
+ */
+export const BUSINESS_ERRORS: readonly string[] = [
+  'conflict',
+  'validation',
+  'not_found',
+  'authorization',
+  'authentication',
+]
+
+/** Erro que tentar de novo não resolve: falta de permissão ou de sessão. */
+export function isRetryable(err: HumanizableError): boolean {
+  return err.category !== 'authorization' && err.category !== 'authentication'
+}
+
+export interface HumanizableError {
+  category?: string
+  message?: string
+}
+
+/** A frase do servidor é de negócio (allowlist) e tem conteúdo. */
+export function isBusinessError(err: HumanizableError): boolean {
+  return (
+    err.category !== undefined &&
+    BUSINESS_ERRORS.includes(err.category) &&
+    (err.message ?? '').trim() !== ''
+  )
+}
+
+/**
+ * Texto para a pessoa: a frase do servidor quando ela é de negócio; `fallback` no resto. Código
+ * técnico (`internal.unhandled`, `db.constraint`) nunca chega à tela por aqui.
+ */
+export function humanizeActionError(err: HumanizableError, fallback: string): string {
+  return isBusinessError(err) ? (err.message as string).trim() : fallback
+}

package/src/ui/lib/zod-pt-br.ts

@@ -10,28 +10,55 @@
  */
 import { z } from 'zod'
 
+const INVALID = 'Valor inválido.'
+
+function options(count: number | bigint): string {
+  return Number(count) === 1 ? '1 opção' : `${count} opções`
+}
+
 export const zodErrorMapPtBr: z.ZodErrorMap = (issue, ctx) => {
   switch (issue.code) {
     case z.ZodIssueCode.invalid_type:
       if (issue.received === 'undefined' || issue.received === 'null') return { message: 'Obrigatório.' }
-      return { message: 'Valor inválido.' }
+      return { message: INVALID }
     case z.ZodIssueCode.too_small:
       if (issue.type === 'string') {
         return { message: Number(issue.minimum) <= 1 ? 'Obrigatório.' : `Mínimo de ${issue.minimum} caracteres.` }
       }
-      if (issue.type === 'array') return { message: `Selecione pelo menos ${issue.minimum}.` }
+      if (issue.type === 'array') return { message: `Selecione pelo menos ${options(issue.minimum)}.` }
+      if (issue.type === 'date') return { message: 'Data anterior ao permitido.' }
       return { message: `Valor mínimo: ${issue.minimum}.` }
     case z.ZodIssueCode.too_big:
       if (issue.type === 'string') return { message: `Máximo de ${issue.maximum} caracteres.` }
-      if (issue.type === 'array') return { message: `Selecione no máximo ${issue.maximum}.` }
+      if (issue.type === 'array') return { message: `Selecione no máximo ${options(issue.maximum)}.` }
+      if (issue.type === 'date') return { message: 'Data posterior ao permitido.' }
       return { message: `Valor máximo: ${issue.maximum}.` }
     case z.ZodIssueCode.invalid_string:
-      if (issue.validation === 'email') return { message: 'Email inválido.' }
+      if (issue.validation === 'email') return { message: 'E-mail inválido.' }
       if (issue.validation === 'url') return { message: 'URL inválida.' }
       if (issue.validation === 'uuid') return { message: 'Identificador inválido.' }
       return { message: 'Formato inválido.' }
     case z.ZodIssueCode.invalid_enum_value:
+    case z.ZodIssueCode.invalid_union_discriminator:
       return { message: 'Escolha uma das opções.' }
+    case z.ZodIssueCode.invalid_literal:
+    case z.ZodIssueCode.invalid_union:
+    case z.ZodIssueCode.invalid_intersection_types:
+    case z.ZodIssueCode.invalid_arguments:
+    case z.ZodIssueCode.invalid_return_type:
+    case z.ZodIssueCode.custom:
+      return { message: INVALID }
+    case z.ZodIssueCode.invalid_date:
+      return { message: 'Data inválida.' }
+    case z.ZodIssueCode.not_multiple_of:
+      return { message: `Use múltiplos de ${issue.multipleOf}.` }
+    case z.ZodIssueCode.unrecognized_keys:
+      return {
+        message:
+          issue.keys.length === 1
+            ? `Campo não reconhecido: ${issue.keys[0]}.`
+            : `Campos não reconhecidos: ${issue.keys.join(', ')}.`,
+      }
     default:
       return { message: ctx.defaultError }
   }