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

package/package.json

@@ -1,19 +1,19 @@
 {
   "name": "@praxisui/list",
-  "version": "9.0.0-beta.7",
+  "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.7",
+    "@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.7",
-    "@praxisui/core": "^9.0.0-beta.7",
-    "@praxisui/rich-content": "^9.0.0-beta.7",
-    "@praxisui/settings-panel": "^9.0.0-beta.7"
+    "@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`. |
@@ -316,6 +316,7 @@ A integracao com host ocorre por `SettingsValueProvider`:
 | `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`. |
@@ -347,11 +348,11 @@ A integracao com host ocorre por `SettingsValueProvider`:
 | 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 e CSS avancado. | Evoluir depois com preview visual por slot e warnings inline para slots sem template. |
-| `export` | ja-suportado-so-ux | Editor guiado cobre habilitacao, formatos, escopo, cabecalhos, limite, nome de arquivo, formatacao e campos incluidos. | Evoluir depois com preview do payload de exportacao e validacao visual de campo inexistente. |
-| `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. |
-| `rules.itemStyles`/`rules.slotOverrides` | suportado-parcialmente | Runtime e validacao aplicam regras condicionais; authoring visual dedicado ainda ausente. | Criar editor de regras com Json Logic assistido e preview de impacto por slot. |
-| `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. |
+| `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
 
@@ -443,11 +444,11 @@ ref.saved$.subscribe((payload) => {
 
 ### Known limitations and pending investigation
 
-1. Nao existe editor dedicado para `dataSource.data` (dataset local grande).
-2. `rules` possui suporte runtime/capability maior do que a cobertura visual atual do editor; essa area deve evoluir por configurador guiado, nao por contrato paralelo.
-3. `layout.rowLayout` possui editor guiado basico, mas ainda nao tem preview visual por slot nem warnings inline dedicados para slots sem template.
-4. `export` possui editor guiado basico, mas ainda nao tem preview do payload final nem validacao visual dedicada para campo inexistente em `includeFields`.
-5. `expansion.dataSource` remoto e `expansion.schemaContract` permanecem JSON-only ate existir validacao visual e prova runtime especifica no componente.
+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).

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;
@@ -1328,6 +1329,7 @@ declare class PraxisListConfigEditor implements SettingsValueProvider, DoCheck {
     readonly rowLayoutAlignOptions: RowLayoutAlign[];
     readonly rowLayoutColumnAlignOptions: Array<NonNullable<RowLayoutColumn['align']>>;
     readonly rowLayoutJustifyOptions: Array<NonNullable<RowLayoutColumn['justify']>>;
+    readonly rowLayoutStructuralSlots: Set<ListRowLayoutSlot>;
     readonly exportFormatOptions: PraxisExportFormat[];
     readonly exportScopeOptions: PraxisExportScope[];
     readonly expandTriggerOptions: Array<NonNullable<NonNullable<PraxisListConfig['interaction']>['expandTrigger']>>;
@@ -1336,6 +1338,8 @@ declare class PraxisListConfigEditor implements SettingsValueProvider, DoCheck {
     readonly expansionSectionTypeOptions: ListExpansionSectionType[];
     readonly expansionShellOptions: Array<NonNullable<ListExpansionRendering['shell']>>;
     readonly expansionColumnOptions: Array<NonNullable<ListExpansionRendering['columns']>>;
+    readonly ruleSlotOptions: ListSlotOverrideRule['slot'][];
+    readonly ruleTemplateTypeOptions: TemplateType[];
     mappingMetaFields: string[];
     mappingMetaSeparator: string;
     mappingMetaWrapSecondInParens: boolean;
@@ -1382,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;
@@ -1505,6 +1514,8 @@ declare class PraxisListConfigEditor implements SettingsValueProvider, DoCheck {
     removeRowLayoutColumn(index: number): void;
     moveRowLayoutColumn(index: number, direction: -1 | 1): void;
     onRowLayoutChanged(): void;
+    rowLayoutColumnWarning(column: RowLayoutColumn): string;
+    private rowLayoutSlotHasMaterialization;
     private ensureRowLayoutDraft;
     private defaultRowLayout;
     private nextRowLayoutSlot;
@@ -1532,7 +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;
@@ -1545,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;
@@ -1553,6 +1573,37 @@ declare class PraxisListConfigEditor implements SettingsValueProvider, DoCheck {
     getExpansionSectionShowIfText(section: ListExpansionSectionDef): string;
     private ensureExpansionDraft;
     private defaultExpansionSection;
+    addItemStyleRule(): void;
+    removeItemStyleRule(index: number): void;
+    addSlotOverrideRule(): void;
+    removeSlotOverrideRule(index: number): void;
+    onRulesChanged(): void;
+    getRuleConditionText(rule: {
+        condition?: JsonLogicExpression | null;
+    }): string;
+    onRuleConditionChanged(rule: {
+        condition?: JsonLogicExpression | null;
+    }, raw: string): void;
+    getItemStyleEffect(rule: ListItemStyleRule): ListItemStyleEffect | undefined;
+    ensureItemStyleEffect(rule: ListItemStyleRule): void;
+    clearItemStyleEffects(rule: ListItemStyleRule): void;
+    getSlotOverrideEffect(rule: ListSlotOverrideRule): ListSlotOverrideEffect | undefined;
+    ensureSlotOverrideEffect(rule: ListSlotOverrideRule): void;
+    clearSlotOverrideEffects(rule: ListSlotOverrideRule): void;
+    getSlotOverrideTemplateExpr(rule: {
+        template?: TemplateDef;
+    }): string;
+    onSlotOverrideTemplateExprChanged(rule: {
+        template?: TemplateDef;
+    }, expr: string): void;
+    getSlotOverrideTemplateType(rule: {
+        template?: TemplateDef;
+    }): TemplateType;
+    onSlotOverrideTemplateTypeChanged(rule: {
+        template?: TemplateDef;
+    }, type: TemplateType): void;
+    private defaultItemStyleRule;
+    private defaultSlotOverrideRule;
     onSkeletonChanged(value: any): void;
     addUiSortRow(): void;
     removeUiSortRow(i: number): void;