@praxisui/list 9.0.0-beta.4 → 9.0.0-beta.40

package/package.json

@@ -1,19 +1,19 @@
 {
   "name": "@praxisui/list",
-  "version": "9.0.0-beta.4",
+  "version": "9.0.0-beta.40",
   "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.0-beta.4",
+    "@praxisui/dynamic-fields": "^9.0.0-beta.40",
     "rxjs": ">=7 <9",
     "@angular/forms": "^21.0.0",
     "@angular/router": "^21.0.0",
-    "@praxisui/ai": "^9.0.0-beta.4",
-    "@praxisui/core": "^9.0.0-beta.4",
-    "@praxisui/rich-content": "^9.0.0-beta.4",
-    "@praxisui/settings-panel": "^9.0.0-beta.4"
+    "@praxisui/ai": "^9.0.0-beta.40",
+    "@praxisui/core": "^9.0.0-beta.40",
+    "@praxisui/rich-content": "^9.0.0-beta.40",
+    "@praxisui/settings-panel": "^9.0.0-beta.40"
   },
   "dependencies": {
     "tslib": "^2.3.0",
@@ -27,6 +27,7 @@
   "keywords": [
     "angular",
     "praxisui",
+    "praxis",
     "list",
     "cards",
     "selection",
@@ -42,7 +43,10 @@
     ".": {
       "types": "./types/praxisui-list.d.ts",
       "default": "./fesm2022/praxisui-list.mjs"
+    },
+    "./ai/component-registry.json": {
+      "default": "./ai/component-registry.json"
     }
   },
   "type": "module"
-}
+}

package/src/lib/editors/praxis-list-config-editor.json-api.md

@@ -302,7 +302,7 @@ A integracao com host ocorre por `SettingsValueProvider`:
 | `dataSource.resourcePath` | Active | Campo principal para schema remoto. |
 | `dataSource.query` | Active | JSON editavel com validacao sintatica. |
 | `dataSource.sort` | Active | Gerado por `sortField/sortDir` e por UI sort rows. |
-| `dataSource.data` | Declared-only | Nao possui editor dedicado para dataset local. |
+| `dataSource.data` | Active | Preservado no objeto; editor mostra resumo, colunas de amostra e aviso de precedencia sobre `resourcePath`. |
 | `layout.variant` | Active | `list/cards/tiles`. |
 | `layout.model` | Active | `standard/media/hotel`. |
 | `layout.lines` | Active | `1/2/3`. |
@@ -312,6 +312,11 @@ A integracao com host ocorre por `SettingsValueProvider`:
 | `layout.stickySectionHeader` | Active | Toggle dedicado. |
 | `layout.virtualScroll` | Active | Toggle dedicado (mesmo que runtime possa nao aplicar). |
 | `layout.pageSize` | Active | Numero inteiro >= 1. |
+| `layout.rowLayout.type/columns/gap/itemAlignY/class/style` | Active | Editor guiado de colunas estaveis para listas corporativas. |
+| `export.enabled/formats/general.*` | Active | Editor guiado de formatos, escopo, cabecalhos, limite, nome de arquivo, formatacao e campos incluidos. |
+| `interaction.expandable/expandTrigger/expandMode/expandPlacement` | Active | Editor guiado de comportamento expansivel da linha. |
+| `expansion.sections/rendering` | Active | Editor guiado para secoes inline e shell visual da expansao. |
+| `rules.itemStyles/slotOverrides` | Active | Editor guiado basico para Json Logic, classe, estilo, template de slot, ocultacao e primeiro `effects[]` canonico. |
 | `skin.type` | Active | Presets + selecao manual. |
 | `skin.gradient/radius/shadow/border/backdropBlur/class/inlineStyle` | Active | Edicao direta + presets. |
 | `selection.mode` | Active | `none/single/multiple`. |
@@ -327,15 +332,27 @@ A integracao com host ocorre por `SettingsValueProvider`:
 | `templating.features*` | Active | CRUD de features + modo de exibicao. |
 | `templating.iconColorMap/chipColorMap/chipLabelMap` | Active | Editor de pares chave/valor com normalizacao. |
 | `templating.skeleton.count` | Active | Controle numerico (>=0). |
