@softize/opus 26.2.0 → 27.0.0

package/CHANGELOG.md

@@ -7,6 +7,45 @@ Depois de qualquer bump, rode os gates (`typecheck` · `test` · `opus check` ·
 `opus copy --check` · `base copy check` · `manifest:check`) — eles apontam o que a
 mudança cobra do seu código.
 
+## 27.0.0 — 2026-10-13
+
+O aplicativo passa a saber, na recusa de um anexo, o que entrou na mesma ação, e o glob do runtime
+de design passa a seguir a semântica usual de `**`. A seção **Breaking** traz as migrações, que
+atingem só quem chama `onReject` diretamente ou passa um handler com um segundo parâmetro opcional de
+outro tipo.
+
+- **Recusa com os aceitos da mesma ação.** `ComposerAttachments.onReject` recebe um segundo
+  argumento, `ComposerRejectionContext`, com `accepted`: os arquivos aceitos na mesma escolha,
+  colagem ou soltura, ou uma lista vazia quando nada passou. Assim o aplicativo explica uma soltura
+  mista, como uma imagem e um PDF arrastados juntos, sem guardar estado entre as duas chamadas. O
+  tipo `ComposerRejectionContext` sai de `@softize/opus/ui/react`.
+- **Ordem das chamadas documentada.** Em uma ação com arquivos aceitos e recusados, `onAddFiles`
+  roda antes de `onReject`, de forma síncrona e uma vez cada. O mesmo vale para o soltar sobre a
+  conversa do `Chat`. A ordem já era essa; agora faz parte do contrato.
+- **`**` casa zero ou mais pastas no glob de `opusDesign`.** Em `entry` e `scenarios`, `**` como
+  pasta inteira segue a semântica usual. Antes, `design/scenarios/**/*.ts` exigia pelo menos uma
+  subpasta e ignorava, sem aviso, o cenário salvo direto em `design/scenarios/`. Um projeto com
+  `**/` no padrão pode passar a carregar arquivos que antes ficavam de fora; se dois cenários da
+  mesma action passarem a entrar, o runtime de design deixa de subir e o erro lista a action.
+- **`?` literal no glob.** Antes, o `?` virava quantificador de regex, e `design/*/a?.ts` casava
+  `design/x/.ts`. Os demais padrões sem `**` continuam casando os mesmos arquivos.
+
+### Breaking
+
+**O contexto de `onReject` é obrigatório na assinatura.** Quem implementa o callback com um só
+parâmetro não muda nada. Duas situações deixam de compilar:
+
+- quem chama `onReject` diretamente, como ao reaproveitar o tipo `ComposerAttachments` em uma área de
+  soltar própria. Migração: passe `{ accepted }`, com uma lista vazia quando nada foi aceito:
+
+  ```ts
+  // antes: attachments.onReject?.(rejected)
+  attachments.onReject?.(rejected, { accepted })
+  ```
+
+- quem passa direto um handler que já declarava um segundo parâmetro opcional de outro tipo. Migração:
+  envolva o handler, como em `(rejections) => handle(rejections)`.
+
 ## 26.2.0 — 2026-10-09
 
 Portais podem organizar capítulos em subgrupos e abrir ferramentas relacionadas sem substituir

package/docs/adr/0058-mensagem-da-ia-aceita-imagem-e-o-chat-recebe-anexos.md

@@ -116,6 +116,18 @@ imagem. Assim, retenção, expiração, governança e dado pessoal ficam com que
   imagem, e `ChatMessage` continua só com texto. Se um consumidor precisar, uma nova decisão define
   como.
 
