@praxisui/table 10.0.0-rc.40 → 10.0.0-rc.41

package/ai/component-registry.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": "1.0.0",
-  "generatedAt": "2026-10-26T18:09:20.136Z",
+  "generatedAt": "2026-10-27T22:14:23.237Z",
   "packageName": "@praxisui/table",
-  "packageVersion": "10.0.0-rc.40",
+  "packageVersion": "10.0.0-rc.41",
   "sourceRegistry": "praxis-component-registry-ingestion",
   "sourceRegistryVersion": "1.0.0",
   "componentCount": 3,

package/docs/dynamic-filter-host-integration-guide.md

@@ -42,7 +42,7 @@ source_of_truth:
   - "projects/praxis-table/src/lib/praxis-table.html"
   - "projects/praxis-table/src/lib/components/praxis-filter/praxis-filter.component.ts"
   - "projects/praxis-table/src/lib/services/filter-config.service.ts"
-last_updated: "2026-03-07"
+last_updated: "2026-10-27"
 ---
 
 # Dynamic Filter Host Integration Guide
@@ -108,6 +108,28 @@ O host precisa garantir que a fonte de metadata do filtro e o backend estejam al
 
 Sem isso, o runtime até renderiza o formulário, mas o payload não será previsível.
 
+### Projetar tipos e validar antes de buscar/salvar
+
+Para filtros escalares em array, mantenha `items`/`enumValues` do schema de operação
+nos metadados dos campos. `items` descreve tipo, formato e enum dos itens; não
+substitui o schema de uma coleção de objetos. O normalizador compartilhado de Core
+interpreta somente os tokens admitidos por esse contrato, sem parser específico no
+host ou no controle de filtro.
+
+Use os payloads de `change`/`submit` do componente. O caminho avançado/modal usa a
+projeção do `PraxisFilterForm` filho ao aplicar e salvar, em vez de ler valores raw
+que podem conter strings de UI ou campos com política de omissão. O merge com
+`initialDto` para um atalho é novamente projetado para não restaurar campos
+omitidos. Campos sempre visíveis e avançados seguem a mesma regra; salvar um
+atalho não altera o contrato do backend.
+
+Grupos inválidos/pendentes ou tokens fora do tipo/enum não emitem busca nem atalho,
+e um debounce anterior também precisa respeitar o estado atual. Preserve o
+rascunho para correção. Sem filtros ativos, o DTO vazio pode representar limpeza;
+não transformar o status `DISABLED` desse grupo vazio em bloqueio de clear. Essas
+regras não tornam `contextChange` um DTO: somente sua propriedade `filter` contém
+a consulta; labels e metadata permanecem evidência de apresentação.
+
 ### 2. Configurar `advancedFilters.settings`
 
 Essas chaves são as mais importantes na prática:

package/docs/dynamic-filter-payload-contract.md

@@ -33,7 +33,6 @@ related_docs:
   - "dynamic-filter-range-filters-guide"
   - "dynamic-fields-inline-components-guide"
   - "dynamic-fields-inline-filter-runtime-contract"
-  - "table-overview"
 keywords:
   - "submit"
   - "change"
@@ -42,11 +41,9 @@ keywords:
 source_of_truth:
   - "projects/praxis-table/src/lib/components/praxis-filter/praxis-filter.component.ts"
   - "projects/praxis-table/src/lib/components/praxis-filter/praxis-filter.component.spec.ts"
-  - "../praxis-metadata-starter/src/main/java/org/praxisplatform/uischema/controller/base/AbstractResourceQueryController.java"
-  - "../praxis-metadata-starter/src/main/java/org/praxisplatform/uischema/filter/web/FilterRequestBodyAdvice.java"
-  - "../praxis-metadata-starter/docs/examples/filter-dto.md"
-  - "../praxis-metadata-starter/docs/guides/FILTROS-E-PAGINACAO.md"
-last_updated: "2026-03-07"
+  - "projects/praxis-table/src/lib/components/praxis-filter/filter-payload-projection.ts"
+  - "projects/praxis-core/src/lib/helpers/scalar-array-value.ts"
+last_updated: "2026-10-27"
 ---
 
 # Dynamic Filter Payload Contract
@@ -131,6 +128,32 @@ Aspectos relevantes do runtime:
 - estado avançado e preferências visuais podem ser persistidos localmente;
 - aliases inline e metadata overrides influenciam a UI, mas não devem gerar um contrato HTTP arbitrário.
 
