@praxisui/list 9.0.11 → 9.0.13

package/package.json

@@ -1,19 +1,19 @@
 {
   "name": "@praxisui/list",
-  "version": "9.0.11",
+  "version": "9.0.13",
   "description": "List components and helpers for Praxis UI.",
   "peerDependencies": {
     "@angular/common": "^21.0.0",
     "@angular/core": "^21.0.0",
     "@angular/material": "^21.0.0",
-    "@praxisui/dynamic-fields": "^9.0.11",
+    "@praxisui/dynamic-fields": "^9.0.13",
     "rxjs": ">=7 <9",
     "@angular/forms": "^21.0.0",
     "@angular/router": "^21.0.0",
-    "@praxisui/ai": "^9.0.11",
-    "@praxisui/core": "^9.0.11",
-    "@praxisui/rich-content": "^9.0.11",
-    "@praxisui/settings-panel": "^9.0.11"
+    "@praxisui/ai": "^9.0.13",
+    "@praxisui/core": "^9.0.13",
+    "@praxisui/rich-content": "^9.0.13",
+    "@praxisui/settings-panel": "^9.0.13"
   },
   "dependencies": {
     "tslib": "^2.3.0",

package/src/lib/praxis-list.json-api.md

@@ -447,6 +447,7 @@ Regras operacionais:
 - Em erro no `/filter` com critérios ativos, falha fechado: mantém o contexto de filtro, zera o resultado, publica `ListRemoteLoadError` em `ListDataService.error$` e oferece nova tentativa. Dados sem filtro nunca substituem silenciosamente a consulta solicitada.
 - Busca (`ui.showSearch`) aplica debounce de `300ms` e exige `ui.searchField`.
 - Busca, ordenação e exportação compartilham a toolbar superior da coleção; paginação permanece no footer. Busca, ordenação e paginação remotas aparecem apenas quando o modo resolvido é `remote`, nunca quando `data` local tem precedência sobre `resourcePath`.
+- Filtros estruturados não são reimplementados pela lista: `praxis-filter` compõe os controles inline existentes de `@praxisui/dynamic-fields` e projeta o DTO governado em `queryContext`.
 - Em viewport estreito, `layout.rowLayout` recompõe os slots semânticos canônicos (`leading`, `primary`, `secondary`, `meta`, `trailing`) em linhas ordenadas sem sobreposição; slots operacionais estendidos são empilhados no owner da lista, sem CSS corretivo no host.
 - Atualizações síncronas de query, ordenação e página materializadas pelo mesmo `queryContext` são coalescidas antes do acesso HTTP; o backend recebe somente o estado final consistente.
 - `ListDataService.error$` é um `Observable<ListRemoteLoadError | null>` somente leitura; consumidores podem reagir e solicitar `refresh()`, mas não publicar estados de erro no serviço.
@@ -460,6 +461,18 @@ Matriz de decisao (runtime atual):
 | `null/undefined`  | preenchido                | `remote`       | lista/cards/tiles + toolbar e paginação | `filter(query, pageable)`; fallback `getAll()` somente sem critérios ativos |
 | `null/undefined`  | vazio/ausente             | `empty`        | empty state                             | sem pipeline de dados                                                       |
 
+Anatomia recomendada da coleção corporativa:
+
+| Região | Conteúdo canônico | Regra de integração |
+| ------ | ----------------- | ------------------- |
+| Filtros estruturados | `praxis-filter` + fields inline de `@praxisui/dynamic-fields` | Antes da toolbar, no mesmo contexto visual; o DTO entra por `queryContext`. |
+| Toolbar superior | busca rápida, `ui.sortOptions`, exportação e comandos de coleção | Busca lidera; ordenação e comandos ficam agrupados no final. |
+| Item | ações cujo alvo é somente aquele registro | Permanecem no slot de ações do item. |
+| Ações de seleção | ações em lote derivadas de `selectionChange` | Barra composta próxima ao cabeçalho da coleção; nunca dentro do paginator. |
+| Footer | tamanho de página, range e navegação | Sem filtros, ordenação ou ações de negócio. |
+
+`ui.showSort` é opcional. Use quando o usuário realmente precisa comparar ou priorizar itens em outra ordem; omita quando a ordem é fixa ou existe somente uma ordenação significativa. Os labels de `ui.sortOptions` devem ser legíveis no domínio e não expor diretamente `field,direction`.
+
 Regra critica de autoria:
 
 - Se o host enviar `data` e `resourcePath` ao mesmo tempo, o runtime usa `data` (modo local).