@praxisui/table 9.0.57 → 9.0.59

package/ai/component-registry.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": "1.0.0",
-  "generatedAt": "2026-09-01T14:12:48.929Z",
+  "generatedAt": "2026-09-03T20:25:30.797Z",
   "packageName": "@praxisui/table",
-  "packageVersion": "9.0.57",
+  "packageVersion": "9.0.59",
   "sourceRegistry": "praxis-component-registry-ingestion",
   "sourceRegistryVersion": "1.0.0",
   "componentCount": 3,
@@ -186,6 +186,12 @@
           "required": false,
           "description": "DTO parcial emitido durante alterações locais."
         },
+        {
+          "name": "contextChange",
+          "type": "PraxisFilterViewContext",
+          "required": false,
+          "description": "Projeção de apresentação com o DTO canônico e os rótulos resolvidos para composição de página; não deve ser enviada ao backend."
+        },
         {
           "name": "clear",
           "type": "void",
@@ -285,6 +291,20 @@
           "exposure": {
             "public": true,
             "group": "events"
+          },
+          "resourceQueryFieldSource": {
+            "resourcePath": "resourcePath",
+            "apiUrlEntry": "apiUrlEntry",
+            "fieldPaths": [
+              "alwaysVisibleFields",
+              "selectedFieldIds"
+            ],
+            "schemaOperation": {
+              "operationId": "filter",
+              "method": "POST",
+              "pathSuffix": "filter",
+              "requestFieldPath": "$"
+            }
           }
         },
         {
@@ -299,6 +319,37 @@
           },
           "cardinality": "stream",
           "description": "Canonical search request carrying the current filter DTO.",