+### Arrays escalares, enum e campos omitidos
+
+O schema de operação pode publicar um array escalar com `items`, por exemplo
+`{ "type": ["array", "null"], "items": { "type": "integer" } }` para um operando
+`IN`. Core conserva `FieldScalarItemsSchema` em `FieldMetadata.items`; o mesmo
+`normalizeScalarArrayValue` valida e converte tokens na projeção do payload.
+`array.itemSchema.fields`, usado para coleções de objetos, é um contrato distinto.
+
+A projeção interna de Table alcança os campos sempre visíveis, o painel avançado,
+`change`, `submit` e atalhos salvos. Ela conserva o shape flat ou aninhado do DTO,
+aplica `submitPolicy: "omit"` e as constraints `items`/`enumValues` publicadas, sem
+modificar o rascunho. Para um request com container, o payload pode ser
+`{ "customFields": { "years": [2024, 2025, 2026] } }`; números não viram datas por
+terem três posições e labels não viram valores de consulta.
+
+Tokens inválidos, valor fora do enum e grupos inválidos/pendentes impedem a emissão,
+inclusive de um debounce agendado antes da invalidez. Não há descarte parcial de
+itens inválidos. `null`/ausência do container e `[]` opcionais não significam que um
+item `null` seja válido. Um grupo sem filtros ativos e `DISABLED` pode produzir a
+limpeza intencional do filtro; isso não equivale a autorizar emissão de um grupo
+com campos ativos inválidos.
+
+O host deve consumir a projeção emitida, não reconstruir o DTO a partir de
+`getRawValue()`, chips ou labels. O backend continua validando o DTO e a operação;
+validação no browser não concede autorização nem certifica execução da consulta.
+
 ### 2. Envio HTTP
 
 O host é responsável por:

package/fesm2022/praxisui-table-authoring.mjs

