@praxisui/list 9.0.0-beta.8 → 9.0.0-beta.9

package/package.json

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

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`. |
@@ -349,10 +349,10 @@ A integracao com host ocorre por `SettingsValueProvider`:
 | --- | --- | --- | --- |
 | `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 e warning para campo inexistente quando o schema esta carregado. | Evoluir depois com preview do payload de exportacao. |
-| `interaction`/`expansion` | suportado-parcialmente | Editor guiado cobre interacao expansivel, secoes inline e rendering; `dataSource` remoto e `schemaContract` continuam JSON-only. | Evoluir fonte remota/schemaContract apenas com validacao de seguranca e prova runtime. |
+| `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, sem editor visual de dataset local. | Manter JSON-only para datasets grandes; considerar import/preview separado se houver demanda operacional. |
+| `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
 
@@ -444,11 +444,11 @@ ref.saved$.subscribe((payload) => {
 
 ### Known limitations and pending investigation
 
-1. Nao existe editor dedicado para `dataSource.data` (dataset local grande).
+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 quando o schema esta carregado, mas ainda nao tem preview do payload final.
-5. `expansion.dataSource` remoto e `expansion.schemaContract` permanecem JSON-only ate existir validacao visual e prova runtime especifica no componente.
+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).

package/types/praxisui-list.d.ts

@@ -1179,6 +1179,7 @@ type SkinPreset = Exclude<SkinType, 'custom'>;
 type RowLayoutColumn = NonNullable<NonNullable<NonNullable<PraxisListConfig['layout']>['rowLayout']>['columns']>[number];
 type RowLayoutAlign = NonNullable<NonNullable<NonNullable<PraxisListConfig['layout']>['rowLayout']>['align']>;
 type ListExpansionRendering = NonNullable<NonNullable<PraxisListConfig['expansion']>['rendering']>;
+type ExportPreviewRow = Record<string, string>;
 declare class PraxisListConfigEditor implements SettingsValueProvider, DoCheck {
     config: PraxisListConfig;
     listId?: string;
@@ -1385,6 +1386,11 @@ declare class PraxisListConfigEditor implements SettingsValueProvider, DoCheck {
     private resetVisualMappingState;
     private setupSchemaWatcher;
     onResourcePathChange(value: string): void;
+    getLocalDataRows(): any[];
+    getLocalDataSummary(): string;
+    getLocalDataPrecedenceWarning(): string;
+    getLocalDataColumns(): string[];
+    getLocalDataPreviewRows(): Array<Record<string, string>>;
     applySkinPreset(preset: SkinPreset): void;
     applyLayoutPreset(preset: 'tiles-modern'): void;
     private defaultPresetLocale;
@@ -1537,9 +1543,14 @@ declare class PraxisListConfigEditor implements SettingsValueProvider, DoCheck {
     onExportApplyFormattingChange(value: boolean): void;
     onExportMaxRowsChange(value: any): void;
     getExportIncludeFieldsText(): string;
+    getExportPreviewColumns(): string[];
+    getExportPreviewRows(): ExportPreviewRow[];
+    getExportPreviewSummary(): string;
     getExportIncludeFieldsWarning(): string;
     getExportUnknownIncludeFields(): string[];
     onExportIncludeFieldsTextChange(value: string): void;
+    private readExportPreviewValue;
+    private formatExportPreviewValue;
     private ensureExportDraft;
     expansionEnabled(): boolean;
     onExpansionEnabledChange(enabled: boolean): void;
@@ -1552,6 +1563,8 @@ declare class PraxisListConfigEditor implements SettingsValueProvider, DoCheck {
     getExpansionColumnsModel(): NonNullable<ListExpansionRendering['columns']>;
     getExpansionGapModel(): string;
     getExpansionPaddingModel(): string;
+    getExpansionRemoteSummary(): string;
+    getExpansionRemoteWarnings(): string[];
     onExpansionRenderingChanged(prop: 'shell' | 'columns' | 'gap' | 'padding', value: string | number): void;
     addExpansionSection(): void;
     removeExpansionSection(index: number): void;