+> **Emenda — 2026-10-13:** a ordem entre as duas chamadas da triagem passa a ser garantida. Em uma
+> mesma escolha, colagem ou soltura com arquivos aceitos e recusados, `onAddFiles` roda antes de
+> `onReject`, de forma síncrona e uma vez cada, também no soltar sobre a conversa do `Chat`.
+> `onReject` recebe um segundo argumento, `context: ComposerRejectionContext`, cujo `accepted`
+> traz os arquivos aceitos na mesma ação, ou uma lista vazia quando nada passou. Com ele, o app
+> explica uma soltura mista sem guardar estado entre as duas chamadas; a adoção pela Grand Brasil
+> mostrou a necessidade. O contexto é obrigatório na assinatura: opcional, ele obrigaria quem
+> desestrutura `{ accepted }` a tratar `undefined`, embora o composer sempre o informe. Quem
+> implementa o callback com um só parâmetro não muda nada; quem chama `onReject` diretamente precisa
+> passar o contexto, e um handler com segundo parâmetro opcional de outro tipo precisa ser envolvido.
+> Por essas migrações, a mudança saiu como major, na 27.0.0.
+
 ### 6. Preparação da imagem no navegador
 
 `prepareImage(file, options)` prepara a imagem antes do envio, com os tetos que o app passa:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@softize/opus",
-  "version": "26.2.0",
+  "version": "27.0.0",
   "description": "End-to-end action protocol for TypeScript. Single package with subpath exports (core + adapters).",
   "license": "MIT",
   "type": "module",

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

@@ -29,14 +29,25 @@ export interface ComposerFileRejection {
   reason: "type" | "limit";
 }
 