@@ -1201,6 +1201,12 @@ class TableSchemaColumnProjector {
         const includeOrder = new Map(include.map((field, index) => [field, index]));
         const order = Array.isArray(projection?.order) ? projection.order : include;
         const presentationOrder = new Map(order.map((field, index) => [field, index]));
+        const fieldsByName = new Map();
+        for (const field of Array.isArray(fields) ? fields : []) {
+            const name = typeof field?.name === 'string' ? field.name.trim() : '';
+            if (name)
+                fieldsByName.set(name, field);
+        }
         const schemaColumns = (Array.isArray(fields) ? fields : [])
             .filter((field) => !field.tableHidden && !field.hidden)
             .filter((field) => include.length === 0 || includeOrder.has(field.name))
@@ -1212,15 +1218,18 @@ class TableSchemaColumnProjector {
             const base = this.convertFieldToColumn(field);
             const override = overrides[field.name];
             if (!override || typeof override !== 'object' || Array.isArray(override)) {
+                this.applySchemaComposeItemsQuickView(base, fieldsByName);
                 return base;
             }
             const merged = deepMerge(base, override);
-            return {
+            const projected = {
                 ...merged,
                 field: base.field,
                 _isApiField: base._isApiField,
                 _originalApiType: base._originalApiType,
             };
+            this.applySchemaComposeItemsQuickView(projected, fieldsByName);
+            return projected;
         });
         const canonicalFields = new Set((Array.isArray(fields) ? fields : [])
             .map((field) => String(field?.name || '').trim())
@@ -1367,9 +1376,32 @@ class TableSchemaColumnProjector {
         // Default to string for ambiguous cases
         return 'string';
     }
+    applySchemaComposeItemsQuickView(col, fieldsByName) {
+        const renderer = col?.renderer;
+        if (renderer?.type !== 'compose' || !Array.isArray(renderer?.compose?.items)) {
+            return;
+        }
+        for (const item of renderer.compose.items) {
+            if (!item || typeof item !== 'object')
+                continue;
+            const itemType = typeof item.type === 'string' ? item.type.trim() : 'value';
+            if (itemType !== 'value' || item.quickView !== undefined)
+                continue;
+            const itemFieldName = typeof item.field === 'string' ? item.field.trim() : '';
+            if (!itemFieldName)
+                continue;
+            const itemField = fieldsByName.get(itemFieldName);
+            if (itemField?.quickView) {
+                item.quickView = this.clonePlainObject(itemField.quickView);
+            }
+        }
+    }
     applySchemaFieldPresentation(field, col) {
         if (!field || !col)
             return;
+        if (field.quickView && !col.quickView) {
+            col.quickView = this.clonePlainObject(field.quickView);
+        }
         const controlType = this.normalizePresentationToken(field.controlType);
         const numericFormat = this.normalizePresentationToken(field.numericFormat ?? field.format);
         const valuePresentationType = this.normalizePresentationToken(field.valuePresentation?.type);

package/fesm2022/{praxisui-table-filter-form-dialog-host.component-DlGomgO3.mjs → praxisui-table-filter-form-dialog-host.component-Cst6rkAK.mjs}

@@ -1,5 +1,5 @@
 import * as i0 from '@angular/core';
-import { Inject, Component } from '@angular/core';
+import { ViewChild, Inject, Component } from '@angular/core';
 import * as i1 from '@angular/material/dialog';
 import { MAT_DIALOG_DATA, MatDialogModule } from '@angular/material/dialog';
 import * as i3 from '@angular/material/button';
@@ -12,6 +12,7 @@ import * as i14 from '@angular/material/tooltip';
 import { MatTooltipModule } from '@angular/material/tooltip';
 import { PraxisFilterForm } from '@praxisui/dynamic-form';
 import { PraxisIconButtonComponent } from '@praxisui/core';
+import { aq as projectFilterPayload } from './praxisui-table-praxisui-table-CdEy3SYM.mjs';
 
 class FilterFormDialogHostComponent {
     data;
@@ -20,6 +21,8 @@ class FilterFormDialogHostComponent {
     ready = false;
     lastValue = {};
     formGroup = null;
+    filterForm;
+    pendingAction = null;
     canSave = false;
     saving = false;
     constructor(data, ref) {
@@ -48,11 +51,39 @@ class FilterFormDialogHostComponent {
         this.updateCanSave();
     }
     apply() {
+        this.requestProjectedValue('apply');
+    }
+    requestProjectedValue(action) {
+        if (!this.valid || this.formGroup?.invalid || this.formGroup?.pending)
+            return;
+        if (this.filterForm) {
+            this.pendingAction = action;
+            try {
+                this.filterForm.onFormSubmit();
+            }
+            finally {
+                this.pendingAction = null;
+            }
+            return;
+        }
+        // A host without a rendered form has no schema projection to apply.
+        if (this.data?.config)
+            return;
         const formData = this.formGroup?.getRawValue?.() ??
             this.lastValue ??
             this.data?.initialDto ??
             {};
-        this.ref.close({ formData });
+        this.completeAction(action, formData);
+    }
+    onProjectedSubmit(event) {
+        this.completeAction(this.pendingAction ?? 'apply', event.formData);
+    }
+    completeAction(action, formData) {
+        this.lastValue = formData;
+        if (action === 'apply')
+            this.ref.close({ formData });
+        else
+            this.saveProjectedShortcut(formData);
     }
     close() { this.ref.close(); }
     clean(obj) {
@@ -68,7 +99,8 @@ class FilterFormDialogHostComponent {
         const base = this.data?.initialDto || {};
         const current = this.formGroup?.getRawValue?.() ?? this.lastValue ?? {};
         const merged = { ...base, ...current };
-        return this.clean(merged);
+        const projected = projectFilterPayload(merged, this.data?.config?.fieldMetadata ?? []);
+        return projected === null ? {} : this.clean(projected);
     }
     updateCanSave() {
         this.canSave =
@@ -91,7 +123,13 @@ class FilterFormDialogHostComponent {
     saveShortcut() {
         if (!this.canSave || this.saving)
             return;
-        const dto = this.buildDtoForSave();
+        this.requestProjectedValue('save');
+    }
+    saveProjectedShortcut(projected) {
+        const merged = projectFilterPayload({ ...(this.data?.initialDto || {}), ...projected }, this.data?.config?.fieldMetadata ?? []);
+        if (merged === null)
+            return;
+        const dto = this.clean(merged);
         if (!Object.keys(dto).length)
             return;
         this.saving = true;
@@ -104,7 +142,7 @@ class FilterFormDialogHostComponent {
         }
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.14", ngImport: i0, type: FilterFormDialogHostComponent, deps: [{ token: MAT_DIALOG_DATA }, { token: i1.MatDialogRef }], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "21.2.14", type: FilterFormDialogHostComponent, isStandalone: true, selector: "praxis-filter-form-dialog-host", ngImport: i0, template: `
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "21.2.14", type: FilterFormDialogHostComponent, isStandalone: true, selector: "praxis-filter-form-dialog-host", viewQueries: [{ propertyName: "filterForm", first: true, predicate: PraxisFilterForm, descendants: true }], ngImport: i0, template: `
     <div class="pfx-dialog-title">
       <h2 mat-dialog-title class="pfx-dialog-title-text">
         <mat-icon>tune</mat-icon>
@@ -137,6 +175,7 @@ class FilterFormDialogHostComponent {
           (formReady)="onReady($event)"
           (valueChange)="onChange($event)"
           (validityChange)="onValidity($event)"
+          (submit)="onProjectedSubmit($event)"
         ></praxis-filter-form>
       }
       @if (!data?.config && !data?.schemaLoading) {
@@ -197,6 +236,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.14", ngImpo
           (formReady)="onReady($event)"
           (valueChange)="onChange($event)"
           (validityChange)="onValidity($event)"
+          (submit)="onProjectedSubmit($event)"
         ></praxis-filter-form>
       }
       @if (!data?.config && !data?.schemaLoading) {
@@ -224,6 +264,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.14", ngImpo
         }], ctorParameters: () => [{ type: undefined, decorators: [{
                     type: Inject,
                     args: [MAT_DIALOG_DATA]
-                }] }, { type: i1.MatDialogRef }] });
+                }] }, { type: i1.MatDialogRef }], propDecorators: { filterForm: [{
+                type: ViewChild,
+                args: [PraxisFilterForm]
+            }] } });
 
 export { FilterFormDialogHostComponent };