@praxisui/list 9.0.67 → 9.0.68-rc.1

package/package.json

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

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

@@ -183,6 +183,7 @@ Este arquivo foi adaptado para o padrao canonico atual sem remover conteudo tecn
 | `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` | alteração pelo controle explícito de seleção da linha                               | Partial   | Preserva binding e payload; a superfície usa checkbox/radio. |
 | `exportAction`    | `any`                | resultado ou erro de exportacao de colecao                                          | Active    | Usa `PraxisCollectionExportService`.                         |
+| `configPatchChange` | `{ inputPatch: { config: PraxisListConfig } }` | Apply/Save válido do editor nativo ou authoring por adapter | Active | Atualiza a página autorada; não emite hidratação, inferência, filtros ou seleção runtime. |
 
 ### External side channels
 
@@ -376,7 +377,7 @@ Quatro superficies governam o componente:
 1. **Documento de autoria (`ListAuthoringDocument`)**: envelope persistivel e canônico para editor visual, editor JSON, host runtime e fluxos futuros de IA/playground.
 2. **Config canônica projetada (`PraxisListConfig`)**: dados, layout, skin, selecao, templating, acoes e UI.
 3. **Inputs externos**: `listId`, `componentInstanceId`, `form` e `enableCustomization`.
-4. **Outputs**: `itemClick`, `actionClick`, `selectionChange`, `exportAction`.
+4. **Outputs**: `itemClick`, `actionClick`, `selectionChange`, `exportAction`, `configPatchChange`.
 5. **Side channels**: persistencia assinc, settings panel, global action bus e AI adapter.
 
 #### Integracao com ecossistema Praxis
@@ -427,6 +428,9 @@ Antes de liberar para producao:
 | `actionClick`     | `ListActionEvent`    | acao local de item (ou global com `emitLocal=true`) |
 | `selectionChange` | `ListSelectionEvent` | alteração pelo checkbox/radio explícito da linha    |
 | `exportAction`    | `any`                | exportacao concluida, delegada ou com erro          |
+| `configPatchChange` | `{ inputPatch: { config: PraxisListConfig } }` | Apply/Save válido ou authoring por adapter; snapshot independente para o host |
+
+O editor hospedado oferece **Origem da configuração** para o input existente `configPersistenceStrategy`: **Configuração da página** (`input-first`), **Preferências individuais da lista** (`local-first`) e **Configuração temporária** (`volatile`). Para páginas compostas, escolha `input-first` para evitar que preferências antigas sobreponham o documento salvo da página. Apply, Save e Reset preservam essa escolha e os demais inputs.
 
 #### Data mode and flow
 

package/types/praxisui-list.d.ts

@@ -5,7 +5,7 @@ import { OnInit, OnChanges, AfterViewInit, OnDestroy, EventEmitter, SimpleChange
 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, RichContentDocument, ResourceRecordOpenRef, GlobalActionRef, LocalizationConfig, AiCapability, PraxisDataQueryContext, RichBlockNode, RichBlockHostCapabilities, GlobalActionCatalogEntry, SurfaceOpenPayload, SettingsValueProvider as SettingsValueProvider$1, RichPresenterNode, RichComposeNode, ComponentDocMeta, AiCapabilityCategory, AiCapabilityCatalog, AiValueKind, ComponentAuthoringManifest } from '@praxisui/core';
