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

package/package.json

@@ -1,19 +1,19 @@
 {
   "name": "@praxisui/list",
-  "version": "9.0.0-beta.4",
+  "version": "9.0.0-beta.5",
   "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.5",
     "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.5",
+    "@praxisui/core": "^9.0.0-beta.5",
+    "@praxisui/rich-content": "^9.0.0-beta.5",
+    "@praxisui/settings-panel": "^9.0.0-beta.5"
   },
   "dependencies": {
     "tslib": "^2.3.0",

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

@@ -327,9 +327,10 @@ 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. |
@@ -428,7 +429,7 @@ 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).
+2. 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.
 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).
 

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`. |
 
@@ -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                                     |

package/types/praxisui-list.d.ts

@@ -6,7 +6,7 @@ import { MatSelectionListChange } from '@angular/material/list';
 import { MatPaginatorSelectConfig, PageEvent } from '@angular/material/paginator';
 import { FormGroup, FormControl } from '@angular/forms';
 import * as _praxisui_core from '@praxisui/core';
-import { PraxisExportFormat, PraxisExportScope, PraxisRuntimeConditionalEffectRule, JsonLogicExpression, GlobalActionRef, LocalizationConfig, AiCapability, PraxisDataQueryContext, RichBlockNode, GlobalActionCatalogEntry, SurfaceOpenPayload, SettingsValueProvider as SettingsValueProvider$1, RichPresenterNode, RichComposeNode, ComponentDocMeta, AiCapabilityCategory, AiCapabilityCatalog, AiValueKind, ComponentAuthoringManifest } from '@praxisui/core';
+import { PraxisExportFormat, PraxisExportScope, PraxisRuntimeConditionalEffectRule, JsonLogicExpression, RichContentDocument, GlobalActionRef, LocalizationConfig, AiCapability, PraxisDataQueryContext, RichBlockNode, RichBlockHostCapabilities, GlobalActionCatalogEntry, SurfaceOpenPayload, SettingsValueProvider as SettingsValueProvider$1, RichPresenterNode, RichComposeNode, ComponentDocMeta, AiCapabilityCategory, AiCapabilityCatalog, AiValueKind, ComponentAuthoringManifest } from '@praxisui/core';
 import { BaseAiAdapter, AiResponseCompileResult, PatchResult, PraxisAssistantTurnViewState, PraxisAssistantShellLayout, PraxisAssistantShellLabels, PraxisAssistantSessionSnapshot, PraxisAssistantShellQuickReply, PraxisAssistantShellMessage } from '@praxisui/ai';
 import { SettingsValueProvider } from '@praxisui/settings-panel';
 import * as _praxisui_list from '@praxisui/list';
@@ -91,12 +91,16 @@ interface TemplateFeatureDef extends TemplateDef {
     icon?: string;
 }
 type TemplatingFeatureDef = ListFeatureDef | TemplateFeatureDef;
-type ListExpansionSectionType = 'info-list' | 'chip-list' | 'timeline' | 'key-value' | 'metadata' | 'component';
+type ListExpansionSectionType = 'info-list' | 'chip-list' | 'timeline' | 'key-value' | 'metadata' | 'component' | 'rich-content';
 interface ListExpansionSectionDef {
     id: string;
     title?: string;
     type: ListExpansionSectionType;
     itemsExpr?: string;
+    /** Canonical rich-content document rendered by @praxisui/rich-content. */
+    document?: RichContentDocument;
+    /** Expression resolving to a RichContentDocument, including JSON strings from row data. */
+    documentExpr?: string;
     emptyLabel?: string;
     metadata?: {
         orientation?: 'horizontal' | 'vertical';
@@ -265,7 +269,7 @@ interface PraxisListConfig {
         schemaContract?: {
             kind: 'praxis.detail.schema';
             version: string;
-            allowedNodes?: Array<'info-list' | 'chip-list' | 'timeline' | 'key-value' | 'metadata' | 'component'>;
+            allowedNodes?: Array<'info-list' | 'chip-list' | 'timeline' | 'key-value' | 'metadata' | 'component' | 'rich-content'>;
             maxSections?: number;
             maxItemsPerSection?: number;
             requireSectionIds?: boolean;
@@ -347,6 +351,8 @@ interface ListActionEvent {
     actionId: string;
     item: any;
     index: number;
+    payload?: unknown;
+    source?: 'rich-content';
 }
 interface ListSelectionEvent {
     mode: 'single' | 'multiple';
@@ -773,6 +779,10 @@ declare class PraxisList implements OnInit, OnChanges, AfterViewInit, OnDestroy
     expansionSections(item: any): ListExpansionSectionDef[];
     expansionSectionItems(item: any, section: ListExpansionSectionDef, index?: number): any[];
     expansionSectionHasContent(item: any, section: ListExpansionSectionDef, index?: number): boolean;
+    expansionRichContentDocument(item: any, section: ListExpansionSectionDef, index?: number): RichContentDocument | null;
+    expansionRichContentContext(item: any, _section: ListExpansionSectionDef, index?: number): Record<string, any>;
+    expansionRichContentHostCapabilities(item: any, _section: ListExpansionSectionDef, index?: number): RichBlockHostCapabilities;
+    private isRichContentDocument;
     expansionItemLabel(value: any): string;
     expansionInfoTitle(value: any): string;
     expansionInfoValue(value: any): string;
@@ -813,6 +823,7 @@ declare class PraxisList implements OnInit, OnChanges, AfterViewInit, OnDestroy
     private toggleExpanded;
     private syncExpansionState;
     private itemExpansionKey;
+    private itemRenderKey;
     private itemStableKey;
     private isStablePrimitiveKey;
     t(key: string, fallback: string): string;
@@ -820,6 +831,7 @@ declare class PraxisList implements OnInit, OnChanges, AfterViewInit, OnDestroy
     private ensureExpansionItemObjectId;
     private sanitizeDomId;
     private evaluateExpansionExpr;
+    private parseStructuredExpansionValue;
     private normalizeExpansionItems;
     private normalizeKeyValueItems;
     static ɵfac: i0.ɵɵFactoryDeclaration<PraxisList, never>;
@@ -1444,6 +1456,10 @@ declare class PraxisListConfigEditor implements SettingsValueProvider, DoCheck {
         globalAction?: GlobalActionRef;
     }): string;
     onGlobalActionPayloadTextChange(action: any, value: string): void;
+    getGlobalActionPayloadExprText(action: {
+        globalAction?: GlobalActionRef;
+    }): string;
+    onGlobalActionPayloadExprTextChange(action: any, value: string): void;
     isGlobalActionPayloadInvalid(action: {
         globalAction?: GlobalActionRef;
     }): boolean;
@@ -1894,7 +1910,7 @@ declare class PraxisListDocPageComponent {
                 schemaContract?: {
                     kind: "praxis.detail.schema";
                     version: string;
-                    allowedNodes?: Array<"info-list" | "chip-list" | "timeline" | "key-value" | "metadata" | "component">;
+                    allowedNodes?: Array<"info-list" | "chip-list" | "timeline" | "key-value" | "metadata" | "component" | "rich-content">;
                     maxSections?: number;
                     maxItemsPerSection?: number;
                     requireSectionIds?: boolean;
@@ -2039,7 +2055,6 @@ declare const PRAXIS_LIST_EN_US: {
     readonly 'Action color': "Action color";
     readonly 'Custom color': "Custom color";
     readonly 'Use custom color': "Use custom color";
-    readonly 'Action payload': "Action payload";
     readonly Default: "Default";
     readonly "Show when (e.g.: ${item.status} == 'done')": "Show when (e.g.: ${item.status} == 'done')";
     readonly "Supported syntax: \"${item.field} == 'value'\". Advanced expressions are not evaluated.": "Supported syntax: \"${item.field} == 'value'\". Advanced expressions are not evaluated.";
@@ -2082,7 +2097,6 @@ declare const PRAXIS_LIST_EN_US: {
     readonly 'Example:': "Example:";
     readonly Item: "Item";
     readonly Value: "Value";
-    readonly 'Payload emitted by the action.': "Payload emitted by the action.";
     readonly 'Modern tiles preset': "Modern tiles preset";
     readonly List: "List";
     readonly Lines: "Lines";
@@ -2280,7 +2294,6 @@ declare const PRAXIS_LIST_PT_BR: {
     readonly 'Action color': "Cor da ação";
     readonly 'Custom color': "Cor personalizada";
     readonly 'Use custom color': "Usar cor personalizada";
-    readonly 'Action payload': "Dados da ação (Payload)";
     readonly Default: "Padrão";
     readonly "Show when (e.g.: ${item.status} == 'done')": "Exibir quando (ex.: ${item.status} == 'concluído')";
     readonly "Supported syntax: \"${item.field} == 'value'\". Advanced expressions are not evaluated.": "Sintaxe suportada: \"${item.field} == 'valor'\". Expressões avançadas não são avaliadas.";
@@ -2323,7 +2336,6 @@ declare const PRAXIS_LIST_PT_BR: {
     readonly 'Example:': "Exemplo:";
     readonly Item: "Item";
     readonly Value: "Valor";
-    readonly 'Payload emitted by the action.': "Dados (payload) emitidos pela ação.";
     readonly 'Modern tiles preset': "Predefinição de blocos modernos";
     readonly List: "Lista";
     readonly Lines: "Linhas";