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

package/package.json

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

@@ -312,6 +312,11 @@ A integracao com host ocorre por `SettingsValueProvider`:
 | `layout.stickySectionHeader` | Active | Toggle dedicado. |
 | `layout.virtualScroll` | Active | Toggle dedicado (mesmo que runtime possa nao aplicar). |
 | `layout.pageSize` | Active | Numero inteiro >= 1. |
+| `layout.rowLayout.type/columns/gap/itemAlignY/class/style` | Active | Editor guiado de colunas estaveis para listas corporativas. |
+| `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`. |
@@ -336,7 +341,18 @@ A integracao com host ocorre por `SettingsValueProvider`:
 | `ui.showRange` | Active | Toggle dedicado. |
 | `i18n.locale/currency` | Active | Usado em formatacao de preview/runtime. |
 | `a11y.ariaLabel/ariaLabelledBy/highContrast/reduceMotion` | Active | Editavel no tab de acessibilidade. |
-| `events.itemClick/actionClick/selectionChange/loaded` | Active | Mapeamentos editaveis no tab de eventos. |
+| `events.itemClick/actionClick/selectionChange/exportAction/loaded` | Active | Mapeamentos editaveis no tab de eventos. |
+
+### Coverage inventory for runtime/editor parity
+
+| 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, 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` | 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
 
@@ -429,9 +445,13 @@ ref.saved$.subscribe((payload) => {
 ### Known limitations and pending investigation
 
 1. Nao existe editor dedicado para `dataSource.data` (dataset local grande).
-2. 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.
-3. `isDirty$` usa comparacao por snapshot JSON; mudancas de ordenacao de chaves/objetos podem gerar ruido em cenarios extremos.
-4. Conversao automatica de `globalAction.payload` string para JSON e heuristica (so quando formato parece objeto/array).
+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.
+8. Conversao automatica de `globalAction.payload` string para JSON e heuristica (so quando formato parece objeto/array).
 
 ### Source references
 

package/types/praxisui-list.d.ts

@@ -1142,6 +1142,7 @@ type NormalizedListConfig = Omit<PraxisListConfig, 'dataSource' | 'layout' | 'se
         stickySectionHeader?: boolean;
         virtualScroll?: boolean;
         pageSize?: number;
+        rowLayout?: NonNullable<PraxisListConfig['layout']>['rowLayout'];
     };
     skin: {
         type: 'pill-soft' | 'gradient-tile' | 'glass' | 'elevated' | 'outline' | 'flat' | 'neumorphism' | 'custom';
@@ -1175,6 +1176,9 @@ type NormalizedListConfig = Omit<PraxisListConfig, 'dataSource' | 'layout' | 'se
 };
 type SkinType = NormalizedListConfig['skin']['type'];
 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']>;
 declare class PraxisListConfigEditor implements SettingsValueProvider, DoCheck {
     config: PraxisListConfig;
     listId?: string;
@@ -1320,6 +1324,21 @@ declare class PraxisListConfigEditor implements SettingsValueProvider, DoCheck {
         field?: string;
         dir?: 'asc' | 'desc';
     }>;
+    readonly rowLayoutSlotOptions: ListRowLayoutSlot[];
+    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']>>;
+    readonly expandModeOptions: Array<NonNullable<NonNullable<PraxisListConfig['interaction']>['expandMode']>>;
+    readonly expandPlacementOptions: Array<NonNullable<NonNullable<PraxisListConfig['interaction']>['expandPlacement']>>;
+    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;
@@ -1482,6 +1501,18 @@ declare class PraxisListConfigEditor implements SettingsValueProvider, DoCheck {
     ngDoCheck(): void;
     reset(): void;
     onLayoutChanged(): void;
+    rowLayoutEnabled(): boolean;
+    onRowLayoutEnabledChange(enabled: boolean): void;
+    applyCorporateRowLayoutPreset(): void;
+    addRowLayoutColumn(): void;
+    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;
     onSelectionChanged(): void;
     onSkinGradientChanged(prop: 'from' | 'to' | 'angle', value: string | number): void;
     onSkinTypeChanged(type: SkinType): void;
@@ -1490,6 +1521,76 @@ declare class PraxisListConfigEditor implements SettingsValueProvider, DoCheck {
     onQueryChanged(value: string): void;
     onPageSizeChange(value: any): void;
     onUiChanged(): void;
+    exportEnabled(): boolean;
+    onExportEnabledChange(enabled: boolean): void;
+    onExportChanged(): void;
+    getExportFormatsModel(): PraxisExportFormat[];
+    getExportScopeModel(): PraxisExportScope;
+    getExportIncludeHeadersModel(): boolean;
+    getExportApplyFormattingModel(): boolean;
+    getExportMaxRowsModel(): number | undefined;
+    getExportDefaultFileNameModel(): string;
+    onExportFormatsChange(formats: PraxisExportFormat[]): void;
+    onExportScopeChange(scope: PraxisExportScope): void;
+    onExportDefaultFileNameChange(value: string): void;
+    onExportIncludeHeadersChange(value: boolean): void;
+    onExportApplyFormattingChange(value: boolean): void;
+    onExportMaxRowsChange(value: any): void;
+    getExportIncludeFieldsText(): string;
+    getExportIncludeFieldsWarning(): string;
+    getExportUnknownIncludeFields(): string[];
+    onExportIncludeFieldsTextChange(value: string): void;
+    private ensureExportDraft;
+    expansionEnabled(): boolean;
+    onExpansionEnabledChange(enabled: boolean): void;
+    onExpansionChanged(): void;
+    getExpandTriggerModel(): NonNullable<NonNullable<PraxisListConfig['interaction']>['expandTrigger']>;
+    getExpandModeModel(): NonNullable<NonNullable<PraxisListConfig['interaction']>['expandMode']>;
+    getExpandPlacementModel(): NonNullable<NonNullable<PraxisListConfig['interaction']>['expandPlacement']>;
+    onExpansionInteractionChanged(prop: 'expandTrigger' | 'expandMode' | 'expandPlacement', value: string): void;
+    getExpansionShellModel(): NonNullable<ListExpansionRendering['shell']>;
+    getExpansionColumnsModel(): NonNullable<ListExpansionRendering['columns']>;
+    getExpansionGapModel(): string;
+    getExpansionPaddingModel(): string;
+    onExpansionRenderingChanged(prop: 'shell' | 'columns' | 'gap' | 'padding', value: string | number): void;
+    addExpansionSection(): void;
+    removeExpansionSection(index: number): void;
+    moveExpansionSection(index: number, direction: -1 | 1): void;
+    onExpansionSectionShowIfChanged(section: ListExpansionSectionDef, raw: string): void;
+    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;