@praxisui/list 8.0.0-beta.20 → 8.0.0-beta.22

package/index.d.ts

@@ -1,13 +1,13 @@
 import * as rxjs from 'rxjs';
 import { BehaviorSubject, Observable } from 'rxjs';
 import * as i0 from '@angular/core';
-import { OnInit, OnChanges, OnDestroy, EventEmitter, SimpleChanges, ChangeDetectorRef, DoCheck, Provider } from '@angular/core';
+import { OnInit, OnChanges, OnDestroy, EventEmitter, SimpleChanges, ChangeDetectorRef, DoCheck, AfterViewInit, Provider } from '@angular/core';
 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, JsonLogicExpression, GlobalActionRef, LocalizationConfig, AiCapability, RichBlockNode, GlobalActionCatalogEntry, SurfaceOpenPayload, RichPresenterNode, RichComposeNode, ComponentDocMeta, AiCapabilityCategory, AiValueKind, AiCapabilityCatalog, ComponentAuthoringManifest } from '@praxisui/core';
-import { BaseAiAdapter, PatchResult } from '@praxisui/ai';
+import { PraxisExportFormat, PraxisExportScope, PraxisRuntimeConditionalEffectRule, JsonLogicExpression, GlobalActionRef, LocalizationConfig, AiCapability, RichBlockNode, GlobalActionCatalogEntry, SurfaceOpenPayload, SettingsValueProvider as SettingsValueProvider$1, RichPresenterNode, RichComposeNode, ComponentDocMeta, AiCapabilityCategory, AiValueKind, AiCapabilityCatalog, ComponentAuthoringManifest } from '@praxisui/core';
+import { BaseAiAdapter, PatchResult, PraxisAssistantTurnViewState, PraxisAssistantShellLayout, PraxisAssistantShellLabels, PraxisAssistantSessionSnapshot, PraxisAssistantShellQuickReply, PraxisAssistantShellMessage } from '@praxisui/ai';
 import { SettingsValueProvider } from '@praxisui/settings-panel';
 
 type TemplateType = 'text' | 'icon' | 'image' | 'chip' | 'rating' | 'currency' | 'date' | 'html' | 'slot' | 'metric' | 'compose' | 'component';
@@ -118,6 +118,31 @@ interface ListExpansionSectionDef {
 }
 type ListTemplatingSlot = 'leading' | 'primary' | 'secondary' | 'meta' | 'trailing' | 'identity' | 'balance' | 'limit' | 'risk' | 'alerts' | 'owner';
 type ListRowLayoutSlot = ListTemplatingSlot | 'actions' | 'expand';