+          "exposure": {
+            "public": true,
+            "group": "events"
+          },
+          "resourceQueryFieldSource": {
+            "resourcePath": "resourcePath",
+            "apiUrlEntry": "apiUrlEntry",
+            "fieldPaths": [
+              "alwaysVisibleFields",
+              "selectedFieldIds"
+            ],
+            "schemaOperation": {
+              "operationId": "filter",
+              "method": "POST",
+              "pathSuffix": "filter",
+              "requestFieldPath": "$"
+            }
+          }
+        },
+        {
+          "id": "contextChange",
+          "label": "Filter View Context",
+          "direction": "output",
+          "semanticKind": "view-context",
+          "schema": {
+            "id": "PraxisFilterViewContext",
+            "kind": "ts-type",
+            "ref": "PraxisFilterViewContext"
+          },
+          "cardinality": "stream",
+          "description": "Presentation projection with the canonical filter DTO and display labels resolved from field metadata and option sources.",
           "exposure": {
             "public": true,
             "group": "events"
@@ -2441,9 +2492,9 @@
         {
           "chunkIndex": 0,
           "chunkKind": "summary",
-          "content": "Component ID: praxis-filter\nSelector: praxis-filter\nFriendly Name: Praxis Filter\nDescription: Filtro metadata-driven hospedável em páginas dinâmicas, adequado para superfícies analíticas, operacionais e workflows orientados a busca.\nLib/Package: @praxisui/table\nTags: widget, filter, search, metadata-driven, hostable\nInputs:\n  - resourcePath (string)\n  - apiUrlEntry (ApiUrlEntry | null)\n  - fieldMetadata (FieldMetadata[] | null)\n  - filterId (string)\n  - formId (string)\n  - componentInstanceId (string)\n  - enableCustomization (boolean)\n  - showFilterSettings (boolean)\n  - showAdvancedButton (boolean)\n  - showAddButton (boolean)\n  - showClearButton (boolean)\n  - showSearchButton (boolean)\n  - value (Record<string, any>)\n  - alwaysVisibleFields (string[])\n  - alwaysVisibleFieldMetadataOverrides (Record<string, Record<string, any>>)\n  - selectedFieldIds (string[])\n  - persistenceKey (string)\n  - disablePersistence (boolean)\n  - changeDebounceMs (number)\n  - tags (FilterTag[])\n  - allowSaveTags (boolean)\n  - i18n (Partial<I18n>)\n  - placeBooleansInActions (boolean)\n  - advancedOpenMode ('modal' | 'drawer')\nOutputs:\n  - submit (Record<string, any>)\n  - requestSearch (Record<string, any>)\n  - change (Record<string, any>)\n  - clear (void)\n  - tagsChange (FilterTag[])\n  - selectedFieldIdsChange (string[])\n  - metaChanged ({ schemaId: string; serverHash?: string; context: SchemaIdParams })\n  - schemaStatusChange ({ outdated: boolean; serverHash?: string; lastVerifiedAt?: string; formId?: string })\n",
+          "content": "Component ID: praxis-filter\nSelector: praxis-filter\nFriendly Name: Praxis Filter\nDescription: Filtro metadata-driven hospedável em páginas dinâmicas, adequado para superfícies analíticas, operacionais e workflows orientados a busca.\nLib/Package: @praxisui/table\nTags: widget, filter, search, metadata-driven, hostable\nInputs:\n  - resourcePath (string)\n  - apiUrlEntry (ApiUrlEntry | null)\n  - fieldMetadata (FieldMetadata[] | null)\n  - filterId (string)\n  - formId (string)\n  - componentInstanceId (string)\n  - enableCustomization (boolean)\n  - showFilterSettings (boolean)\n  - showAdvancedButton (boolean)\n  - showAddButton (boolean)\n  - showClearButton (boolean)\n  - showSearchButton (boolean)\n  - value (Record<string, any>)\n  - alwaysVisibleFields (string[])\n  - alwaysVisibleFieldMetadataOverrides (Record<string, Record<string, any>>)\n  - selectedFieldIds (string[])\n  - persistenceKey (string)\n  - disablePersistence (boolean)\n  - changeDebounceMs (number)\n  - tags (FilterTag[])\n  - allowSaveTags (boolean)\n  - i18n (Partial<I18n>)\n  - placeBooleansInActions (boolean)\n  - advancedOpenMode ('modal' | 'drawer')\nOutputs:\n  - submit (Record<string, any>)\n  - requestSearch (Record<string, any>)\n  - change (Record<string, any>)\n  - contextChange (PraxisFilterViewContext)\n  - clear (void)\n  - tagsChange (FilterTag[])\n  - selectedFieldIdsChange (string[])\n  - metaChanged ({ schemaId: string; serverHash?: string; context: SchemaIdParams })\n  - schemaStatusChange ({ outdated: boolean; serverHash?: string; lastVerifiedAt?: string; formId?: string })\n",
           "sourcePointer": "projects/praxis-table/src/lib/components/praxis-filter/praxis-filter.metadata.ts",
-          "contentHash": "ccacc3480a6e656493de8b94597db4fb9f67d05ef358476d8450353d49127199",
+          "contentHash": "726b51b531daabb84b0fe5a98bcae0e6663085648b2401d82f3a99bdb59415ec",
           "sourceKind": "component_definition",
           "sourceId": "praxis-filter",
           "corpusVersion": "1.0.0"
@@ -7792,6 +7843,178 @@
           }
         }
       ],