-| `actions[].id/icon/label/color/kind/buttonVariant/showIf` | Active | Authoring completo de ações por item; `showIf` usa Json Logic serializável. |
-| `actions[].globalAction/emitLocal/showLoading/confirmation` | Active | Suporte a acoes globais estruturadas, incluindo `navigation.openRoute` como navegacao interna canonica, `payloadExpr` como escape avancado explicito, e confirmacao. |
-| `actions[].emitPayload` | Active | Campo editavel no editor; consumo runtime depende da lista. |
+| `actions[].id/icon/label/color/kind/buttonVariant/showIf/placement` | Active | Authoring completo de acoes por item; `showIf` usa Json Logic serializavel e `placement` controla a regiao visual da acao. |
+| `actions[].globalAction/emitLocal/showLoading/confirmation` | Active | Suporte a acoes globais estruturadas, confirmacao para acoes locais e globais, loading por acao e emissao local opcional. |
+| `actions[].globalAction.payload/payloadExpr` | Active | `payload` estruturado e `payloadExpr` avancado sao editaveis; ao definir um deles, o editor remove o outro para manter semantica canonica de execucao. |
+| `actions[].emitPayload` | Declared-only | Preservado em JSON/config round-trip; nao aparece no editor visual de Ações porque nao altera o payload nativo da lista. |
 | `ui.showSearch/searchField/searchPlaceholder` | Active | Bloco de busca. |
 | `ui.showSort/sortOptions` | Active | Editor visual com deteccao de duplicatas. |
 | `ui.showRange` | Active | Toggle dedicado. |
 | `i18n.locale/currency` | Active | Usado em formatacao de preview/runtime. |
 | `a11y.ariaLabel/ariaLabelledBy/highContrast/reduceMotion` | Active | Editavel no tab de acessibilidade. |
-| `events.itemClick/actionClick/selectionChange/loaded` | Active | Mapeamentos editaveis no tab de eventos. |
+| `events.itemClick/actionClick/selectionChange/exportAction/loaded` | Active | Mapeamentos editaveis no tab de eventos. |
+
+### Coverage inventory for runtime/editor parity
+
+| Area | Adherence | Current editor coverage | Recommended next step |
+| --- | --- | --- | --- |
+| `events.exportAction` | ja-suportado-so-ux | Campo visual no tab de eventos. | Manter coberto por spec focal de round-trip. |
+| `layout.rowLayout` | ja-suportado-so-ux | Editor guiado cobre ativacao, preset corporativo, tipo, colunas, largura, alinhamento, gap, CSS avancado e warnings inline para slots sem materializacao. | Evoluir depois com preview visual por slot. |
+| `export` | ja-suportado-so-ux | Editor guiado cobre habilitacao, formatos, escopo, cabecalhos, limite, nome de arquivo, formatacao, campos incluidos, warning para campo inexistente quando o schema esta carregado e preview compacto de colunas/amostra. | Evoluir depois com preview fiel do payload final gerado pelo runtime. |
+| `interaction`/`expansion` | suportado-parcialmente | Editor guiado cobre interacao expansivel, secoes inline, rendering e diagnostico de `dataSource`/`schemaContract` remotos preservados por JSON. | Evoluir fonte remota/schemaContract apenas com validacao de seguranca e prova runtime. |
+| `rules.itemStyles`/`rules.slotOverrides` | ja-suportado-so-ux | Editor guiado cobre condicao Json Logic, estilo de item, override de slot, template basico, ocultacao e primeira materializacao canonica `effects[0]`. | Evoluir depois com builder visual de Json Logic, preview por item e suporte multi-effect se o runtime passar a consumir mais de um efeito. |
+| `dataSource.data` | ja-suportado-mal-nomeado-ou-mal-materializado | Round-trip por JSON com resumo visual, colunas de amostra e aviso de precedencia sobre `resourcePath`. | Manter JSON-only para datasets grandes; considerar import dedicado apenas se houver demanda operacional. |
 
 ### Validacao Estrutural
 