+interface ListItemStyleEffect {
+    kind?: 'item-style';
+    class?: string;
+    style?: string;
+    border?: string;
+    background?: string;
+}
+interface ListSlotOverrideEffect {
+    kind?: 'slot-override';
+    template?: TemplateDef;
+    class?: string;
+    style?: string;
+    hide?: boolean;
+}
+interface ListItemStyleRule extends Omit<PraxisRuntimeConditionalEffectRule<ListItemStyleEffect>, 'condition' | 'effects'>, ListItemStyleEffect {
+    id: string;
+    condition?: JsonLogicExpression | null;
+    effects?: ListItemStyleEffect[];
+}
+interface ListSlotOverrideRule extends Omit<PraxisRuntimeConditionalEffectRule<ListSlotOverrideEffect>, 'condition' | 'effects'>, ListSlotOverrideEffect {
+    id: string;
+    slot: ListTemplatingSlot;
+    condition?: JsonLogicExpression | null;
+    effects?: ListSlotOverrideEffect[];
+}
 interface PraxisListConfig {
     id?: string;
     dataSource?: {
@@ -212,23 +237,8 @@ interface PraxisListConfig {
         };
     };
     rules?: {
-        itemStyles?: Array<{
-            id: string;
-            condition?: JsonLogicExpression | null;
-            class?: string;
-            style?: string;
-            border?: string;
-            background?: string;
-        }>;
-        slotOverrides?: Array<{
-            id: string;
-            slot: ListTemplatingSlot;
-            condition?: JsonLogicExpression | null;
-            template?: TemplateDef;
-            class?: string;
-            style?: string;
-            hide?: boolean;
-        }>;
+        itemStyles?: ListItemStyleRule[];
+        slotOverrides?: ListSlotOverrideRule[];
     };
     expansion?: {
         sections?: ListExpansionSectionDef[];
@@ -402,10 +412,15 @@ declare class ListDataService<T = any> {
 declare class ListAiAdapter extends BaseAiAdapter<PraxisListConfig> {
     private list;
     componentName: string;
+    componentId: string;
+    componentType: string;
     constructor(list: PraxisList);
     getCurrentConfig(): PraxisListConfig;
     getCapabilities(): AiCapability[];
     getRuntimeState(): Record<string, any>;
+    getDataProfile(): Record<string, any>;
+    getSchemaFields(): Record<string, any>[];
+    getAuthoringContext(): Record<string, any>;
     createSnapshot(): PraxisListConfig;
     restoreSnapshot(snapshot: PraxisListConfig): Promise<void>;
     applyPatch(patch: Partial<PraxisListConfig>, _intent?: string): Promise<PatchResult>;
@@ -457,6 +472,13 @@ declare class PraxisList implements OnInit, OnChanges, OnDestroy {
     inlineCss: string;
     readonly cspNonce: string | null;
     aiAdapter: ListAiAdapter;
+    aiAssistantOpen: boolean;
+    aiAssistantPrompt: string;
+    aiAssistantViewState: PraxisAssistantTurnViewState | null;
+    aiAssistantLayout: PraxisAssistantShellLayout;
+    readonly aiAssistantLabels: Partial<PraxisAssistantShellLabels>;
+    private aiAssistantController;
+    private aiAssistantStateSubscription;
     private readonly storage;
     private readonly skin;
     private inferredForPath;
@@ -473,6 +495,10 @@ declare class PraxisList implements OnInit, OnChanges, OnDestroy {
     private readonly collectionExport;
     private readonly paginatorIntl;
     private readonly snackBar;
+    private readonly aiApi;
+    private readonly assistantSessions;
+    private readonly aiTurnOrchestrator;
+    private readonly aiAssistantSessionEffect;
     readonly paginatorSelectConfig: MatPaginatorSelectConfig;
     private readonly logContext;
     private readonly route;
@@ -523,6 +549,9 @@ declare class PraxisList implements OnInit, OnChanges, OnDestroy {
     itemRuleStyle(item: any): string | undefined;
     rowLayoutItemStyle(item: any): string | undefined;
     rowLayoutItemClass(item: any): string | undefined;
+    private resolveItemStyleEffect;
+    private resolveSlotOverrideEffect;
+    private firstConditionalEffect;
     hasRowLayoutGrid(): boolean;
     rowLayoutColumns(): ListRowLayoutColumnViewModel[];
     rowLayoutTrackColumn(index: number, column: ListRowLayoutColumnViewModel): string;
@@ -639,6 +668,29 @@ declare class PraxisList implements OnInit, OnChanges, OnDestroy {
     private getExportMimeType;
     private cloneForExportEvent;
     openConfigEditor(): void;
+    openAiAssistant(): void;
+    openAiAssistantFromSession(session: PraxisAssistantSessionSnapshot): void;
+    closeAiAssistant(): void;
+    onAiAssistantPromptChange(prompt: string): void;
+    onAiAssistantSubmit(prompt: string): void;
+    onAiAssistantApply(): void;
+    onAiAssistantRetry(): void;
+    onAiAssistantCancel(): void;
+    onAiAssistantQuickReply(reply: PraxisAssistantShellQuickReply): void;
+    onAiAssistantEditMessage(message: PraxisAssistantShellMessage): void;
+    onAiAssistantResendMessage(message: PraxisAssistantShellMessage): void;
+    onAiAssistantLayoutChange(layout: PraxisAssistantShellLayout): void;
+    private initializeAiAssistantController;
+    private buildAiAssistantContextItems;
+    private buildAiAssistantContextSnapshot;
+    private syncAiAssistantSession;
+    private hasAiAssistantSessionState;
+    private resolveAiAssistantSessionId;
+    private resolveAiAssistantOwnerId;
+    private resolveAiAssistantRouteKey;
+    private resolveAiAssistantSummary;
+    private resolveAiAssistantBadge;
+    private resolveAiAssistantIcon;
     nextPage(): void;
     prevPage(): void;
     setPageSize(ps: number): void;
@@ -1449,6 +1501,35 @@ declare class PraxisListConfigEditor implements SettingsValueProvider, DoCheck {
     static ɵcmp: i0.ɵɵComponentDeclaration<PraxisListConfigEditor, "praxis-list-config-editor", never, { "config": { "alias": "config"; "required": false; }; "listId": { "alias": "listId"; "required": false; }; }, {}, never, never, true, never>;
 }
 
+interface PraxisListWidgetEditorInputs {
+    config?: PraxisListConfig | null;
+    listId?: string;
+    [key: string]: unknown;
+}
+interface PraxisListWidgetEditorValue {
+    inputs: PraxisListWidgetEditorInputs;
+}
+declare class PraxisListWidgetConfigEditor implements SettingsValueProvider$1, AfterViewInit, OnDestroy {
+    inputs: PraxisListWidgetEditorInputs | null;
+    widgetKey?: string;
+    listEditor?: PraxisListConfigEditor;
+    readonly isDirty$: BehaviorSubject<boolean>;
+    readonly isValid$: BehaviorSubject<boolean>;
+    readonly isBusy$: BehaviorSubject<boolean>;
+    private readonly subscription;
+    get config(): PraxisListConfig;
+    get listId(): string | undefined;
+    ngAfterViewInit(): void;
+    ngOnDestroy(): void;
+    getSettingsValue(): PraxisListWidgetEditorValue;
+    onSave(): PraxisListWidgetEditorValue;
+    reset(): void;
+    private initializeChildEditor;
+    private buildValue;
+    static ɵfac: i0.ɵɵFactoryDeclaration<PraxisListWidgetConfigEditor, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<PraxisListWidgetConfigEditor, "praxis-list-widget-config-editor", never, { "inputs": { "alias": "inputs"; "required": false; }; "widgetKey": { "alias": "widgetKey"; "required": false; }; }, {}, never, never, true, never>;
+}
+
 declare function createListAuthoringDocument(source: {
     config?: unknown;
 }): ListAuthoringDocument;
@@ -1751,23 +1832,8 @@ declare class PraxisListDocPageComponent {
                 };
             };
             rules?: {
-                itemStyles?: Array<{
-                    id: string;
-                    condition?: _praxisui_core.JsonLogicExpression | null;
-                    class?: string;
-                    style?: string;
-                    border?: string;
-                    background?: string;
-                }>;
-                slotOverrides?: Array<{
-                    id: string;
-                    slot: ListTemplatingSlot;
-                    condition?: _praxisui_core.JsonLogicExpression | null;
-                    template?: TemplateDef;
-                    class?: string;
-                    style?: string;
-                    hide?: boolean;
-                }>;
+                itemStyles?: ListItemStyleRule[];
+                slotOverrides?: ListSlotOverrideRule[];
             };
             expansion?: {
                 sections?: ListExpansionSectionDef[];
@@ -2348,5 +2414,5 @@ declare const PRAXIS_LIST_PT_BR: {
     readonly 'CSS class example (add this to your global styles):': "Exemplo de classe CSS (adicione isto aos seus estilos globais):";
 };
 
-export { ExecutiveAlertsComponent, ExecutiveBadgeComponent, ExecutiveOwnerComponent, LIST_AI_CAPABILITIES, ListDataService, ListSkinService, PRAXIS_LIST_AUTHORING_MANIFEST, PRAXIS_LIST_COMPONENT_METADATA, PRAXIS_LIST_EN_US, PRAXIS_LIST_I18N_NAMESPACE, PRAXIS_LIST_PT_BR, PraxisList, PraxisListConfigEditor, PraxisListDocPageComponent, PraxisListJsonConfigEditorComponent, adaptSelection, buildListApplyPlan, createListAuthoringDocument, evalExpr, evaluateTemplate, inferListAuthoringDocument, inferTemplatingFromSchema, isListTemplateSupportedByRichContentP0, mapListTemplateToRichContentP0, normalizeListActionPayloads, normalizeListAuthoringDocument, normalizeListConfig, parseLegacyOrListDocument, projectListAuthoringDocument, providePraxisListI18n, providePraxisListMetadata, serializeListAuthoringDocument, toCanonicalListConfig, validateListAuthoringDocument };
-export type { Capability, CapabilityCatalog, CapabilityCategory, EditorDiagnostic, EditorDocument, ExecutiveAlert, JsonEditorEvent, JsonValidationResult, ListActionEvent, ListApplyPlan, ListAuthoringDocument, ListExpansionSectionDef, ListExpansionSectionType, ListFeatureDef, ListItemEvent, ListProjectionContext, ListRichContentP0Node, ListRowLayoutSlot, ListRuntimeContext, ListSchemaInferencePlan, ListSection, ListSelectionEvent, ListTemplatingSlot, ListValidationContext, PraxisListConfig, PraxisListExportConfig, PraxisListI18nConfig, TemplateDef, TemplateEvaluatorOptions, TemplateFeatureDef, TemplateType, TemplatingFeatureDef, ValueKind };
+export { ExecutiveAlertsComponent, ExecutiveBadgeComponent, ExecutiveOwnerComponent, LIST_AI_CAPABILITIES, ListDataService, ListSkinService, PRAXIS_LIST_AUTHORING_MANIFEST, PRAXIS_LIST_COMPONENT_METADATA, PRAXIS_LIST_EN_US, PRAXIS_LIST_I18N_NAMESPACE, PRAXIS_LIST_PT_BR, PraxisList, PraxisListConfigEditor, PraxisListDocPageComponent, PraxisListJsonConfigEditorComponent, PraxisListWidgetConfigEditor, adaptSelection, buildListApplyPlan, createListAuthoringDocument, evalExpr, evaluateTemplate, inferListAuthoringDocument, inferTemplatingFromSchema, isListTemplateSupportedByRichContentP0, mapListTemplateToRichContentP0, normalizeListActionPayloads, normalizeListAuthoringDocument, normalizeListConfig, parseLegacyOrListDocument, projectListAuthoringDocument, providePraxisListI18n, providePraxisListMetadata, serializeListAuthoringDocument, toCanonicalListConfig, validateListAuthoringDocument };
+export type { Capability, CapabilityCatalog, CapabilityCategory, EditorDiagnostic, EditorDocument, ExecutiveAlert, JsonEditorEvent, JsonValidationResult, ListActionEvent, ListApplyPlan, ListAuthoringDocument, ListExpansionSectionDef, ListExpansionSectionType, ListFeatureDef, ListItemEvent, ListItemStyleEffect, ListItemStyleRule, ListProjectionContext, ListRichContentP0Node, ListRowLayoutSlot, ListRuntimeContext, ListSchemaInferencePlan, ListSection, ListSelectionEvent, ListSlotOverrideEffect, ListSlotOverrideRule, ListTemplatingSlot, ListValidationContext, PraxisListConfig, PraxisListExportConfig, PraxisListI18nConfig, PraxisListWidgetEditorInputs, PraxisListWidgetEditorValue, TemplateDef, TemplateEvaluatorOptions, TemplateFeatureDef, TemplateType, TemplatingFeatureDef, ValueKind };

package/package.json

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

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

@@ -328,7 +328,7 @@ A integracao com host ocorre por `SettingsValueProvider`:
 | `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, e confirmacao. |
+| `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. |
 | `ui.showSearch/searchField/searchPlaceholder` | Active | Bloco de busca. |
 | `ui.showSort/sortOptions` | Active | Editor visual com deteccao de duplicatas. |
@@ -348,7 +348,7 @@ A integracao com host ocorre por `SettingsValueProvider`:
 5. `queryJson` precisa ser JSON valido quando preenchido.
 6. URLs de imagem (leading/trailing/sectionHeader/emptyState) precisam seguir formato aceito.
 7. `ratingSize` deve estar em `10..32`; `ratingMax` em `1..10`.
-8. `actions[].globalAction.payload` deve ser JSON valido quando "parece JSON" (`{}` ou `[]`).
+8. `actions[].globalAction.payload` deve ser JSON valido quando "parece JSON" (`{}` ou `[]`); `payloadExpr` deve permanecer string e nao deve ser convertido em objeto.
 
 ### Integracao com schema remoto
 
@@ -364,7 +364,7 @@ A integracao com host ocorre por `SettingsValueProvider`:
 Antes de devolver configuracao para host:
 
 1. `ensureMappingApplied()` consolida estado dos mapeadores (`mapping*`) em `working.templating`.
-2. `normalizeActionPayloads()` converte `globalAction.payload` string para objeto/array quando JSON valido, inclusive payloads de navegacao interna com `query` e `state`.
+2. `normalizeActionPayloads()` converte `globalAction.payload` string para objeto/array quando JSON valido, inclusive payloads de navegacao interna com `query` e `state`; `payloadExpr` e preservado como escape avancado quando nao ha `payload` estruturado.
 3. Retorno padrao: `{ config: working, id: listId }`.
 
 ### Exemplos

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

@@ -393,7 +393,7 @@ Quatro superficies governam o componente:
 | `ASYNC_CONFIG_STORAGE`                         | persistencia de config               | `praxis-list-config-${componentKeyId}`                                               |
 | `ComponentKeyService`                          | identidade de instancia              | `listId + componentInstanceId + route`                                               |
 | `PraxisCollectionExportService`                | exportação de coleção                | CSV/JSON local; provider para export remoto/formatos avançados                       |
-| `PraxisAiAssistantComponent` + `ListAiAdapter` | copiloto para patches JSON           | ativo com `enableCustomization=true`                                                 |
+| `PraxisAiAssistantShellComponent` + `ListAgenticAuthoringTurnFlow` + `ListAiAdapter` | copiloto semantico governado | ativo com `enableCustomization=true`; rejeita patch JSON livre e exige `componentEditPlan` manifest-backed antes de apply local |
 | `GenericCrudService`                           | dados remotos e inferencia de schema | `/filter` + fallback `getAll` + `getSchema`                                          |
 
 #### Checklist corporativo pre-flight
@@ -678,6 +678,7 @@ Notas de UX/WCAG:
 | `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 |
+| `actions[].globalAction.payloadExpr` | Active    | escape avancado de `GlobalActionRef`; quando nao ha `payload`, o runtime nao injeta payload sintetico |
 | `actions[].emitLocal`            | Active        | emite `actionClick` mesmo com acao global                    |
 | `actions[].showLoading`          | Active        | spinner + disable durante execucao                          |
 | `actions[].confirmation.title`   | Active        | dialogo de confirmacao                                      |
@@ -748,15 +749,15 @@ Política de erro:
 
 Quando `enableCustomization=true`:
 
-- componente exibe botao de edicao + `praxis-ai-assistant`;
+- componente exibe botao de edicao + shell governada `PraxisAiAssistantShellComponent`;
 - `openConfigEditor()` abre `PraxisListConfigEditor`;
 - `applied$` e `saved$` aplicam config em runtime;
 - `saved$` persiste no storage quando chave valida existe.
 
 AI:
 
-- `ListAiAdapter` aplica patches de config sem recrear componente;
-- capability/context packs orientam mudancas por path JSON.
+- `ListAgenticAuthoringTurnFlow` envia contexto seguro para o backend e bloqueia patch livre;
+- capability/context packs orientam mudancas por contrato governado, nao por patch JSON local.
 
 #### Complete JSON path index (cobertura total)