@praxisui/list 8.0.0-beta.99 → 9.0.0-beta.0

package/package.json

@@ -1,19 +1,19 @@
 {
   "name": "@praxisui/list",
-  "version": "8.0.0-beta.99",
+  "version": "9.0.0-beta.0",
   "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": "^8.0.0-beta.99",
+    "@praxisui/dynamic-fields": "^9.0.0-beta.0",
     "rxjs": ">=7 <9",
     "@angular/forms": "^21.0.0",
     "@angular/router": "^21.0.0",
-    "@praxisui/ai": "^8.0.0-beta.99",
-    "@praxisui/core": "^8.0.0-beta.99",
-    "@praxisui/rich-content": "^8.0.0-beta.99",
-    "@praxisui/settings-panel": "^8.0.0-beta.99"
+    "@praxisui/ai": "^9.0.0-beta.0",
+    "@praxisui/core": "^9.0.0-beta.0",
+    "@praxisui/rich-content": "^9.0.0-beta.0",
+    "@praxisui/settings-panel": "^9.0.0-beta.0"
   },
   "dependencies": {
     "tslib": "^2.3.0",

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

@@ -30,8 +30,8 @@ source_of_truth:
   - "projects/praxis-list/src/lib/ai/list-ai.adapter.ts"
   - "projects/praxis-list/src/lib/ai/list-ai-capabilities.ts"
   - "projects/praxis-list/src/lib/ai/list-context-pack.ts"
-source_of_truth_last_verified: "2026-03-19"
-last_updated: "2026-03-19"
+source_of_truth_last_verified: "2026-06-14"
+last_updated: "2026-06-14"
 toc: true
 sidebar: true
 tags:
@@ -245,13 +245,13 @@ config explícita -> config persistida por chave -> config corrente em memória
 - `applyAuthoringPayload()` faz parse, validação, apply plan e executor runtime sem recriar componente.
 - `buildListApplyPlan(...)` também carrega a decisão explícita de inferência de schema; o host só executa essa etapa fina sem inferir a partir de estado runtime arbitrário.
 - `setupSelectionBinding()` adapta shape de seleção para retorno declarativo.
-- `executeSchemaInferenceForPlan()` infere templates apenas quando faltantes e sem sobrescrever contrato explícito.
+- `executeSchemaInferenceForPlan()` infere templates quando faltantes ou quando slots de demonstracao nao estao aterrados nos campos publicados pelo schema do recurso.
 
 ### Precedence rules
 
 - config externa mais recente tem precedência sobre hidratação tardia de storage.
 - editor `saved` persiste e reaplica; `applied` reaplica sem persistir obrigatoriamente.
-- quando `listId` ausente, runtime segue sem persistência e emite warning deduplicado.
+- quando `listId` ausente, runtime segue sem persistencia e sem warning operacional; a lista continua renderizando e editando normalmente.
 
 ## Validation and error semantics
 
@@ -259,7 +259,7 @@ config explícita -> config persistida por chave -> config corrente em memória
 
 | Path/Rule                          | Validation phase        | Behavior on fail              | Error code / warning                     | Notes                                            |
 | ---------------------------------- | ----------------------- | ----------------------------- | ---------------------------------------- | ------------------------------------------------ |
-| `listId` para persistência         | init/runtime            | warning + disable persistence | `praxis-list:missing-list-id`            | Lista continua funcional sem restore/save.       |
+| `listId` para persistência         | init/runtime            | disable persistence silently  | n/a                                      | Lista continua funcional sem restore/save.       |
 | Json Logic `showIf` inválido       | runtime evaluate        | warning + fallback false      | `praxis-list:invalid-show-if`            | Evita render incorreto por condição malformada. |
 | `GlobalActionService` indisponível | runtime action dispatch | warning + skip comando global | `praxis-list:global-command-unavailable` | Não interrompe ações locais/emissão de eventos.  |
 | inferência de schema falha         | startup/runtime         | ignore error                  | n/a                                      | Mantém configuração original sem inferência.     |
@@ -443,6 +443,7 @@ Regras operacionais:
 - Em erro no `/filter`, faz fallback para `getAll()` com warning deduplicado.
 - Busca (`ui.showSearch`) aplica debounce de `300ms` e exige `ui.searchField`.
 - Controles de pagina/sort/search no template aparecem apenas quando `dataSource.resourcePath` esta definido.
+- Quando nao ha `dataSource.data` nem `dataSource.resourcePath`, o runtime renderiza um empty state operacional orientando a conexao da lista a um recurso.
 
 Matriz de decisao (runtime atual):
 
@@ -469,7 +470,7 @@ Regra critica de autoria:
 Sem `listId` valido:
 
 - persistencia e ignorada;
-- warning ocorre em dev mode (`LoggerService.warnOnce`).
+- nao ha warning; hosts de authoring dinamico podem renderizar e editar sem identidade persistente.
 
 #### PraxisListConfig top-level
 
@@ -612,7 +613,13 @@ Slots suportados:
 
 Tipos funcionais no runtime:
 
-- `text`, `icon`, `image`, `chip`, `rating`, `currency`, `date`, `html`.
+- `text`, `icon`, `image`, `chip`, `rating`, `currency`, `date`, `html`, `metric`, `compose`, `component`.
+
+Inferencia opcional:
+
+- Quando `dataSource.resourcePath` existe, `GenericCrudService.getSchema()` retorna campos e o runtime pode inferir uma materializacao inicial sem alterar o contrato canonico.
+- A inferencia prioriza identidade (`nomeCompleto/name`), avatar (`foto/avatar/photo/image`), contato (`telefone/email` ou `cpf/email`), agrupamento organizacional (`departamento/area/time`) e status (`status/ativo`) usando os slots existentes.
+- Slots de demonstracao que referenciam campos ausentes no schema do recurso sao descartados antes da inferencia. Campos tecnicos ou numericos como `id`, `idade`, `age`, `ativo/status` nao sao promovidos para `meta` por inferencia.
 
 Tipo declarado sem renderer dedicado:
 

package/types/praxisui-list.d.ts

@@ -1,7 +1,7 @@
 import * as rxjs from 'rxjs';
 import { BehaviorSubject, Observable } from 'rxjs';
 import * as i0 from '@angular/core';
-import { OnInit, OnChanges, OnDestroy, EventEmitter, SimpleChanges, ChangeDetectorRef, DoCheck, AfterViewInit, Provider } from '@angular/core';
+import { OnInit, OnChanges, AfterViewInit, OnDestroy, EventEmitter, SimpleChanges, ChangeDetectorRef, DoCheck, Provider } from '@angular/core';
 import { MatSelectionListChange } from '@angular/material/list';
 import { MatPaginatorSelectConfig, PageEvent } from '@angular/material/paginator';
 import { FormGroup, FormControl } from '@angular/forms';
@@ -457,7 +457,7 @@ interface ListCardDetailSlotViewModel {
     label: string;
     node: Record<string, any>;
 }
-declare class PraxisList implements OnInit, OnChanges, OnDestroy {
+declare class PraxisList implements OnInit, OnChanges, AfterViewInit, OnDestroy {
     private static nextSkinScopeId;
     private customizationEnabled;
     private readonly hostLocale;
@@ -526,7 +526,7 @@ declare class PraxisList implements OnInit, OnChanges, OnDestroy {
     private readonly route;
     private readonly globalActions;
     private readonly dialog;
-    private warnedMissingId;
+    private hasViewInitialized;
     private hasHydratedPersistence;
     private hydratedPersistenceKey;
     private hydratingPersistenceKey;
@@ -542,7 +542,9 @@ declare class PraxisList implements OnInit, OnChanges, OnDestroy {
     exportStatusMessage: string;
     private readonly listRuleContextOptions;
     ngOnInit(): void;
+    ngAfterViewInit(): void;
     ngOnChanges(changes: SimpleChanges): void;
+    private hasListIdentityInput;
     ngOnDestroy(): void;
     private applyPersistence;
     private initializeDataStreams;
@@ -663,6 +665,7 @@ declare class PraxisList implements OnInit, OnChanges, OnDestroy {
     expandToggleAriaLabel(item: any, index: number): string;
     expansionRegionAriaLabel(item: any): string;
     emptyStateLabel(): string;
+    isResourceConnectionMissing(): boolean;
     onActionClick(ev: MouseEvent, actionId: string, item: any, index: number): Promise<void>;
     private resolveActionPayload;
     private resolveTemplate;
@@ -745,7 +748,6 @@ declare class PraxisList implements OnInit, OnChanges, OnDestroy {
     private executeListEditorApplyPlan;
     private storageKey;
     private componentKeyId;
-    private warnMissingId;
     private readonly crud;
     private executeSchemaInferenceForPlan;
     private evalSlot;
@@ -1579,9 +1581,9 @@ declare function buildListApplyPlan(doc: ListAuthoringDocument, runtime?: ListRu
 declare function serializeListAuthoringDocument(doc: ListAuthoringDocument): unknown;
 
 /**
- * Infer templating slots (primary/secondary/trailing) from field names.
+ * Infer templating slots from field names already exposed by the canonical schema.
  * - Does not override existing primary if already defined.
- * - Heuristics prioritize Portuguese labels, then common English names.
+ * - Heuristics prioritize common corporate/person records without creating a domain-specific preset.
  */
 declare function inferTemplatingFromSchema(cfg: PraxisListConfig, fieldNames: string[]): PraxisListConfig;
 
@@ -1986,6 +1988,7 @@ declare const PRAXIS_LIST_EN_US: {
     readonly collapseDetails: "Collapse details";
     readonly itemDetails: "Item details";
     readonly emptyState: "No items available";
+    readonly emptyStateConnectResource: "Connect this list to a resource to load items.";
     readonly 'pagination.itemsPerPage': "Items per page:";
     readonly 'pagination.nextPage': "Next page";
     readonly 'pagination.previousPage': "Previous page";
@@ -2003,6 +2006,11 @@ declare const PRAXIS_LIST_EN_US: {
     readonly 'Assistant-applied adjustments replace the entire configuration object.': "Assistant-applied adjustments replace the entire configuration object.";
     readonly 'applyConfigFromAdapter does not perform a deep merge. Make sure the adapter sends the full config.': "applyConfigFromAdapter does not perform a deep merge. Make sure the adapter sends the full config.";
     readonly 'Resource (API)': "Resource (API)";
+    readonly 'List resource': "List resource";
+    readonly 'Select resource': "Select resource";
+    readonly 'Hide resource selector': "Hide selector";
+    readonly 'Select resource from catalog': "Select resource from catalog";
+    readonly 'Select list resource': "Select list resource";
     readonly 'e.g.: users': "e.g.: users";
     readonly 'Resource endpoint (resourcePath).': "Resource endpoint (resourcePath).";
     readonly 'Query (JSON)': "Query (JSON)";
@@ -2221,6 +2229,7 @@ declare const PRAXIS_LIST_PT_BR: {
     readonly collapseDetails: "Recolher detalhes";
     readonly itemDetails: "Detalhes do item";
     readonly emptyState: "Nenhum item disponível";
+    readonly emptyStateConnectResource: "Conecte a lista a um recurso para carregar os itens.";
     readonly 'pagination.itemsPerPage': "Itens por página:";
     readonly 'pagination.nextPage': "Próxima página";
     readonly 'pagination.previousPage': "Página anterior";
@@ -2238,6 +2247,11 @@ declare const PRAXIS_LIST_PT_BR: {
     readonly 'Assistant-applied adjustments replace the entire configuration object.': "Observação: ajustes aplicados pelo assistente substituem o objeto de configuração inteiro.";
     readonly 'applyConfigFromAdapter does not perform a deep merge. Make sure the adapter sends the full config.': "O applyConfigFromAdapter não faz merge profundo. Garanta que o adapter envie a configuração completa.";
     readonly 'Resource (API)': "Recurso (API)";
+    readonly 'List resource': "Recurso da lista";
+    readonly 'Select resource': "Selecionar recurso";
+    readonly 'Hide resource selector': "Ocultar seletor";
+    readonly 'Select resource from catalog': "Selecionar recurso pelo catálogo";
+    readonly 'Select list resource': "Selecionar recurso da lista";
     readonly 'e.g.: users': "ex.: usuários (users)";
     readonly 'Resource endpoint (resourcePath).': "Endpoint do recurso (resourcePath).";
     readonly 'Query (JSON)': "Consulta (JSON)";