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

package/package.json

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

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

@@ -312,6 +312,10 @@ 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. |
 | `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 +340,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 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. |
 
 ### Validacao Estrutural
 
@@ -429,9 +444,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 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.
+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,18 @@ 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 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']>>;
     mappingMetaFields: string[];
     mappingMetaSeparator: string;
     mappingMetaWrapSecondInParens: boolean;
@@ -1482,6 +1498,16 @@ 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;
+    private ensureRowLayoutDraft;
+    private defaultRowLayout;
+    private nextRowLayoutSlot;
     onSelectionChanged(): void;
     onSkinGradientChanged(prop: 'from' | 'to' | 'angle', value: string | number): void;
     onSkinTypeChanged(type: SkinType): void;
@@ -1490,6 +1516,43 @@ 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;
+    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;
     onSkeletonChanged(value: any): void;
     addUiSortRow(): void;
     removeUiSortRow(i: number): void;