+/** O que mais aconteceu na mesma ação (escolher, colar ou soltar) que gerou as recusas. */
+export interface ComposerRejectionContext {
+  /** Arquivos aceitos na mesma ação, já entregues a `onAddFiles`; vazio quando nenhum passou. */
+  accepted: File[];
+}
+
 /**
  * Anexos da mensagem, controlados pelo app (ADR 0058). O composer faz a triagem e mostra a faixa;
  * preparar, enviar, guardar e limpar depois do envio são do app, que é o dono do transporte.
+ *
+ * Em uma mesma ação com arquivos aceitos e recusados, `onAddFiles` é chamado antes de `onReject`,
+ * de forma síncrona e uma vez cada. Ação sem aceito não chama `onAddFiles`; sem recusado, não
+ * chama `onReject`.
  */
 export interface ComposerAttachments {
   /** Anexos pendentes, na ordem em que aparecem na faixa. */
   items: ComposerAttachment[];
-  /** Recebe os arquivos aceitos pela triagem — do botão, do colar ou do soltar. */
+  /** Recebe os arquivos aceitos pela triagem — do botão, do colar ou do soltar. Na mesma ação,
+   *  roda antes de `onReject`. */
   onAddFiles: (files: File[]) => void;
   /** A pessoa removeu um anexo da faixa. */
   onRemove: (id: string) => void;
@@ -46,8 +57,10 @@ export interface ComposerAttachments {
    *  Não há curinga (`image/*`): a triagem compara o tipo exato do arquivo. */
   accept?: readonly AiImageMediaType[];
   /** Recebe os arquivos recusados. Presente, a explicação da recusa é do app; ausente, o
-   *  composer a mostra acima do campo. */
-  onReject?: (rejections: ComposerFileRejection[]) => void;
+   *  composer a mostra acima do campo. Roda depois de `onAddFiles` na mesma ação, e
+   *  `context.accepted` traz os arquivos aceitos nela (vazio quando nenhum passou) — o app
+   *  distingue "nada entrou" de "parte entrou" sem guardar estado entre as duas chamadas. */
+  onReject?: (rejections: ComposerFileRejection[], context: ComposerRejectionContext) => void;
 }
 
 /** Limite padrão de anexos por mensagem. */
@@ -296,7 +309,8 @@ export function Composer({
   const twoRow = actions !== undefined || attachments !== undefined;
 
   /** Triagem: tipo aceito e espaço na mensagem. Os aceitos vão ao app; os recusados, ao
-   *  `onReject` do app ou ao aviso do composer. */
+   *  `onReject` do app ou ao aviso do composer. A ordem (aceitos antes, recusados depois, com os
+   *  aceitos no contexto) é contrato público de `ComposerAttachments`. */
   const intake = (files: File[]): void => {
     if (attachments === undefined || files.length === 0) return;
     const remaining = Math.max(0, max - items.length);
@@ -309,7 +323,7 @@ export function Composer({
     }
     if (accepted.length > 0) attachments.onAddFiles(accepted);
     if (rejected.length > 0 && attachments.onReject !== undefined) {
-      attachments.onReject(rejected);
+      attachments.onReject(rejected, { accepted });
       setNotice(null);
     } else {
       setNotice(rejected.length > 0 ? rejectionMessage(rejected, accept, max) : null);

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

@@ -321,9 +321,11 @@ export const eventDetail = defineDesignScenario(eventGet, (input) => ({
 
 A resposta é tipada pela entrada e pela saída do contrato; em `list`, é a página inteira. Informe ao
 plugin onde os cenários estão, com caminhos ou globs:
-`opusDesign({ scenarios: 'design/scenarios/*.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.
+`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
+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.
 
 O Opus não decide onde os cenários ficam nem se entram no repositório. Eles não fazem parte da
 aplicação: podem ficar em uma pasta ignorada pelo git e ser escritos durante a sessão de design,

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

@@ -261,6 +261,11 @@ O arraste de arquivos sobre a conversa é consumido pelo Chat e não sobe para o
 aplicativo: um contêiner com o próprio soltar, como uma área de envio de arquivos, não recebe a mesma
 imagem duas vezes. Sem `composerAttachments`, o arraste segue para o contêiner, como antes.
 
+O soltar sobre a conversa passa pela mesma triagem do composer. Quando ele traz imagens aceitas e
+arquivos recusados juntos, `onAddFiles` recebe as imagens primeiro, e `onReject`, quando presente,
+recebe os recusados logo depois, com as imagens da mesma ação em `accepted`. Veja
+[recusas no Composer](/ui/composer#com-imagens-anexadas).
+
 ## Propriedades de Chat
 
 | Propriedade | Tipo | Padrão | Descrição |

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

@@ -143,6 +143,23 @@ curinga como `image/*`. O que fica de fora é explicado acima do campo, como “
 Para dar outra explicação, passe `onReject`: o composer deixa de mostrar o aviso e entrega os
 arquivos recusados, com o motivo, ao aplicativo.
 
+Uma mesma escolha, colagem ou soltura pode trazer arquivos aceitos e recusados, como uma imagem e um
+PDF arrastados juntos. O segundo argumento de `onReject`, do tipo `ComposerRejectionContext`, traz
+em `accepted` os aceitos da mesma ação, e a lista vem vazia quando nada passou. Em uma ação mista,
+`onAddFiles` roda antes de `onReject`. Assim o aplicativo explica a recusa conforme o resultado, sem
+guardar estado entre as duas chamadas:
+
+```ts
+const onReject: ComposerAttachments['onReject'] = (rejections, { accepted }) => {
+  const names = rejections.map((r) => r.file.name).join(', ')
+  notify(
+    accepted.length > 0
+      ? `Parte dos arquivos foi anexada. Ficaram de fora: ${names}.`
+      : `Nenhum arquivo foi anexado. Ficaram de fora: ${names}.`,
+  )
+}
+```
+
 Colar texto continua colando texto, mesmo quando a área de transferência também traz uma imagem, como
 ao copiar células de uma planilha. Uma imagem colada sem texto, como um print, recebe um nome que a
 pessoa reconhece na conversa: “Imagem colada 1.png”. A numeração não volta atrás: remover a primeira e
@@ -197,11 +214,11 @@ mesmos que o servidor confere.
 | Propriedade | Tipo | Padrão | Descrição |
 |---|---|---|---|
 | `items` | `ComposerAttachment[]` | | Imagens anexadas à mensagem que está sendo escrita, na ordem da faixa. |
-| `onAddFiles` | `(files: File[]) => void` | | Recebe os arquivos aceitos pela triagem, vindos do botão, do colar ou do soltar. |
+| `onAddFiles` | `(files: File[]) => void` | | Recebe os arquivos aceitos pela triagem, vindos do botão, do colar ou do soltar. Em uma ação com aceitos e recusados, é chamado antes de `onReject`. |
 | `onRemove` | `(id: string) => void` | | A pessoa removeu uma imagem da faixa; o foco volta ao campo. |
 | `max` | `number` | `4` | Limite de imagens por mensagem. O botão de anexar fica desabilitado quando ele é atingido. |
 | `accept` | `readonly AiImageMediaType[]` | PNG, JPEG e WebP | Formatos aceitos pelo botão e pela triagem, comparados com o tipo exato do arquivo. |
-| `onReject` | `(rejections: ComposerFileRejection[]) => void` | | Recebe os arquivos recusados, com o motivo `type` ou `limit`. Sem ele, o composer explica a recusa acima do campo. |
+| `onReject` | `(rejections: ComposerFileRejection[], context: ComposerRejectionContext) => void` | | Recebe os arquivos recusados, com o motivo `type` ou `limit`, depois de `onAddFiles`; `context.accepted` (`File[]`) traz os arquivos aceitos na mesma ação e vem vazio quando nenhum passou. Sem ele, o composer explica a recusa acima do campo. |
 
 `ComposerAttachment` é `{ id, name, status, previewUrl?, error? }`. `status` vale `uploading`,
 `ready` ou `failed`; `previewUrl` é o endereço da miniatura e `error` é o motivo mostrado quando a

package/src/ui/react.tsx

@@ -73,6 +73,7 @@ export type {
   ComposerAttachmentStatus,
   ComposerAttachments,
   ComposerFileRejection,
+  ComposerRejectionContext,
 } from "./components/primitives/composer.tsx";
 // Preparação da imagem no navegador antes do envio (ADR 0058).
 export { prepareImage } from "./lib/prepare-image.ts";

package/src/vite/design.ts

@@ -82,7 +82,9 @@ export interface OpusDesignOptions {
    * CADA rebuild — domínio novo entra no ar ao salvar o arquivo, sem editar
    * entry nenhum. Dos módulos casados entram os exports (default e named) com
    * shape de registrável; schemas/helpers exportados junto ficam de fora.
-   * Pode misturar estáticos e globs no array.
+   * Pode misturar estáticos e globs no array. No glob, `*` casa parte de um
+   * nome dentro de uma pasta e `**` casa zero ou mais pastas:
+   * 'design/scenarios/**\/*.ts' inclui o arquivo solto em `design/scenarios/`.
    */
   entry?: string | string[]
 
@@ -531,17 +533,33 @@ async function loadGlobEntry(server: ViteDevServer, pattern: string): Promise<un
 }
 
 /**
- * Matcher próprio de propósito (sem dep nova): `*` casa um segmento (sem '/'),
- * `**` casa qualquer profundidade. Cobre o entry por pasta de domínio; padrão
- * exótico não suportado = aponte entries estáticos.
+ * Matcher próprio de propósito (sem dep nova): `*` casa parte de um segmento
+ * (sem '/'); `**` como segmento inteiro é globstar e casa zero ou mais pastas
+ * — `design/**\/*.ts` casa `design/a.ts`, `design/x/a.ts` e `design/x/y/a.ts`.
+ * No fim do padrão (`design/**`), casa qualquer arquivo abaixo da pasta. Cobre o
+ * entry por pasta de domínio e os cenários; padrão exótico não suportado =
+ * aponte entries estáticos.
+ *
+ * Exportada só para teste: o índice de `@softize/opus/vite` não a reexporta.
  */
-function globToRegExp(pattern: string): RegExp {
-  const escaped = pattern.replace(/[.+^${}()|[\]\\]/g, '\\$&')
-  // `\u0000` como placeholder do `**`: nunca ocorre num path real.
-  const body = escaped
-    .replace(/\*\*/g, '\u0000')
-    .replace(/\*/g, '[^/]*')
-    .replace(/\u0000/g, '.*')
+export function globToRegExp(pattern: string): RegExp {
+  const segments = pattern.split('/')
+  const body = segments
+    .map((segment, index) => {
+      const last = index === segments.length - 1
+      // Globstar no começo ou no meio: o grupo opcional leva a barra junto, então
+      // "nenhuma pasta" casa sem exigir `//` no path.
+      if (segment === '**') return last ? '.*' : '(?:.*/)?'
+      const escaped = segment.replace(/[.+?^${}()|[\]\\]/g, '\\$&')
+      // `**` colado a outro texto no segmento (`a**`) mantém o comportamento
+      // anterior: qualquer sequência. `\u0000` é placeholder: nunca ocorre num path.
+      const converted = escaped
+        .replace(/\*\*/g, '\u0000')
+        .replace(/\*/g, '[^/]*')
+        .replace(/\u0000/g, '.*')
+      return last ? converted : `${converted}/`
+    })
+    .join('')
   return new RegExp(`^${body}$`)
 }