+      "runtimeProfiles": [
+        {
+          "id": "public-local-volatile",
+          "audience": "public-untrusted",
+          "description": "Tabela efêmera com dados inline e sem efeitos externos.",
+          "constraints": [
+            {
+              "path": "resourcePath",
+              "operator": "absent-or-empty"
+            },
+            {
+              "path": "data",
+              "operator": "array"
+            },
+            {
+              "path": "configPersistenceStrategy",
+              "operator": "equals",
+              "value": "volatile"
+            },
+            {
+              "path": "enableCustomization",
+              "operator": "not-true"
+            },
+            {
+              "path": "config.behavior.localDataMode.enabled",
+              "operator": "equals",
+              "value": true
+            },
+            {
+              "path": "config.analyticsProjection",
+              "operator": "absent-or-empty"
+            },
+            {
+              "path": "config.actions.row.enabled",
+              "operator": "not-true"
+            },
+            {
+              "path": "config.actions.bulk.enabled",
+              "operator": "not-true"
+            },
+            {
+              "path": "config.export.enabled",
+              "operator": "not-true"
+            },
+            {
+              "path": "config.ai.assistant.enabled",
+              "operator": "not-true"
+            },
+            {
+              "path": "config.behavior.expansion.detail.source.mode",
+              "operator": "none-of",
+              "values": [
+                "resourcePath",
+                "hypermedia",
+                "surface"
+              ]
+            },
+            {
+              "path": "config.columns[*].renderer.type",
+              "operator": "none-of",
+              "values": [
+                "image",
+                "avatar",
+                "link",
+                "button",
+                "menu"
+              ]
+            },
+            {
+              "path": "config.columns[*].conditionalRenderers[*].renderer.type",
+              "operator": "none-of",
+              "values": [
+                "image",
+                "avatar",
+                "link",
+                "button",
+                "menu"
+              ]
+            }
+          ],
+          "effects": []
+        },
+        {
+          "id": "public-resource-read",
+          "audience": "public-untrusted",
+          "description": "Leitura paginada de recurso público, condicionada a capabilities do backend.",
+          "constraints": [
+            {
+              "path": "resourcePath",
+              "operator": "present"
+            },
+            {
+              "path": "configPersistenceStrategy",
+              "operator": "equals",
+              "value": "volatile"
+            },
+            {
+              "path": "enableCustomization",
+              "operator": "not-true"
+            },
+            {
+              "path": "config.analyticsProjection",
+              "operator": "absent-or-empty"
+            },
+            {
+              "path": "config.actions.row.enabled",
+              "operator": "not-true"
+            },
+            {
+              "path": "config.actions.bulk.enabled",
+              "operator": "not-true"
+            },
+            {
+              "path": "config.export.enabled",
+              "operator": "not-true"
+            },
+            {
+              "path": "config.ai.assistant.enabled",
+              "operator": "not-true"
+            },
+            {
+              "path": "config.behavior.expansion.detail.source.mode",
+              "operator": "none-of",
+              "values": [
+                "resourcePath",
+                "hypermedia",
+                "surface"
+              ]
+            },
+            {
+              "path": "config.columns[*].renderer.type",
+              "operator": "none-of",
+              "values": [
+                "image",
+                "avatar",
+                "link",
+                "button",
+                "menu"
+              ]
+            },
+            {
+              "path": "config.columns[*].conditionalRenderers[*].renderer.type",
+              "operator": "none-of",
+              "values": [
+                "image",
+                "avatar",
+                "link",
+                "button",
+                "menu"
+              ]
+            }
+          ],
+          "effects": [
+            {
+              "kind": "resource-read",
+              "resourcePath": "resourcePath",
+              "operations": [
+                {
+                  "operationId": "filter",
+                  "method": "POST",
+                  "pathSuffix": "filter",
+                  "role": "primary",
+                  "queryContext": {
+                    "portId": "queryContext",
+                    "requestFieldPath": "$"
+                  }
+                }
+              ]
+            }
+          ]
+        }
+      ],
       "configEditor": {
         "component": "[ref:PraxisTableWidgetConfigEditor]",
         "title": "Configurar tabela"

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

@@ -242,6 +242,11 @@ O fluxo típico é:
 5. host observa `submit` ou `change`;
 6. host envia DTO para `/filter` ou `/filter/cursor`.
 
+Quando a página também precisa explicar o recorte ao usuário, observe
+`contextChange` separadamente. O payload mantém o DTO em `filter` e acrescenta os
+rótulos resolvidos em `labels`; ele serve a Rich Content, badges e surfaces. Não o
+reutilize como corpo de `/filter` e não refaça option lookups no host.
+
 ## Persistência local
 
 O runtime já persiste dois grupos de informação:

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

@@ -272,6 +272,24 @@ O caminho canônico passa a ser:
 - a página escreve esse payload em `page.state`
 - a página ou o builder propagam um `queryContext` para widgets de dados
 
+Para narrativas, badges e surfaces, use o output separado `contextChange`. Ele
+publica `PraxisFilterViewContext`, com o DTO canônico em `filter` e as projeções
+`labels`, `fieldLabels` e `fields`. Os rótulos são resolvidos a partir da mesma
+metadata/opção usada pelos campos; não crie mapas paralelos no host.
+
+```json
+{
+  "schemaVersion": "praxis.filter-view-context.v1",
+  "filter": { "departmentId": 10, "status": "ACTIVE" },
+  "labels": { "departmentId": "Engenharia", "status": "Ativo" },
+  "fieldLabels": { "departmentId": "Departamento", "status": "Status" },
+  "fields": []
+}
+```
+
+`filter` é a única parte executável como consulta. O objeto enriquecido completo é
+um `view-context` e não deve ser enviado a `/filter`, stats ou option sources.
+
 Exemplo recomendado:
 
 ```json

package/fesm2022/{praxisui-table-filter-form-dialog-host.component-OZp84Fmo.mjs → praxisui-table-filter-form-dialog-host.component-AdssQ-Tn.mjs}

@@ -4,7 +4,7 @@ import * as i1 from '@angular/material/dialog';
 import { MAT_DIALOG_DATA, MatDialogModule } from '@angular/material/dialog';
 import * as i3 from '@angular/material/button';
 import { MatButtonModule } from '@angular/material/button';
-import * as i14 from '@angular/material/progress-bar';
+import * as i15 from '@angular/material/progress-bar';
 import { MatProgressBarModule } from '@angular/material/progress-bar';
 import * as i7 from '@angular/material/icon';
 import { MatIconModule } from '@angular/material/icon';
@@ -160,7 +160,7 @@ class FilterFormDialogHostComponent {
         {{ data.i18n?.apply || 'Aplicar' }}
       </button>
     </mat-dialog-actions>
-    `, isInline: true, styles: [".pfx-dialog-title{display:flex;align-items:center;justify-content:space-between;gap:12px;padding-right:8px}.pfx-dialog-title-text{display:inline-flex;align-items:center;gap:8px;font-weight:600;color:var(--mdc-dialog-subhead-color, var(--md-sys-color-on-surface))}.pfx-dialog-close{margin-left:auto}.pfx-filter-dialog-content{display:flex;flex-direction:column;gap:12px;padding-top:8px}.pfx-empty-state{margin:8px 0 0;color:var(--mdc-dialog-supporting-text-color, var(--md-sys-color-on-surface-variant))}.pfx-dialog-loading{display:flex;flex-direction:column;gap:10px;min-height:128px;justify-content:center;color:var(--mdc-dialog-supporting-text-color, var(--md-sys-color-on-surface-variant));font-size:.875rem}.pfx-form-pending{height:0;overflow:hidden;visibility:hidden;pointer-events:none}.pfx-dialog-actions{padding:var(--pdx-dialog-actions-padding, 12px 24px 16px);border-top:1px solid var(--md-sys-color-outline-variant);background:transparent;display:flex;align-items:center;gap:8px}.pfx-save-shortcut-button{margin-right:auto}.pfx-save-shortcut-button mat-icon{margin-right:6px;width:18px;height:18px;font-size:18px}\n"], dependencies: [{ kind: "ngmodule", type: MatDialogModule }, { kind: "directive", type: i1.MatDialogTitle, selector: "[mat-dialog-title], [matDialogTitle]", inputs: ["id"], exportAs: ["matDialogTitle"] }, { kind: "directive", type: i1.MatDialogActions, selector: "[mat-dialog-actions], mat-dialog-actions, [matDialogActions]", inputs: ["align"] }, { kind: "directive", type: i1.MatDialogContent, selector: "[mat-dialog-content], mat-dialog-content, [matDialogContent]" }, { kind: "ngmodule", type: MatButtonModule }, { kind: "component", type: i3.MatButton, selector: "    button[matButton], a[matButton], button[mat-button], button[mat-raised-button],    button[mat-flat-button], button[mat-stroked-button], a[mat-button], a[mat-raised-button],    a[mat-flat-button], a[mat-stroked-button]  ", inputs: ["matButton"], exportAs: ["matButton", "matAnchor"] }, { kind: "ngmodule", type: MatProgressBarModule }, { kind: "component", type: i14.MatProgressBar, selector: "mat-progress-bar", inputs: ["color", "value", "bufferValue", "mode"], outputs: ["animationEnd"], exportAs: ["matProgressBar"] }, { kind: "ngmodule", type: MatIconModule }, { kind: "component", type: i7.MatIcon, selector: "mat-icon", inputs: ["color", "inline", "svgIcon", "fontSet", "fontIcon"], exportAs: ["matIcon"] }, { kind: "ngmodule", type: MatTooltipModule }, { kind: "directive", type: i10.MatTooltip, selector: "[matTooltip]", inputs: ["matTooltipPosition", "matTooltipPositionAtOrigin", "matTooltipDisabled", "matTooltipShowDelay", "matTooltipHideDelay", "matTooltipTouchGestures", "matTooltip", "matTooltipClass"], exportAs: ["matTooltip"] }, { kind: "component", type: PraxisFilterForm, selector: "praxis-filter-form", inputs: ["config", "formId", "resourcePath", "mode"], outputs: ["formReady", "valueChange", "submit", "requestSearch", "validityChange"] }, { kind: "component", type: PraxisIconButtonComponent, selector: "button[praxisIconButton]", inputs: ["praxisIconButton", "size", "appearance", "presentation", "pressed", "busy"] }] });
+    `, isInline: true, styles: [".pfx-dialog-title{display:flex;align-items:center;justify-content:space-between;gap:12px;padding-right:8px}.pfx-dialog-title-text{display:inline-flex;align-items:center;gap:8px;font-weight:600;color:var(--mdc-dialog-subhead-color, var(--md-sys-color-on-surface))}.pfx-dialog-close{margin-left:auto}.pfx-filter-dialog-content{display:flex;flex-direction:column;gap:12px;padding-top:8px}.pfx-empty-state{margin:8px 0 0;color:var(--mdc-dialog-supporting-text-color, var(--md-sys-color-on-surface-variant))}.pfx-dialog-loading{display:flex;flex-direction:column;gap:10px;min-height:128px;justify-content:center;color:var(--mdc-dialog-supporting-text-color, var(--md-sys-color-on-surface-variant));font-size:.875rem}.pfx-form-pending{height:0;overflow:hidden;visibility:hidden;pointer-events:none}.pfx-dialog-actions{padding:var(--pdx-dialog-actions-padding, 12px 24px 16px);border-top:1px solid var(--md-sys-color-outline-variant);background:transparent;display:flex;align-items:center;gap:8px}.pfx-save-shortcut-button{margin-right:auto}.pfx-save-shortcut-button mat-icon{margin-right:6px;width:18px;height:18px;font-size:18px}\n"], dependencies: [{ kind: "ngmodule", type: MatDialogModule }, { kind: "directive", type: i1.MatDialogTitle, selector: "[mat-dialog-title], [matDialogTitle]", inputs: ["id"], exportAs: ["matDialogTitle"] }, { kind: "directive", type: i1.MatDialogActions, selector: "[mat-dialog-actions], mat-dialog-actions, [matDialogActions]", inputs: ["align"] }, { kind: "directive", type: i1.MatDialogContent, selector: "[mat-dialog-content], mat-dialog-content, [matDialogContent]" }, { kind: "ngmodule", type: MatButtonModule }, { kind: "component", type: i3.MatButton, selector: "    button[matButton], a[matButton], button[mat-button], button[mat-raised-button],    button[mat-flat-button], button[mat-stroked-button], a[mat-button], a[mat-raised-button],    a[mat-flat-button], a[mat-stroked-button]  ", inputs: ["matButton"], exportAs: ["matButton", "matAnchor"] }, { kind: "ngmodule", type: MatProgressBarModule }, { kind: "component", type: i15.MatProgressBar, selector: "mat-progress-bar", inputs: ["color", "value", "bufferValue", "mode"], outputs: ["animationEnd"], exportAs: ["matProgressBar"] }, { kind: "ngmodule", type: MatIconModule }, { kind: "component", type: i7.MatIcon, selector: "mat-icon", inputs: ["color", "inline", "svgIcon", "fontSet", "fontIcon"], exportAs: ["matIcon"] }, { kind: "ngmodule", type: MatTooltipModule }, { kind: "directive", type: i10.MatTooltip, selector: "[matTooltip]", inputs: ["matTooltipPosition", "matTooltipPositionAtOrigin", "matTooltipDisabled", "matTooltipShowDelay", "matTooltipHideDelay", "matTooltipTouchGestures", "matTooltip", "matTooltipClass"], exportAs: ["matTooltip"] }, { kind: "component", type: PraxisFilterForm, selector: "praxis-filter-form", inputs: ["config", "formId", "resourcePath", "mode"], outputs: ["formReady", "valueChange", "submit", "requestSearch", "validityChange"] }, { kind: "component", type: PraxisIconButtonComponent, selector: "button[praxisIconButton]", inputs: ["praxisIconButton", "size", "appearance", "presentation", "pressed", "busy"] }] });
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.14", ngImport: i0, type: FilterFormDialogHostComponent, decorators: [{
             type: Component,