@@ -427,10 +444,14 @@ ref.saved$.subscribe((payload) => {
 
 ### Known limitations and pending investigation
 
-1. Nao existe editor dedicado para `dataSource.data` (dataset local grande).
-2. O editor permite campos que podem nao ter efeito no runtime final (ex.: flags declarativas sem binding atual).
-3. `isDirty$` usa comparacao por snapshot JSON; mudancas de ordenacao de chaves/objetos podem gerar ruido em cenarios extremos.
-4. Conversao automatica de `globalAction.payload` string para JSON e heuristica (so quando formato parece objeto/array).
+1. Nao existe editor dedicado para alterar `dataSource.data` (dataset local grande); o editor mostra resumo, amostra e precedencia para evitar erro silencioso.
+2. `rules` possui editor guiado basico com `effects[0]`, mas ainda nao tem builder visual de Json Logic, preview de impacto por item ou authoring multi-effect. O runtime atualmente materializa o primeiro efeito valido.
+3. `layout.rowLayout` possui editor guiado com warnings inline para slots sem materializacao, mas ainda nao tem preview visual por slot.
+4. `export` possui editor guiado com warning de `includeFields` desconhecido e preview compacto de colunas/amostra, mas ainda nao tem preview fiel do payload final gerado pelo runtime.
+5. `expansion.dataSource` remoto e `expansion.schemaContract` permanecem JSON-only para authoring; o editor mostra diagnostico de seguranca e preservacao ate existir prova runtime especifica de carregamento remoto.
+6. O editor preserva em JSON/config campos declared-only que podem nao ter efeito no runtime final, mas nao deve promove-los como controles visuais ativos.
+7. `isDirty$` usa comparacao por snapshot JSON; mudancas de ordenacao de chaves/objetos podem gerar ruido em cenarios extremos.
+8. Conversao automatica de `globalAction.payload` string para JSON e heuristica (so quando formato parece objeto/array).
 
 ### Source references
 

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-06-14"
-last_updated: "2026-06-14"
+source_of_truth_last_verified: "2026-06-16"
+last_updated: "2026-06-16"
 toc: true
 sidebar: true
 tags:
@@ -181,7 +181,7 @@ Este arquivo foi adaptado para o padrao canonico atual sem remover conteudo tecn
 | Event             | Payload              | Trigger                                             | Stability | Notes                                |
 | ----------------- | -------------------- | --------------------------------------------------- | --------- | ------------------------------------ |
 | `itemClick`       | `ListItemEvent`      | clique (mouse/teclado) em item                      | Partial   | Preservado da documentação anterior. |
-| `actionClick`     | `ListActionEvent`    | acao local de item (ou global com `emitLocal=true`) | Partial   | Preservado da documentação anterior. |
+| `actionClick`     | `ListActionEvent`    | acao local de item, global com `emitLocal=true` ou acao de `rich-content` hospedado | Partial   | `rich-content` inclui `payload?` e `source='rich-content'`. |
 | `selectionChange` | `ListSelectionEvent` | alteracao de selecao em `mat-selection-list`        | Partial   | Preservado da documentação anterior. |
 | `exportAction`    | `any`                | resultado ou erro de exportacao de colecao          | Active    | Usa `PraxisCollectionExportService`. |
 
@@ -273,7 +273,7 @@ A maior parte das falhas opera em modo fail-open (persistência, inferência, co
 | Condition                         | Mode      | Runtime behavior                                 | Consumer impact                    |
 | --------------------------------- | --------- | ------------------------------------------------ | ---------------------------------- |
 | Falha em `loadConfig/saveConfig`  | fail-open | ignora persistência e mantém config ativa        | sem perda de renderização          |
-| `showIf` inválido                 | fail-open | item/ação pode ser ocultado com warning          | evita quebra de template           |
+| `showIf` invalido                 | fail-closed | item/acao e ocultado com warning                 | evita renderizacao indevida        |
 | comando global não disponível     | fail-open | ação global não executa; fluxo local continua    | comportamento parcial, sem crash   |
 | contrato de seleção inconsistente | fail-soft | adapter normaliza payload para formato suportado | pode reduzir fidelidade do payload |
 
@@ -658,14 +658,19 @@ Tipo declarado sem renderer dedicado:
 | `expansion.sections`              | Active | array de secoes da detail row            |
 | `expansion.sections[].id`         | Active | identidade da secao                      |
 | `expansion.sections[].title`      | Active | titulo visivel da secao                  |
-| `expansion.sections[].type`       | Active | `info-list/chip-list/timeline/key-value` |
+| `expansion.sections[].type`       | Active | `info-list/chip-list/timeline/key-value/metadata/component/rich-content` |
 | `expansion.sections[].itemsExpr`  | Active | expr de colecao/objeto por item          |
+| `expansion.sections[].document`   | Active | `RichContentDocument` canonico para secoes `rich-content` |
+| `expansion.sections[].documentExpr` | Active | expr que resolve um `RichContentDocument` por item |
 | `expansion.sections[].emptyLabel` | Active | mensagem vazia por secao                 |
 
 Notas de UX/WCAG:
 
 - `aria-expanded` e `aria-controls` ficam no owner real do trigger (`row` ou `icon`);
 - com `selection.mode !== 'none'`, a selecao continua dona da linha e a expansao passa a ser acionada apenas pelo icone;
+- `expansion.sections[].itemsExpr` pode resolver arrays/objetos JSON com placeholders; o runtime materializa a estrutura em vez de exibir JSON cru;
+- para detalhes editoriais avancados, use `type='rich-content'` com `document`/`documentExpr`; a lista hospeda o contrato canonico `RichContentDocument` em vez de criar DSL visual paralela;
+- ações dentro de seções `rich-content` são mediadas por `hostCapabilities` da própria lista, reemitidas em `actionClick` com `payload?` e `source='rich-content'`, e `confirmMessage` usa o mesmo `GLOBAL_DIALOG_SERVICE` das ações nativas;
 - a V1 nao suporta markup arbitrario nem detail builders livres;
 - `cards` e `tiles` permanecem fora de escopo.
 - o scenario `executive-expansion` da doc page e uma composicao editorial canonica de validacao visual; campos como `balanceDisplay`, `limitDisplay`, `usageLabel`, `riskDisplay` e `riskLabel` pertencem ao dataset de exemplo, nao ao contrato base de `PraxisListConfig`.
@@ -681,7 +686,7 @@ Notas de UX/WCAG:
 | `actions[].kind`                 | Active        | `icon` ou `button`                                          |
 | `actions[].buttonVariant`        | Active        | `stroked/raised/flat`                                       |
 | `actions[].showIf`               | Active        | condição Json Logic avaliada no contexto `row`              |
-| `actions[].emitPayload`          | Declared-only | sem uso no payload de `actionClick` atual                   |
+| `actions[].emitPayload`          | Declared-only | sem uso no payload de ações nativas; ações `rich-content` hospedadas podem emitir `payload?` próprio |
 | `actions[].globalAction`         | Active        | integra com `GlobalActionService.executeRef`; suporta `navigation.openRoute` para navegação interna canônica |
 | `actions[].globalAction.actionId` | Active       | identificador canonico da acao global                        |
 | `actions[].globalAction.payload` | Active        | template/JSON resolvido recursivamente, inclusive `item.id` em rotas internas |
@@ -849,8 +854,10 @@ AI:
 | `expansion.sections`                   | Active        | secoes do detail row                   |
 | `expansion.sections[].id`              | Active        | id                                     |
 | `expansion.sections[].title`           | Active        | title                                  |
-| `expansion.sections[].type`            | Active        | info-list/chip-list/timeline/key-value |
+| `expansion.sections[].type`            | Active        | info-list/chip-list/timeline/key-value/metadata/component/rich-content |
 | `expansion.sections[].itemsExpr`       | Active        | expr                                   |
+| `expansion.sections[].document`        | Active        | `RichContentDocument` para `rich-content` |
+| `expansion.sections[].documentExpr`    | Active        | expr que resolve `RichContentDocument` |
 | `expansion.sections[].emptyLabel`      | Active        | empty state da secao                   |
 | `actions`                              | Partial       | bloco de acoes                         |
 | `actions[].id`                         | Active        | id                                     |