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

package/package.json

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

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

@@ -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,10 +348,10 @@ 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. |
+| `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. |
-| `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. |
+| `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. |
 
 ### Validacao Estrutural
@@ -444,9 +445,9 @@ 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`.
+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.
 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.

package/types/praxisui-list.d.ts

@@ -1328,6 +1328,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 +1337,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;
@@ -1505,6 +1508,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,6 +1537,8 @@ declare class PraxisListConfigEditor implements SettingsValueProvider, DoCheck {
     onExportApplyFormattingChange(value: boolean): void;
     onExportMaxRowsChange(value: any): void;
     getExportIncludeFieldsText(): string;
+    getExportIncludeFieldsWarning(): string;
+    getExportUnknownIncludeFields(): string[];
     onExportIncludeFieldsTextChange(value: string): void;
     private ensureExportDraft;
     expansionEnabled(): boolean;
@@ -1553,6 +1560,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;