@softize/opus 28.0.0 → 30.0.0

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

@@ -15,6 +15,7 @@ import {
 import { headingTags, type HeadingLevel } from "../patterns/heading-level.ts";
 import {
   StructuralHeader,
+  structuralMetaClasses,
   structuralHeaderClasses,
   validateSurfaceIntro,
 } from "../patterns/structural-header.tsx";
@@ -50,6 +51,7 @@ const DrawerContentContext = React.createContext<DrawerContentContextValue>({
   closeSize: "sm",
 });
 
+const DrawerMetaContext = React.createContext(false);
 const DrawerIntroContext = React.createContext(false);
 
 /** Estado de aberto que a pilha de modais da camada flutuante acompanha (ADR 0052). */
@@ -257,33 +259,36 @@ function DrawerHeader({
   const { showCloseButton, closeDisabled, closeSize } =
     React.useContext(DrawerContentContext);
   return (
-    <StructuralHeader
-      name="DrawerHeader"
-      slot="drawer"
-      slots={{
-        leading: DrawerNavigation,
-        media: DrawerMedia,
-        title: DrawerTitle,
-        description: DrawerDescription,
-        actions: DrawerActions,
-      }}
-      leadingPlacement="inline"
-      titleRequired={false}
-      rowClassName={surfaceHeaderRowClasses("drawer")}
-      className={cn(
-        "text-left",
-        surfaceRegionClasses("drawer", layout, "header"),
-        className,
-      )}
-      trailing={
-        showCloseButton ? (
-          <DrawerCloseButton disabled={closeDisabled} size={closeSize} />
-        ) : undefined
-      }
-      {...props}
-    >
-      {children}
-    </StructuralHeader>
+    <DrawerMetaContext.Provider value>
+      <StructuralHeader
+        name="DrawerHeader"
+        slot="drawer"
+        slots={{
+          leading: DrawerNavigation,
+          media: DrawerMedia,
+          title: DrawerTitle,
+          description: DrawerDescription,
+          meta: DrawerMeta,
+          actions: DrawerActions,
+        }}
+        leadingPlacement="inline"
+        titleRequired={false}
+        rowClassName={surfaceHeaderRowClasses("drawer")}
+        className={cn(
+          "text-left",
+          surfaceRegionClasses("drawer", layout, "header"),
+          className,
+        )}
+        trailing={
+          showCloseButton ? (
+            <DrawerCloseButton disabled={closeDisabled} size={closeSize} />
+          ) : undefined
+        }
+        {...props}
+      >
+        {children}
+      </StructuralHeader>
+    </DrawerMetaContext.Provider>
   );
 }
 
@@ -325,25 +330,47 @@ function DrawerIntro({
 }: React.ComponentProps<"div">) {
   return (
     <DrawerIntroContext.Provider value>
-      <StructuralHeader
-        name="DrawerIntro"
-        slot="drawer-intro"
-        slots={{
-          title: DrawerTitle,
-          description: DrawerDescription,
-          actions: DrawerIntroActions,
-        }}
-        leadingPlacement="inline"
-        titleRequired
-        className={cn("text-left", className)}
-        {...props}
-      >
-        {children}
-      </StructuralHeader>
+      <DrawerMetaContext.Provider value>
+        <StructuralHeader
+          name="DrawerIntro"
+          slot="drawer-intro"
+          slots={{
+            title: DrawerTitle,
+            description: DrawerDescription,
+            meta: DrawerMeta,
+            actions: DrawerIntroActions,
+          }}
+          leadingPlacement="inline"
+          titleRequired
+          className={cn("text-left", className)}
+          {...props}
+        >
+          {children}
+        </StructuralHeader>
+      </DrawerMetaContext.Provider>
     </DrawerIntroContext.Provider>
   );
 }
 
+/** Badges, datas e autoria abaixo do título e da orientação. */
+export function DrawerMeta({
+  className,
+  ...props
+}: React.ComponentProps<"div">) {
+  const inside = React.useContext(DrawerMetaContext);
+  if (!inside)
+    throw new Error(
+      "DrawerMeta deve estar dentro de DrawerHeader ou DrawerIntro.",
+    );
+  return (
+    <div
+      data-slot="drawer-meta"
+      className={cn(structuralMetaClasses, className)}
+      {...props}
+    />
+  );
+}
+
 /** Ações relacionadas ao título do conteúdo, separadas das ações de chrome do header. */
 function DrawerIntroActions({
   className,

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

@@ -24,7 +24,7 @@ function Table({
         data-slot="table-container"
         data-variant={variant}
         className={cn(
-          "relative w-full overflow-x-auto",
+          "relative w-full min-w-0 max-w-full overflow-x-auto",
           variant === "framed" && "rounded-lg border border-border",
           containerClassName,
         )}
@@ -95,7 +95,7 @@ function TableHead({ className, ...props }: React.ComponentProps<"th">) {
     <th
       data-slot="table-head"
       className={cn(
-        "h-10 px-3 text-left align-middle font-medium whitespace-nowrap text-muted-foreground [&:has([role=checkbox])]:pr-0 [&>[role=checkbox]]:translate-y-[0.125rem]",
+        "h-10 px-3 text-left align-middle font-medium whitespace-normal text-muted-foreground [&:has([role=checkbox])]:pr-0 [&>[role=checkbox]]:translate-y-[0.125rem]",
         className,
       )}
       {...props}
@@ -108,7 +108,7 @@ function TableCell({ className, ...props }: React.ComponentProps<"td">) {
     <td
       data-slot="table-cell"
       className={cn(
-        "px-3 py-2 align-middle whitespace-nowrap [&:has([role=checkbox])]:pr-0 [&>[role=checkbox]]:translate-y-[0.125rem]",
+        "px-3 py-2 align-middle whitespace-normal wrap-break-word [&:has([role=checkbox])]:pr-0 [&>[role=checkbox]]:translate-y-[0.125rem]",
         className,
       )}
       {...props}

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

@@ -10,13 +10,20 @@ limites visuais da coleção; use [`Table`](/ui/table) diretamente quando a comp
 variante `framed`. Carregamento, erro e vazio usam o mesmo [`DataState`](/ui/data-state) das
 demais coleções.
 
-A barra mantém em uma única linha os controles declarados como `inline`: ela não quebra e não move
-filtros para o modal por falta de espaço. Seletores de valor único acompanham o valor escolhido até
-`20rem` e truncam o excedente; a busca varia entre `8rem` e `16rem` conforme a largura
-disponível. Quando a barra ficar longa demais, declare como `advanced` os filtros que não precisam
-ficar sempre à vista, como descreve a seção “Onde cada filtro aparece”. Recarregar e
-exibição formam um `ButtonGroup` espaçado; `toolbarActions` acrescenta, depois deles, operações
-ligadas ao recorte atual.
+A tabela usa a largura disponível e permite quebra em células textuais. Colunas com `fit`
+preservam valores compactos sem quebra. A largura das colunas de dados considera cabeçalhos e
+valores, sem comprimir todas as colunas `fit` para ampliar a primeira. Os cabeçalhos quebram
+quando falta espaço; seleção, ações de linha e células contendo apenas um switch
+(direto ou envolvido por TooltipTrigger) mantêm a largura compacta.
+Se identificadores sem espaços ou larguras mínimas explícitas excederem o espaço, a rolagem
+fica nos resultados, sem alargar a toolbar ou o rodapé. Em `layout="fill"`, o cabeçalho continua fixo nessa região.
+
+A barra distribui os controles `inline` em mais de uma linha quando necessário, preservando sua
+ordem. Ela não move filtros automaticamente para o modal. Seletores de valor único acompanham o
+valor escolhido até `20rem` e truncam o excedente; a busca varia entre `8rem` e `16rem`.
+Declare como `advanced` os filtros que não precisam ficar sempre à vista, como descreve a seção
+“Onde cada filtro aparece”. Recarregar e exibição formam um `ButtonGroup` espaçado;
+`toolbarActions` acrescenta, depois deles, operações ligadas ao recorte atual.
 
 ```tsx preview col
 render(
@@ -459,7 +466,7 @@ restaurá-lo.
 />
 ```
 
-Convenção compacta (defaults omitidos): `?q=…&sort=chave:dir&status=…&view=board&cols=a,b,c&limit=25`.
+Convenção compacta (defaults omitidos): `?q=…&sort=key:dir&status=…&view=board&cols=a,b,c&limit=25`.
 
 ## Composição dos itens
 

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

@@ -323,7 +323,7 @@ A resposta é tipada pela entrada e pela saída do contrato; em `list`, é a pá
 plugin onde os cenários estão, com caminhos ou globs:
 `opusDesign({ scenarios: 'design/scenarios/**/*.ts' })`. Nos globs, `*` casa parte do nome dentro
 de uma pasta e `**` casa qualquer número de pastas, inclusive nenhuma: o padrão do exemplo carrega
-tanto `design/scenarios/pedidos.ts` quanto `design/scenarios/pedidos/lista.ts`. O cenário vence a
+tanto `design/scenarios/orders.ts` quanto `design/scenarios/orders/list.ts`. O cenário vence a
 resposta gerada. Um cenário de uma action que não existe, ou dois cenários para a mesma action,
 impedem o runtime de design de subir, e o erro lista os nomes.
 

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

@@ -64,8 +64,8 @@ const runtime = createRuntime({
 })
 
 // Na action: `authorize` decide antes do handler, com o contexto já resolvido.
-export const notaEmitir = bindAction(notaEmitirContract, {
-  authorize: (ctx) => ctx.can('nota.emitir'),
+export const invoiceIssue = bindAction(invoiceIssueContract, {
+  authorize: (ctx) => ctx.can('invoice:issue'),
   handler: async (ctx, input) => repo.create({ ...input, tenantId: ctx.tenantId }),
 })
 ```
@@ -95,7 +95,7 @@ Quando a decisão depende de dado que só o handler conhece, verifique no própr
 ```ts
 import { error } from '@softize/opus/core'
 
-if (!(await ctx.can('nota.cancelar', nota))) {
+if (!(await ctx.can('invoice:cancel', invoice))) {
   throw error({ code: 'auth.forbidden', category: 'authorization', message: 'Acesso negado' })
 }
 ```

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

@@ -82,6 +82,7 @@ opus gen                                    # manifest / openapi / docs / stubs
 opus gen --config ./apps/api/opus.config.ts # config fora do diretório atual
 opus gen --output ./custom/gen              # pasta de saída (padrão: a do config, ou ./.gen)
 opus copy                                   # inventário semântico de copy dos contratos
+opus copy --reanchor                        # ancora pelo conteúdo as declarações antigas do base.json
 opus introspect                             # modelo da estrutura: actions, reactions, schedules e ligações
 opus introspect --json
 ```
@@ -92,6 +93,11 @@ copy da `@softize/base` valida. O caminho vem de `base.json` (`copy.inventory`;
 versionado. `--check` compara sem escrever e falha quando o inventário está ausente,
 desatualizado ou contém copy dinâmica não declarada.
 
+Declarações de `copy.dynamic`, `copy.exemptions` e `copy.transforms` são ancoradas pelo conteúdo
+(`expression` ou `text`), e não pela linha. `opus copy --reanchor` converte as declarações antigas,
+ancoradas por `line`, grava o `base.json` e lista para revisão as que mudaram de linha ou
+continuam por linha; o detalhe está em `docs/code-style.md` do pacote.
+
 `opus introspect` lê o código sem executá-lo e só reconhece `defineAction`, `defineReaction`,
 `defineSchedule` e `defineDataProduct`. Actions do par `defineContract` e `bindAction`, reactions do
 par `defineReactionContract` e `bindReaction` e schedules declarados sem `defineSchedule` ficam fora

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

@@ -68,7 +68,7 @@ declaração adicional:
   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 (`body: describe(nome)`) gera o diagnóstico `content` habitual e
+  que devolve template (`body: describe(name)`) 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.
@@ -80,7 +80,7 @@ declaração adicional:
   mesmo arquivo, cada literal do array vira um texto na linha em que foi escrito, em vez de um
   diagnóstico sobre a prop. `filter`, `slice`, `toSorted` e `toReversed` podem ficar entre o
   array e a iteração. O limite é deliberado: o array precisa ser literal e declarado no mesmo
-  arquivo; o elemento só pode ser lido (`item.chave`), nunca passado adiante, espalhado ou
+  arquivo; o elemento só pode ser lido (`item.key`), nunca passado adiante, espalhado ou
   atribuído; o callback não pode receber o próprio array como terceiro parâmetro; e nenhum
   elemento pode ter a chave dinâmica. Arrays importados, derivados por spread ou por
   concatenação continuam gerando o diagnóstico da prop.
@@ -97,13 +97,15 @@ visual que o protocolo não representa com segurança.
 é copy editorial estável; `label` e `confirm.*` são as superfícies editoriais cobertas.
 
 Quando uma prop mapeada recebe dados da aplicação, declare a superfície em
-`base.json.copy.dynamic` em vez de excluir o arquivo inteiro. O seletor usa o caminho, a
-linha e o campo exibido pelo diagnóstico. `runtime-data` registra valores como nomes,
+`base.json.copy.dynamic` em vez de excluir o arquivo inteiro. O seletor usa o caminho, o campo
+e o trecho de código exibidos pelo diagnóstico, sem a linha: a declaração continua válida quando
+o arquivo muda acima dela. `runtime-data` registra valores como nomes,
 contagens e opções vindas de API sem transformá-los em copy editorial. `message-template`
 acrescenta ao inventário um texto-modelo com papel semântico, para que a parte autoral de uma
 mensagem interpolada continue passando pela política da Base. As declarações não alteram o
-que o React renderiza; um seletor que deixa de corresponder a um único diagnóstico reprova o
-gate e precisa ser revisto. Diagnósticos estruturais ou de transformação visual não podem ser
+que o React renderiza; um seletor que deixa de encontrar o trecho reprova o gate e precisa ser
+revisto. Declarações antigas, ancoradas por `line`, são convertidas com `opus copy --reanchor`.
+Diagnósticos estruturais ou de transformação visual não podem ser
 dispensados por `copy.dynamic`; ausência de conteúdo também continua bloqueante.
 
 ```json
@@ -112,7 +114,7 @@ dispensados por `copy.dynamic`; ausência de conteúdo também continua bloquean
     "dynamic": [
       {
         "source": "src/sessions.tsx",
-        "line": 42,
+        "expression": "sessionOptions",
         "field": "<Select>.options",
         "kind": "runtime-data",
         "reason": "As opções são nomes de sessões retornados pela aplicação.",
@@ -120,7 +122,7 @@ dispensados por `copy.dynamic`; ausência de conteúdo também continua bloquean
       },
       {
         "source": "src/sessions.tsx",
-        "line": 58,
+        "expression": "`Excluir ${session.name}?`",
         "field": "dialog.confirm().body",
         "kind": "message-template",
         "role": "dialog-body",

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

@@ -460,6 +460,32 @@ botão. O texto informa o efeito real, como `Excluir`, `Revogar acesso` ou `Arqu
   age onde a pessoa está. O modo `alert` cobre a camada até a resposta.
 - `DialogHost` apresenta uma solicitação por vez para que cada resposta tenha um alvo inequívoco.
 
+## Metadados junto à identidade
+
+Use `DialogMeta` para badges, autoria e datas relacionados ao registro. A faixa fica
+abaixo da linha de título e ações, com espaço próprio; `DialogDescription` continua
+reservado à orientação textual breve. Os itens quebram em várias linhas quando necessário.
+
+```tsx
+<Dialog defaultOpen>
+  <DialogContent>
+    <DialogHeader />
+    <DialogBody>
+      <DialogIntro>
+        <DialogTitle>Manual de atendimento</DialogTitle>
+        <DialogDescription>Orientações para a equipe.</DialogDescription>
+        <DialogMeta><Badge>Publicado</Badge><span>Por Ana</span></DialogMeta>
+      </DialogIntro>
+      <p>Conteúdo do manual.</p>
+    </DialogBody>
+  </DialogContent>
+</Dialog>
+```
+
+A composição aceita um único `DialogMeta` e exige um `DialogTitle`. Na forma explícita, coloque-o em `DialogIntro` ou no `DialogHeader` compacto. Não coloque o slot solto no corpo.
+
+O modo `alert` conserva sua composição especializada e não recebe `DialogMeta`.
+
 ## Propriedades de Dialog
 
 | Propriedade    | Tipo                       | Padrão      | Descrição                                                                           |
@@ -668,3 +694,16 @@ Use `flush` quando o conteúdo controlar seus próprios recuos.
 
 Na intro, `DialogTitle` usa a mesma escala de `PageTitle` (`1.875rem`). No header
 compacto, o título conserva a escala de `1.125rem`. O nível semântico não altera essas medidas.
+
+## Propriedades de DialogMeta
+
+| Propriedade | Tipo | Descrição |
+| --- | --- | --- |
+| `children` | `ReactNode` | Badges, datas, autoria ou outros metadados do registro. |
+| `className` | `string` | Ajusta a faixa de metadados. |
+
+Aceita atributos nativos de `div`. O intervalo superior é de 0,75rem; os itens têm
+0,75rem entre colunas e 0,5rem entre linhas. O componente não insere separadores nem
+carrega dados. Omitir o slot não reserva espaço. Metadados não substituem orientações
+ou condições necessárias à decisão e não são anunciados como descrição do modal.
+`DialogMeta` não se aplica a `mode="alert"`; informações necessárias à resposta ficam no corpo do alerta.

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

@@ -190,6 +190,30 @@ de continuar, use [`Dialog mode="alert"`](/ui/dialog), que não fecha pelo cliqu
 - O botão de fechar tem o nome acessível `Fechar`. Botões só com ícone no cabeçalho precisam de
   `aria-label`.
 
+## Metadados junto à identidade
+
+Use `DrawerMeta` para badges, autoria e datas relacionados ao registro. A faixa fica
+abaixo da linha de título e ações, com espaço próprio; `DrawerDescription` continua
+reservado à orientação textual breve. Os itens quebram em várias linhas quando necessário.
+
+```tsx
+<Drawer defaultOpen>
+  <DrawerContent>
+    <DrawerHeader />
+    <DrawerBody>
+      <DrawerIntro>
+        <DrawerTitle>Manual de atendimento</DrawerTitle>
+        <DrawerDescription>Orientações para a equipe.</DrawerDescription>
+        <DrawerMeta><Badge>Publicado</Badge><span>Por Ana</span></DrawerMeta>
+      </DrawerIntro>
+      <p>Conteúdo do manual.</p>
+    </DrawerBody>
+  </DrawerContent>
+</Drawer>
+```
+
+A composição aceita um único `DrawerMeta` e exige um `DrawerTitle`. Na forma explícita, coloque-o em `DrawerIntro` ou no `DrawerHeader` compacto. Não coloque o slot solto no corpo.
+
 ## Propriedades de Drawer
 
 | Propriedade    | Tipo                      | Padrão  | Descrição                                                                 |
@@ -335,3 +359,15 @@ Use `flush` quando o conteúdo controlar seus próprios recuos.
 
 Na intro, `DrawerTitle` usa a mesma escala de `PageTitle` (`1.875rem`). No header
 compacto, o título conserva a escala de `1.125rem`. O nível semântico não altera essas medidas.
+
+## Propriedades de DrawerMeta
+
+| Propriedade | Tipo | Descrição |
+| --- | --- | --- |
+| `children` | `ReactNode` | Badges, datas, autoria ou outros metadados do registro. |
+| `className` | `string` | Ajusta a faixa de metadados. |
+
+Aceita atributos nativos de `div`. O intervalo superior é de 0,75rem; os itens têm
+0,75rem entre colunas e 0,5rem entre linhas. O componente não insere separadores nem
+carrega dados. Omitir o slot não reserva espaço. Metadados não substituem orientações
+ou condições necessárias à decisão e não são anunciados como descrição do modal.

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

@@ -17,7 +17,7 @@ interface EventBusAdapter {
 }
 
 interface DomainEvent<T = unknown> {
-  type: string                                   // 'nota.emitida'
+  type: string                                   // 'invoice.issued'
   id: string
   timestamp: string
   actor: { id: string | null; type?: 'user' | 'system' | 'integration' }
@@ -39,7 +39,7 @@ const bus = mittEvents() // no mesmo processo do runtime
 ```
 
 O `mitt` entrega pelo nome exato do evento ou por `*`, que recebe todos. Padrões parciais, como
-`nota.*`, não são reconhecidos: assine `*` e filtre no handler.
+`invoice.*`, não são reconhecidos: assine `*` e filtre no handler.
 
 ## Emitir de uma action
 
@@ -51,13 +51,13 @@ const runtime = createRuntime({
   eventBus: bus,
 })
 
-export const notaEmitir = bindAction(notaEmitirContract, {
-  emits: ['nota.emitida'],
+export const invoiceIssue = bindAction(invoiceIssueContract, {
+  emits: ['invoice.issued'],
   handler: async (ctx, input) => {
-    const nota = await repo.create(input)
+    const invoice = await repo.create(input)
     // O runtime preenche id, timestamp, actor, tenant, source e trace.
-    await ctx.emit('nota.emitida', { id: nota.id, valor: nota.valor })
-    return nota
+    await ctx.emit('invoice.issued', { id: invoice.id, amount: invoice.amount })
+    return invoice
   },
 })
 ```
@@ -86,21 +86,21 @@ no código compartilhado e o efeito, no servidor:
 import { bindReaction, defineReactionContract } from '@softize/opus/core'
 
 // shared/ — qual evento e o que a reação significa.
-export const notaAvisarFinanceiro = defineReactionContract<{ id: string; valor: number }>({
-  name: 'nota.avisar-financeiro',
-  on: 'nota.emitida',
+export const invoiceNotifyFinance = defineReactionContract<{ id: string; amount: number }>({
+  name: 'invoice.notify-finance',
+  on: 'invoice.issued',
   description: 'Avisa o financeiro quando uma nota é emitida.',
 })
 
 // api/ — o efeito.
-export const notaAvisarFinanceiroImpl = bindReaction(notaAvisarFinanceiro, {
+export const invoiceNotifyFinanceImpl = bindReaction(invoiceNotifyFinance, {
   handler: async (ctx, event) => {
-    ctx.log.info('nota emitida', { id: event.data.id, valor: event.data.valor })
+    ctx.log.info('nota emitida', { id: event.data.id, amount: event.data.amount })
   },
 })
 ```
 
-Registre a reaction com as actions, em `defineDomain({ reactions: [notaAvisarFinanceiroImpl] })`
+Registre a reaction com as actions, em `defineDomain({ reactions: [invoiceNotifyFinanceImpl] })`
 ou em `runtime.register`. Com reactions registradas, o `start()` exige um `EventBusAdapter` e falha
 com `runtime.eventbus_required` quando ele não existe. `defineReaction` declara tudo num objeto só,
 quando não há separação entre cliente e servidor.

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

@@ -25,6 +25,10 @@ pnpm test
 O aplicativo inclui um domínio de tarefas, `opus.config.ts`, Vite, React, o tema do Opus e os
 comandos de teste e verificação. O dev server respeita a variável `PORT`. `opus.json` registra a
 versão do SDK adotada pelo app; `setup` materializa as instruções, skills e hooks gerenciados.
+As instruções ficam no `AGENTS.md`, que qualquer agente lê; o `CLAUDE.md` contém só a linha
+`@AGENTS.md`, que as importa para o Claude Code. Escreva as regras do seu projeto no `AGENTS.md`:
+o `setup` recusa um `CLAUDE.md` com instruções que não estão no `AGENTS.md` e pede que elas sejam
+movidas para lá.
 
 Quando os testes passarem, continue em [Primeiros passos](/docs/getting-started).
 

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

@@ -44,7 +44,7 @@ const runtime = createRuntime({
 
 // No handler: ctx.log já traz o request ID e a action, adicionados com child().
 handler: async (ctx, input) => {
-  ctx.log.info('emitindo nota', { valor: input.valor })
+  ctx.log.info('emitindo nota', { amount: input.amount })
   return repo.create(input)
 }
 ```

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

@@ -360,11 +360,28 @@ Não use `PageState` para uma falha parcial. Se outra parte da página continua
 estado na própria seção com [`DataState`](/ui/data-state), [`ActionView`](/ui/action-view),
 [`ActionList`](/ui/action-list) ou [`Alert`](/ui/alert).
 
+## Metadados junto à identidade
+
+Use `PageMeta` para badges, autoria e datas relacionados ao registro. A faixa fica
+abaixo da linha de título e ações, com espaço próprio; `PageDescription` continua
+reservado à orientação textual breve. Os itens quebram em várias linhas quando necessário.
+
+```tsx preview col
+render(
+<Page title="Manual de atendimento" description="Orientações para a equipe." meta={<><Badge>Publicado</Badge><span>Por Ana</span></>}>
+  <p>Conteúdo do manual.</p>
+</Page>
+);
+```
+
+A composição aceita um único `PageMeta` e exige um `PageTitle`. Na forma explícita, coloque-o em `PageIntro` ou no `PageHeader` compacto. Não coloque o slot solto no corpo.
+
 ## Propriedades de Page
 
 | Propriedade   | Tipo                       | Padrão      | Descrição                                                                                                                                                          |
 | ------------- | -------------------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
 | `description` | `ReactNode`                |             | Orientação opcional sob o título na forma curta.                                                                                                                   |
+| `meta` | `ReactNode` | | Forma curta: metadados sob o título e a orientação. Exige `title`. |
 | `title`       | `ReactNode`                |             | O h1 da página.                                                                                                                                                    |
 | `actions`     | `ReactNode`                |             | Ações contextuais no extremo oposto do cabeçalho.                                                                                                                  |
 | `layout`      | `'flow' \| 'fill'`         | `'flow'`    | Ocupação de altura, não anatomia: `fill` limita a página ao shell para que uma região interna role e leva essa altura até uma `ActionList` composta em `PageBody`. |
@@ -503,7 +520,7 @@ Aceita atributos HTML de `div` e exige um `PageTitle`. Recebe opcionalmente `Pag
 
 | Propriedade | Tipo                          | Descrição                                                                |
 | ----------- | ----------------------------- | ------------------------------------------------------------------------ |
-| `children`  | `ReactNode`                   | Um `PageTitle` e, opcionalmente, `PageDescription` e `PageIntroActions`. |
+| `children`  | `ReactNode`                   | Um `PageTitle` e, opcionalmente, `PageDescription`, `PageMeta` e `PageIntroActions`. |
 | `className` | `string`                      | Classes adicionais da introdução.                                        |
 | demais      | Atributos de `HTMLDivElement` | Repassados à região introdutória.                                        |
 
@@ -536,3 +553,15 @@ controla a moldura externa; em PageBody, controla o viewport.
 PageShell permite rolagem de contingência quando a rota renderiza um fallback ou um
 wrapper sem altura definida. Para manter o header fixo, a rota deve preservar a cadeia
 flexível de altura até Page. Uma Page diretamente no shell já segue esse contrato.
+
+## Propriedades de PageMeta
+
+| Propriedade | Tipo | Descrição |
+| --- | --- | --- |
+| `children` | `ReactNode` | Badges, datas, autoria ou outros metadados do registro. |
+| `className` | `string` | Ajusta a faixa de metadados. |
+
+Aceita atributos nativos de `div`. O intervalo superior é de 0,75rem; os itens têm
+0,75rem entre colunas e 0,5rem entre linhas. O componente não insere separadores nem
+carrega dados. Omitir o slot não reserva espaço. Metadados não substituem orientações
+ou condições necessárias à decisão e não substituem a descrição textual da região.

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

@@ -59,11 +59,11 @@ const runtime = createRuntime({
   queue,
 })
 
-export const relatorioGerar = bindAction(relatorioGerarContract, {
+export const reportGenerate = bindAction(reportGenerateContract, {
   background: { enabled: true, retry: { attempts: 3 }, progress: true },
   handler: async (ctx, input, loaded, progress) => {
     await progress?.report({ percent: 50, message: 'Consultando dados' })
-    return gerarRelatorio(input)
+    return generateReport(input)
   },
 })
 ```

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

@@ -76,5 +76,5 @@ o erro de uso.
 
 `navigate` espera um caminho da própria origem e não valida destinos. Quando o destino vem de fora,
 como o `?redirect=` de um pós-login, valide-o antes de navegar: resolva com
-`new URL(valor, origin)` e compare o `origin` do resultado, em vez de conferir apenas o prefixo do
+`new URL(target, origin)` e compare o `origin` do resultado, em vez de conferir apenas o prefixo do
 texto.

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

@@ -47,26 +47,26 @@ Declare o schedule com `defineSchedule` e registre-o no domínio, ao lado da act
 
 ```ts
 import { createRuntime, defineDomain, defineSchedule } from '@softize/opus/core'
-import { caixaFechar } from './caixa-fechar.ts' // a action 'caixa.fechar', preparada abaixo
+import { ledgerClose } from './ledger-close.ts' // a action 'ledger.close', preparada abaixo
 
-const fecharDia = defineSchedule({
-  name: 'caixa.fechar-dia',
-  action: 'caixa.fechar',
+const closeDay = defineSchedule({
+  name: 'ledger.close-day',
+  action: 'ledger.close',
   cron: '0 23 * * *',
   timezone: 'America/Sao_Paulo',
 })
 
-export const caixaDomain = defineDomain({
-  name: 'caixa',
-  actions: { caixaFechar },
-  schedules: [fecharDia],
+export const ledgerDomain = defineDomain({
+  name: 'ledger',
+  actions: { ledgerClose },
+  schedules: [closeDay],
 })
 
 const runtime = createRuntime({
   // …server/data…
   scheduler,
 })
-runtime.register([caixaDomain])
+runtime.register([ledgerDomain])
 await runtime.start()
 ```
 
@@ -91,18 +91,18 @@ recusa o sistema até que o contrato dela aceite essa execução com `automatabl
 ```ts
 import { defineContract, isSystemActor } from '@softize/opus/core'
 
-export const caixaFecharContract = defineContract({
-  name: 'caixa.fechar',
+export const ledgerCloseContract = defineContract({
+  name: 'ledger.close',
   kind: 'simple',
   input: z.object({}),
-  output: z.object({ fechados: z.number() }),
+  output: z.object({ closedEntries: z.number() }),
   automatable: true,
 })
 
-export const caixaFechar = bindAction(caixaFecharContract, {
+export const ledgerClose = bindAction(ledgerCloseContract, {
   // O sistema não tem permissões: aceite-o de forma explícita ao lado da regra das pessoas.
-  authorize: (ctx) => isSystemActor(ctx) || ctx.can('caixa:fechar'),
-  handler: async (ctx) => ({ fechados: await caixa.fecharDia() }),
+  authorize: (ctx) => isSystemActor(ctx) || ctx.can('ledger:close'),
+  handler: async (ctx) => ({ closedEntries: await ledger.closeDay() }),
 })
 ```