+import { PraxisExportFormat, PraxisExportScope, PraxisRuntimeConditionalEffectRule, JsonLogicExpression, RichContentDocument, ResourceRecordOpenRef, GlobalActionRef, LocalizationConfig, AiCapability, PraxisDataQueryContext, RichBlockNode, RichBlockHostCapabilities, SurfaceOpenActionEditorComponent, 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';
@@ -492,6 +492,11 @@ declare class PraxisList implements OnInit, OnChanges, AfterViewInit, OnDestroy
     actionClick: EventEmitter<ListActionEvent>;
     selectionChange: EventEmitter<ListSelectionEvent>;
     exportAction: EventEmitter<any>;
+    readonly configPatchChange: i0.OutputEmitterRef<{
+        inputPatch: {
+            config: PraxisListConfig;
+        };
+    }>;
     items$: rxjs.Observable<any[]>;
     sections$: rxjs.Observable<ListSection<any>[]>;
     loading$: rxjs.Observable<boolean>;
@@ -512,6 +517,9 @@ declare class PraxisList implements OnInit, OnChanges, AfterViewInit, OnDestroy
     skinClasses: string;
     inlineCss: string;
     readonly cspNonce: string | null;
+    private readonly hostElement;
+    private readonly renderer;
+    private skinStyleElement?;
     aiAdapter: ListAiAdapter;
     aiAssistantOpen: boolean;
     aiAssistantPrompt: string;
@@ -571,6 +579,7 @@ declare class PraxisList implements OnInit, OnChanges, AfterViewInit, OnDestroy
     private setupSearch;
     private persistConfig;
     private applySkins;
+    private syncSkinStyle;
     isListVariant(): boolean;
     isCardsVariant(): boolean;
     isTilesVariant(): boolean;
@@ -730,6 +739,7 @@ declare class PraxisList implements OnInit, OnChanges, AfterViewInit, OnDestroy
     private getExportMimeType;
     private cloneForExportEvent;
     openConfigEditor(): void;
+    private openConfigEditorPanel;
     openAiAssistant(): void;
     openAiAssistantFromSession(session: PraxisAssistantSessionSnapshot): void;
     closeAiAssistant(): void;
@@ -869,7 +879,7 @@ declare class PraxisList implements OnInit, OnChanges, AfterViewInit, OnDestroy
     private normalizeExpansionItems;
     private normalizeKeyValueItems;
     static ɵfac: i0.ɵɵFactoryDeclaration<PraxisList, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<PraxisList, "praxis-list", never, { "config": { "alias": "config"; "required": false; }; "listId": { "alias": "listId"; "required": true; }; "componentInstanceId": { "alias": "componentInstanceId"; "required": false; }; "configPersistenceStrategy": { "alias": "configPersistenceStrategy"; "required": false; }; "queryContext": { "alias": "queryContext"; "required": false; }; "form": { "alias": "form"; "required": false; }; "enableCustomization": { "alias": "enableCustomization"; "required": false; }; }, { "itemClick": "itemClick"; "actionClick": "actionClick"; "selectionChange": "selectionChange"; "exportAction": "exportAction"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<PraxisList, "praxis-list", never, { "config": { "alias": "config"; "required": false; }; "listId": { "alias": "listId"; "required": true; }; "componentInstanceId": { "alias": "componentInstanceId"; "required": false; }; "configPersistenceStrategy": { "alias": "configPersistenceStrategy"; "required": false; }; "queryContext": { "alias": "queryContext"; "required": false; }; "form": { "alias": "form"; "required": false; }; "enableCustomization": { "alias": "enableCustomization"; "required": false; }; }, { "itemClick": "itemClick"; "actionClick": "actionClick"; "selectionChange": "selectionChange"; "exportAction": "exportAction"; "configPatchChange": "configPatchChange"; }, never, never, true, never>;
     static ngAcceptInputType_enableCustomization: unknown;
 }
 
@@ -1219,6 +1229,10 @@ declare class PraxisListConfigEditor implements SettingsValueProvider, DoCheck {
     listId?: string;
     document: ListAuthoringDocument;
     working: NormalizedListConfig;
+    private readonly invalidSurfaceDrafts;
+    private jsonEditorIsValid;
+    get hasInvalidSurfaceDraft(): boolean;
+    onSurfaceDraftValidity(source: SurfaceOpenActionEditorComponent, valid: boolean): void;
     isDirty$: BehaviorSubject<boolean>;
     isValid$: BehaviorSubject<boolean>;
     isBusy$: BehaviorSubject<boolean>;
@@ -1699,6 +1713,7 @@ 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>;
 }
 
+type PersistenceStrategy = 'input-first' | 'local-first' | 'volatile';
 interface PraxisListWidgetEditorInputs {
     config?: PraxisListConfig | null;
     listId?: string;
@@ -1715,6 +1730,15 @@ declare class PraxisListWidgetConfigEditor implements SettingsValueProvider$1, A
     readonly isValid$: BehaviorSubject<boolean>;
     readonly isBusy$: BehaviorSubject<boolean>;
     private readonly subscription;
+    private readonly i18n;
+    private childDirty;
+    private persistenceOverride?;
+    private savedPersistenceStrategy?;
+    get persistenceStrategy(): PersistenceStrategy;
+    private get persistenceBaseline();
+    setPersistenceStrategy(value: PersistenceStrategy): void;
+    tx(key: string): string;
+    private publishDirty;
     get config(): PraxisListConfig;
     get listId(): string | undefined;
     ngAfterViewInit(): void;
@@ -2149,6 +2173,13 @@ declare class PraxisListDocPageComponent {
 }
 
 declare const PRAXIS_LIST_EN_US: {
+    readonly "configurationSource.label": "Configuration source";
+    readonly "configurationSource.page": "Page configuration";
+    readonly "configurationSource.individual": "Individual list preferences";
+    readonly "configurationSource.temporary": "Temporary configuration";
+    readonly "configurationSource.input-first.help": "The page defines appearance and content. Recommended when composing a page in Page Builder.";
+    readonly "configurationSource.local-first.help": "Saved list preferences can override the page configuration when loading.";
+    readonly "configurationSource.volatile.help": "Uses the supplied configuration without reading or writing individual preferences. The page can still be saved.";
     readonly configEdit: "Edit configuration";
     readonly expandDetails: "Expand details";
     readonly collapseDetails: "Collapse details";
@@ -2528,6 +2559,13 @@ declare const PRAXIS_LIST_I18N_NAMESPACE = "praxis-list";
 declare function providePraxisListI18n(): i0.Provider[];
 
 declare const PRAXIS_LIST_PT_BR: {
+    readonly "configurationSource.label": "Origem da configuração";
+    readonly "configurationSource.page": "Configuração da página";
+    readonly "configurationSource.individual": "Preferências individuais da lista";
+    readonly "configurationSource.temporary": "Configuração temporária";
+    readonly "configurationSource.input-first.help": "A página define a aparência e o conteúdo. Recomendado ao montar uma página no Page Builder.";
+    readonly "configurationSource.local-first.help": "As preferências salvas desta lista podem substituir a configuração da página ao carregar.";
+    readonly "configurationSource.volatile.help": "Usa a configuração recebida sem ler ou gravar preferências individuais. A página ainda pode ser salva.";
     readonly configEdit: "Editar configurações";
     readonly expandDetails: "Expandir detalhes";
     readonly collapseDetails: "Recolher detalhes";