@softize/opus 18.2.0 → 18.3.0

package/CHANGELOG.md

@@ -7,6 +7,24 @@ 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.
 
+## 18.3.0 — 2026-09-17
+
+`ActionList` passa a oferecer composição previsível para barras densas: filtros inline de valor
+único abraçam o conteúdo até o limite da barra, a busca ocupa o espaço flexível restante, dropdowns
+podem ser mais largos que o controle e filtros pesquisáveis podem omitir a opção vazia. Valores de
+repouso, ícones por filtro, agrupamento de tipo de data com período e ícones nas seções avançadas
+ficam declarados pelas props do pattern. A barra deixa de transformar filtros inline em chips por
+falta de espaço; a página preserva sua largura mínima e delega o overflow à superfície correta.
+
+Listagens podem usar `layout="fill"` para ocupar a altura disponível e manter a rolagem dentro da
+tabela, com cabeçalho fixo e a mesma moldura nos estados vazio, carregando e erro. `Page` e
+`Presentation` propagam esse contrato sem criar uma segunda rolagem no frame.
+
+`MetricCard` aceita `secondaryMetric` para uma leitura complementar diretamente relacionada,
+exibida como lâmina posterior com explicação própria. `FieldLegend` aceita ícone e a variante
+`section`; o `Select` equaliza a ação de limpar com os demais campos e permite que sua lista cresça
+além do gatilho sem alterar o layout.
+
 ## 18.2.0 — 2026-09-16
 
 `Presentation` passa a aceitar um body serializável baseado em componente. O contrato continua

package/package.json

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

package/registry/skills/build-opus-ui/SKILL.md

@@ -37,8 +37,9 @@ existentes, mantendo navegação observável e componentes reutilizáveis sem la
    permanece sempre presente.
 6. Deixar ausência, paginação e largura de filtro com o pattern: célula e `DetailField` já
    representam valor ausente (`EmptyValue`, `empty` para o significado do domínio); listas
-   paginam pela primitiva `Pagination`; selects inline de filtro têm largura fixa. Não reescrever
-   esses defaults na tela.
+   paginam pela primitiva `Pagination`; selects inline de valor único abraçam o valor até o limite
+   definido pela barra, e o menu pode ser mais largo que o controle. Não reescrever esses defaults
+   na tela.
 7. Tratar página, filtro, seleção e modal importante como estado navegável por URL quando
    o produto precisa de deep link, back/forward ou refresh. Em `Presentation`, declarar `route`
    no artefato e deixar o adaptador apenas conectar a spec ao router da aplicação.

package/registry/skills/build-opus-ui/references/ui-patterns.md

@@ -122,9 +122,10 @@ ContentDescription, ContentMeta, ContentActions) + ContentBody`. `ContentHeader`
 - Paginação é a primitiva `Pagination`, inclusive dentro de `ActionList`. Número de página tem
   largura mínima e cresce com os dígitos; só as setas são quadradas. Não montar paginador com
   `Button` nem prender números a `size-*`.
-- Select inline de filtro tem largura fixa (`w-40`; lookup e múltiplo `w-52`): a label trunca, o
-  valor trunca no trigger e a opção inteira fica na lista. Não dimensionar filtro pelo conteúdo
-  nem pela label; o modal usa `w-full`.
+- Select inline de valor único abraça o valor selecionado até `max-w-80`. Acima desse limite, o
+  valor trunca no gatilho e a opção inteira permanece na lista, que pode ser mais larga.
+  Multiseleção mantém `w-52`; o modal usa `w-full`. Não recalcular essa largura na tela nem
+  dimensioná-la pela label do filtro.
 - Catálogo e API efetivos vêm dos exports da versão instalada, não de memória ou exemplo antigo.
 - Em componentes semânticos, `context` responde por que há destaque e `variant` responde como ele
   aparece. O vocabulário canônico é `neutral | primary | info | success | warning | danger`; as

package/src/core/errors.ts

@@ -93,7 +93,6 @@ class ActionErrorImpl extends Error implements ActionError {
   readonly i18nParams?: Record<string, unknown>
   readonly field?: string
   readonly issues?: ValidationIssue[]
-  override readonly cause?: unknown
   readonly meta?: Record<string, unknown>
 
   constructor(input: ErrorInput) {

package/src/core/types.ts

@@ -598,6 +598,10 @@ export interface FilterSpec {
 
   type: 'text' | 'select' | 'lookup' | 'date' | 'number'
   multiple?: boolean
+  /** Habilita busca local nas opções de um `select`; `lookup` já é pesquisável por natureza. */
+  searchable?: boolean
+  /** Quando `false`, a interface omite a opção vazia. Limpar restaura o default do filtro. */
+  allowEmpty?: boolean
   mode?: 'server' | 'client'
   operators?: FilterOp[]
   path?: string

package/src/ui/components/patterns/data-state.tsx

@@ -75,7 +75,7 @@ export function DataState({
   if (colSpan !== undefined) {
     return (
       <tr data-slot="data-state" data-status={status}>
-        <td colSpan={colSpan} className="px-4 py-4 text-center text-sm">
+        <td colSpan={colSpan} className="px-4 py-4 text-center align-middle text-sm">
           {surface}
         </td>
       </tr>