@praxisui/table 8.0.0-beta.85 → 8.0.0-beta.86

package/fesm2022/{praxisui-table-table-ai.adapter-jpeX3Nbc.mjs → praxisui-table-table-ai.adapter-BvgPN7wY.mjs}

@@ -1,7 +1,7 @@
 import { firstValueFrom } from 'rxjs';
 import { BaseAiAdapter, createComponentAuthoringContext } from '@praxisui/ai';
 import { PRAXIS_GLOBAL_ACTION_CATALOG, deepMerge } from '@praxisui/core';
-import { z as TABLE_COMPONENT_EDIT_PLAN_OPERATION_IDS, k as PRAXIS_TABLE_AUTHORING_MANIFEST, T as TABLE_AI_CAPABILITIES, R as coerceTableComponentEditPlans, W as compileTableComponentEditPlans, G as TASK_PRESETS, $ as getTableComponentEditPlanCapabilities, w as TABLE_COMPONENT_EDIT_PLAN_EXPECTED_PATHS, u as TABLE_COMPONENT_EDIT_PLAN_ALLOWED_CHANGE_KINDS, x as TABLE_COMPONENT_EDIT_PLAN_JSON_SCHEMA, E as TABLE_COMPONENT_EDIT_PLAN_VERSION, v as TABLE_COMPONENT_EDIT_PLAN_BATCH_KIND, y as TABLE_COMPONENT_EDIT_PLAN_KIND } from './praxisui-table-praxisui-table-BdJW7m53.mjs';
+import { G as TABLE_COMPONENT_EDIT_PLAN_OPERATION_IDS, k as PRAXIS_TABLE_AUTHORING_MANIFEST, T as TABLE_AI_CAPABILITIES, W as coerceTableComponentEditPlans, Y as compileTableComponentEditPlans, I as TASK_PRESETS, a1 as getTableComponentEditPlanCapabilities, y as TABLE_COMPONENT_EDIT_PLAN_EXPECTED_PATHS, w as TABLE_COMPONENT_EDIT_PLAN_ALLOWED_CHANGE_KINDS, z as TABLE_COMPONENT_EDIT_PLAN_JSON_SCHEMA, H as TABLE_COMPONENT_EDIT_PLAN_VERSION, x as TABLE_COMPONENT_EDIT_PLAN_BATCH_KIND, E as TABLE_COMPONENT_EDIT_PLAN_KIND } from './praxisui-table-praxisui-table-CpSv6jWv.mjs';
 
 const TABLE_COMPONENT_CONTEXT_PACK = {
     version: 'v1',
@@ -1890,6 +1890,10 @@ const TABLE_RECORD_SURFACE_OPEN_ACTION_IDS = new Set(['surface.open', 'dynamicPa
 const TABLE_EXPORT_SCOPES = ['auto', 'selected', 'filtered', 'currentPage', 'all'];
 const TABLE_EXPORT_FORMATS = ['excel', 'pdf', 'csv', 'json', 'print'];
 const TABLE_UNSUPPORTED_FILTER_COMBINATOR_KEYS = new Set([
+    '!=',
+    '!==',
+    '==',
+    '===',
     '$and',
     '$not',
     '$or',
@@ -1900,6 +1904,8 @@ const TABLE_UNSUPPORTED_FILTER_COMBINATOR_KEYS = new Set([
     'oneOf',
     'or',
 ]);
+const TABLE_FILTER_EQUALITY_OPERATORS = new Set(['==', '===']);
+const TABLE_FILTER_CONJUNCTION_OPERATORS = new Set(['and', '$and']);
 /**
  * Adapter that connects the AI Engine to a specific PraxisTable instance.
  * Implements two-step intent flow + heuristics for contextual suggestions.
@@ -2032,6 +2038,7 @@ class TableAiAdapter extends BaseAiAdapter {
             'Do not use table.filter.apply for related-surface requests unless the user explicitly asks to find other records.',
             'When runtimeOperations.filterExpression.supported is not true, do not materialize OR, alternative groups, or nested boolean filters; ask which single filter field/value should be applied or explain the limitation.',
             'table.filter.apply accepts only simple conjunction criteria over declared fields; do not emit OR/AND groups, anyOf/oneOf/allOf, or nested boolean filter expressions. Ask for clarification or explain the limitation when the user needs alternatives.',
+            'For boolean filters, use the boolean value expected by the declared field, for example { ativo: true } for an active-only filter when the catalog exposes ativo/status as a boolean criterion.',
             ...(runtimeExportFormats.length
                 ? [
                     'Use table.export.run only when the user asks to run an export now; choose scope selected for selected records, filtered for filtered results, and ask for clarification when the user does not specify enough context.',
@@ -2084,6 +2091,7 @@ class TableAiAdapter extends BaseAiAdapter {
                     'The user asks to change table configuration, visual rules, renderers, columns, behavior, actions, or appearance.',
                 ],
                 rules: [
+                    'Do not use componentEditPlan for requests to apply, run, clear, or execute current filters against table data; those belong to runtime mode and tableRuntimeOperations.',
                     'Do not use rowAction.add for capability-discovery questions such as which row buttons or actions can be added; those belong to consult mode until the user explicitly asks to add one.',
                     'Do not use toolbar.action.add or bulkAction.add for capability-discovery questions such as which global actions, toolbar buttons, route buttons, or bulk buttons can be added; those belong to consult mode until the user explicitly asks to add one.',
                     'When the user asks to add a row button, row option, or action in each row for a declared record surface, use rowAction.add with capabilityPath "actions.row.actions[]".',
@@ -2103,11 +2111,16 @@ class TableAiAdapter extends BaseAiAdapter {
                 preferredResponse: TABLE_RUNTIME_OPERATION_BATCH_KIND,
                 useWhen: [
                     'The user asks to execute a declared table runtime operation now, such as applying filters, exporting data, or opening a related dynamic-page surface.',
+                    'The user asks to filter the current table data by a declared filterFieldCatalog field or value, even when no records are selected.',
                     'The user selects records and asks to open, show, display, navigate to, or inspect a declared record surface such as a detail, team, timeline, history, payroll, or other related surface.',
                     'The user selects records and asks to filter or export using declared selectedRecordsContext and runtimeOperations.',
                 ],
                 rules: [
                     'Return type "patch" with tableRuntimeOperations when the request can be materialized by a declared runtimeOperations operation.',
+                    'For table.filter.apply, emit tableRuntimeOperations.operations[] with operationId "table.filter.apply" and input.criteria using declared filterFieldCatalog field names.',
+                    'For boolean filters, use the boolean value expected by the declared field, for example { ativo: true } for an active-only filter when the catalog exposes ativo/status as a boolean criterion.',
+                    'For set filters whose declared field ends with "In", use an array value, for example { departamentoIdsIn: [22], cargoIdsIn: [10] }.',
+                    'For multiple requested filters, emit one table.filter.apply operation with simple conjunction criteria containing every requested declared filter field.',
                     'For dynamicPage.surface.open, emit tableRuntimeOperations.operations[] with operationId "dynamicPage.surface.open" and input.surfaceId equal to one declared recordSurfaces.surfaces[].id.',
                     'For dynamicPage.surface.open, choose a READ_PROJECTION or VIEW recordSurface when the user is asking to see or understand information; choose FORM or PARTIAL_FORM only when the user is asking to edit or update information.',
                     'Do not answer with a textual confirmation before emitting dynamicPage.surface.open when a single requested record surface is declared and the user asks to open or show it now.',
@@ -2392,6 +2405,7 @@ class TableAiAdapter extends BaseAiAdapter {
                 const relatedColumnFields = this.toStringArray(field['relatedColumnFields']);
                 const relatedColumnLabels = this.toStringArray(field['relatedColumnLabels']);
                 const criterionSemantics = this.inferFilterCriterionSemantics(field);
+                const valueHints = this.buildFilterFieldValueHints(field, relatedColumnFields);
                 return {
                     name: field['name'],
                     label: field['label'] ?? field['name'],
@@ -2399,12 +2413,53 @@ class TableAiAdapter extends BaseAiAdapter {
                     controlType: field['controlType'] ?? null,
                     ...(relatedColumnFields.length ? { relatedColumnFields } : {}),
                     ...(relatedColumnLabels.length ? { relatedColumnLabels } : {}),
+                    ...(valueHints.length ? { valueHints } : {}),
                     ...(criterionSemantics ? criterionSemantics : {}),
                     ...(aliases.length ? { aliases } : {}),
                 };
             }),
         };
     }
+    buildFilterFieldValueHints(field, relatedColumnFields) {
+        const values = new Set();
+        const add = (value) => {
+            const text = typeof value === 'string'
+                ? value.trim()
+                : typeof value === 'number' || typeof value === 'boolean'
+                    ? String(value)
+                    : '';
+            if (!text || text.length < 2)
+                return;
+            values.add(text);
+        };
+        const options = Array.isArray(field['options']) ? field['options'] : [];
+        const labelKey = typeof field['optionLabelKey'] === 'string' && field['optionLabelKey'].trim()
+            ? field['optionLabelKey'].trim()
+            : 'label';
+        const valueKey = typeof field['optionValueKey'] === 'string' && field['optionValueKey'].trim()
+            ? field['optionValueKey'].trim()
+            : 'value';
+        for (const option of options) {
+            if (option && typeof option === 'object') {
+                const record = option;
+                add(record[labelKey] ?? record['label'] ?? record['name'] ?? record['description']);
+                add(record[valueKey] ?? record['value'] ?? record['id'] ?? record['key']);
+            }
+            else {
+                add(option);
+            }
+        }
+        const fields = relatedColumnFields.length ? relatedColumnFields : [String(field['name'] || '')].filter(Boolean);
+        const rows = Array.isArray(this.table.dataSource?.data) ? this.table.dataSource.data : [];
+        for (const row of rows.slice(0, 50)) {
+            if (!row || typeof row !== 'object')
+                continue;
+            for (const sourceField of fields) {
+                add(row[sourceField]);
+            }
+        }
+        return [...values].slice(0, 40);
+    }
     getFilterSchemaFields() {
         const tableWithFilterSchema = this.table;
         try {
@@ -2718,6 +2773,7 @@ class TableAiAdapter extends BaseAiAdapter {
         const raw = this.toRecord(source[TABLE_RUNTIME_OPERATION_PATCH_KEY])
             ?? this.toRecord(source['runtimeOperationBatch'])
             ?? this.toRecord(source['tableRuntimeOperation'])
+            ?? (this.stringValue(source['kind']) === TABLE_RUNTIME_OPERATION_BATCH_KIND ? source : null)
             ?? nestedComponentEditPlan;
         const directOperation = this.toRecord(source['runtimeOperation']);
         const directOperations = Array.isArray(source['runtimeOperations']) ? source['runtimeOperations'] : null;
@@ -2748,7 +2804,9 @@ class TableAiAdapter extends BaseAiAdapter {
     coerceTableRuntimeOperationBatchFromText(source) {
         for (const key of ['message', 'assistantMessage', 'content', 'explanation']) {
             const text = this.stringValue(source[key]);
-            if (!text || !text.includes(TABLE_RUNTIME_OPERATION_PATCH_KEY) || !text.includes('operationId')) {
+            if (!text
+                || !text.includes('operationId')
+                || (!text.includes(TABLE_RUNTIME_OPERATION_PATCH_KEY) && !text.includes(TABLE_RUNTIME_OPERATION_BATCH_KIND))) {
                 continue;
             }
             const parsed = this.parseRuntimeOperationJsonFromText(text);
@@ -2817,7 +2875,7 @@ class TableAiAdapter extends BaseAiAdapter {
         const warnings = [];
         for (const operation of batch.operations) {
             if (operation.operationId === 'table.filter.apply') {
-                const criteria = this.toRecord(operation.input['criteria']);
+                const criteria = this.normalizeRuntimeFilterCriteria(this.toRecord(operation.input['criteria']));
                 if (!criteria) {
                     return {
                         success: false,
@@ -3069,6 +3127,109 @@ class TableAiAdapter extends BaseAiAdapter {
             return Array.isArray(value) || this.toRecord(value) !== null;
         });
     }
+    normalizeRuntimeFilterCriteria(criteria) {
+        if (!criteria)
+            return null;
+        const jsonLogicCriteria = this.tryNormalizeJsonLogicFilterCriteria(criteria);
+        if (jsonLogicCriteria)
+            return jsonLogicCriteria;
+        const normalized = {};
+        let changed = false;
+        for (const [field, value] of Object.entries(criteria)) {
+            const canonicalField = this.normalizeRuntimeFilterFieldName(field);
+            const fieldCriteria = this.normalizeRuntimeFilterFieldCriterion(canonicalField, value);
+            normalized[canonicalField] = fieldCriteria;
+            changed = changed || canonicalField !== field || fieldCriteria !== value;
+        }
+        return changed ? normalized : criteria;
+    }
+    tryNormalizeJsonLogicFilterCriteria(criteria) {
+        const entries = Object.entries(criteria);
+        if (entries.length !== 1)
+            return null;
+        const [operator, value] = entries[0];
+        if (TABLE_FILTER_EQUALITY_OPERATORS.has(operator)) {
+            return this.normalizeRuntimeFilterEquality(value);
+        }
+        if (TABLE_FILTER_CONJUNCTION_OPERATORS.has(operator) && Array.isArray(value)) {
+            const normalized = {};
+            for (const clause of value) {
+                const clauseRecord = this.toRecord(clause);
+                const clauseCriteria = clauseRecord ? this.tryNormalizeJsonLogicFilterCriteria(clauseRecord) : null;
+                if (!clauseCriteria)
+                    return null;
+                for (const [field, criterion] of Object.entries(clauseCriteria)) {
+                    normalized[field] = criterion;
+                }
+            }
+            return Object.keys(normalized).length ? normalized : null;
+        }
+        return null;
+    }
+    normalizeRuntimeFilterEquality(value) {
+        if (!Array.isArray(value) || value.length !== 2)
+            return null;
+        const leftField = this.normalizeRuntimeFilterFieldName(this.jsonLogicVarField(value[0]));
+        const rightField = this.normalizeRuntimeFilterFieldName(this.jsonLogicVarField(value[1]));
+        if (leftField && !rightField)
+            return { [leftField]: this.normalizeRuntimeFilterCriterionValue(leftField, value[1]) };
+        if (rightField && !leftField)
+            return { [rightField]: this.normalizeRuntimeFilterCriterionValue(rightField, value[0]) };
+        return null;
+    }
+    normalizeRuntimeFilterFieldName(field) {
+        if (!field)
+            return '';
+        const raw = field.trim();
+        if (!raw)
+            return '';
+        const normalized = this.normalizeAliasValue(raw);
+        if (!normalized)
+            return raw;
+        const matches = this.getFilterSchemaFields()
+            .map((candidate) => {
+            const name = this.stringValue(candidate['name']);
+            if (!name)
+                return null;
+            const aliases = new Set();
+            this.addFilterFieldAlias(aliases, name);
+            this.addFilterFieldAlias(aliases, candidate['label']);
+            this.toStringArray(candidate['aliases']).forEach((alias) => this.addFilterFieldAlias(aliases, alias));
+            this.toStringArray(candidate['relatedColumnFields']).forEach((alias) => this.addFilterFieldAlias(aliases, alias));
+            this.toStringArray(candidate['relatedColumnLabels']).forEach((alias) => this.addFilterFieldAlias(aliases, alias));
+            return aliases.has(normalized) ? name : null;
+        })
+            .filter((name) => !!name);
+        return matches.length === 1 ? matches[0] : raw;
+    }
+    normalizeRuntimeFilterCriterionValue(field, value) {
+        if (/In$/u.test(field) && !Array.isArray(value)) {
+            return [value];
+        }
+        return value;
+    }
+    normalizeRuntimeFilterFieldCriterion(field, value) {
+        const record = this.toRecord(value);
+        if (!record)
+            return this.normalizeRuntimeFilterCriterionValue(field, value);
+        const entries = Object.entries(record);
+        if (entries.length !== 1)
+            return value;
+        const [operator, criterion] = entries[0];
+        if (!TABLE_FILTER_EQUALITY_OPERATORS.has(operator))
+            return value;
+        return this.normalizeRuntimeFilterCriterionValue(field, criterion);
+    }
+    jsonLogicVarField(value) {
+        const record = this.toRecord(value);
+        if (!record)
+            return null;
+        const raw = record['var'];
+        if (typeof raw !== 'string')
+            return null;
+        const field = raw.trim();
+        return field ? field : null;
+    }
     stringValue(value) {
         return typeof value === 'string' ? value.trim() : '';
     }
@@ -3525,7 +3686,16 @@ Columns Analysis:
             const patchCols = patch.columns;
             const mergedCols = originalCols.map((origCol) => {
                 const match = patchCols.find((p) => p.field === origCol.field);
-                return match ? deepMerge(origCol, match) : origCol;
+                if (!match)
+                    return origCol;
+                const merged = deepMerge(origCol, match);
+                if (Array.isArray(match.conditionalRenderers)) {
+                    merged.conditionalRenderers = match.conditionalRenderers;
+                }
+                if (Array.isArray(match.conditionalStyles)) {
+                    merged.conditionalStyles = match.conditionalStyles;
+                }
+                return merged;
             });
             patchCols.forEach((pCol) => {
                 if (!originalCols.find((o) => o.field === pCol.field)) {

package/fesm2022/praxisui-table.mjs

@@ -1 +1 @@
-export { A as AnalyticsTableConfigAdapterService, a as AnalyticsTableContractService, b as AnalyticsTableStatsApiService, B as BOOLEAN_PRESETS, c as BehaviorConfigEditorComponent, C as CURRENCY_PRESETS, d as ColumnsConfigEditorComponent, D as DATE_PRESETS, e as DataFormatterComponent, f as DataFormattingService, F as FORMULA_TEMPLATES, g as FilterConfigService, h as FilterSettingsComponent, i as FormulaGeneratorService, J as JsonConfigEditorComponent, M as MessagesLocalizationEditorComponent, N as NUMBER_PRESETS, P as PERCENTAGE_PRESETS, j as PRAXIS_FILTER_COMPONENT_METADATA, k as PRAXIS_TABLE_AUTHORING_MANIFEST, l as PRAXIS_TABLE_COMPONENT_METADATA, m as PraxisFilter, n as PraxisFilterWidgetConfigEditor, o as PraxisTable, p as PraxisTableConfigEditor, q as PraxisTableInlineAuthoringEditorComponent, r as PraxisTableToolbar, s as PraxisTableWidgetConfigEditor, S as STRING_PRESETS, T as TABLE_AI_CAPABILITIES, t as TABLE_COMPONENT_AI_CAPABILITIES, u as TABLE_COMPONENT_EDIT_PLAN_ALLOWED_CHANGE_KINDS, v as TABLE_COMPONENT_EDIT_PLAN_BATCH_KIND, w as TABLE_COMPONENT_EDIT_PLAN_EXPECTED_PATHS, x as TABLE_COMPONENT_EDIT_PLAN_JSON_SCHEMA, y as TABLE_COMPONENT_EDIT_PLAN_KIND, E as TABLE_COMPONENT_EDIT_PLAN_VERSION, G as TASK_PRESETS, H as TableDefaultsProvider, I as TableRulesEditorComponent, K as ToolbarActionsEditorComponent, V as ValueMappingEditorComponent, L as VisualFormulaBuilderComponent, O as buildTableApplyPlan, Q as coerceTableComponentEditPlan, R as coerceTableComponentEditPlans, U as compileTableComponentEditPlan, W as compileTableComponentEditPlans, X as createTableAuthoringDocument, Y as getActionId, Z as getEnum, _ as getTableCapabilities, $ as getTableComponentEditPlanCapabilities, a0 as isTableRendererSupportedByRichContentP0, a1 as mapTableRendererToRichContentP0, a2 as normalizeTableAuthoringDocument, a3 as parseLegacyOrTableDocument, a4 as providePraxisFilterMetadata, a5 as providePraxisTableMetadata, a6 as serializeTableAuthoringDocument, a7 as toCanonicalTableConfig, a8 as validateTableAuthoringDocument } from './praxisui-table-praxisui-table-BdJW7m53.mjs';
+export { A as AnalyticsTableConfigAdapterService, a as AnalyticsTableContractService, b as AnalyticsTableStatsApiService, B as BOOLEAN_PRESETS, c as BehaviorConfigEditorComponent, C as CURRENCY_PRESETS, d as ColumnsConfigEditorComponent, D as DATE_PRESETS, e as DataFormatterComponent, f as DataFormattingService, F as FORMULA_TEMPLATES, g as FilterConfigService, h as FilterSettingsComponent, i as FormulaGeneratorService, J as JsonConfigEditorComponent, M as MessagesLocalizationEditorComponent, N as NUMBER_PRESETS, P as PERCENTAGE_PRESETS, j as PRAXIS_FILTER_COMPONENT_METADATA, k as PRAXIS_TABLE_AUTHORING_MANIFEST, l as PRAXIS_TABLE_COMPONENT_METADATA, m as PRAXIS_TABLE_TOOLBAR_DEFAULT_APPEARANCE, n as PRAXIS_TABLE_TOOLBAR_TOKEN_PRESETS, o as PraxisFilter, p as PraxisFilterWidgetConfigEditor, q as PraxisTable, r as PraxisTableConfigEditor, s as PraxisTableInlineAuthoringEditorComponent, t as PraxisTableToolbar, u as PraxisTableWidgetConfigEditor, S as STRING_PRESETS, T as TABLE_AI_CAPABILITIES, v as TABLE_COMPONENT_AI_CAPABILITIES, w as TABLE_COMPONENT_EDIT_PLAN_ALLOWED_CHANGE_KINDS, x as TABLE_COMPONENT_EDIT_PLAN_BATCH_KIND, y as TABLE_COMPONENT_EDIT_PLAN_EXPECTED_PATHS, z as TABLE_COMPONENT_EDIT_PLAN_JSON_SCHEMA, E as TABLE_COMPONENT_EDIT_PLAN_KIND, H as TABLE_COMPONENT_EDIT_PLAN_VERSION, I as TASK_PRESETS, K as TableDefaultsProvider, L as TableRulesEditorComponent, O as ToolbarActionsEditorComponent, V as ValueMappingEditorComponent, Q as VisualFormulaBuilderComponent, R as buildTableApplyPlan, U as coerceTableComponentEditPlan, W as coerceTableComponentEditPlans, X as compileTableComponentEditPlan, Y as compileTableComponentEditPlans, Z as createTableAuthoringDocument, _ as getActionId, $ as getEnum, a0 as getTableCapabilities, a1 as getTableComponentEditPlanCapabilities, a2 as isTableRendererSupportedByRichContentP0, a3 as mapTableRendererToRichContentP0, a4 as normalizeTableAuthoringDocument, a5 as parseLegacyOrTableDocument, a6 as providePraxisFilterMetadata, a7 as providePraxisTableMetadata, a8 as providePraxisTableToolbarAppearance, a9 as serializeTableAuthoringDocument, aa as toCanonicalTableConfig, ab as validateTableAuthoringDocument } from './praxisui-table-praxisui-table-CpSv6jWv.mjs';

package/package.json

@@ -1,23 +1,23 @@
 {
   "name": "@praxisui/table",
-  "version": "8.0.0-beta.85",
+  "version": "8.0.0-beta.86",
   "description": "Advanced data table for Angular (Praxis UI) with editing, filtering, sorting, virtualization, and settings panel integration.",
   "peerDependencies": {
     "@angular/common": "^21.0.0",
     "@angular/core": "^21.0.0",
-    "@praxisui/ai": "^8.0.0-beta.85",
-    "@praxisui/core": "^8.0.0-beta.85",
-    "@praxisui/dynamic-fields": "^8.0.0-beta.85",
-    "@praxisui/dynamic-form": "^8.0.0-beta.85",
-    "@praxisui/metadata-editor": "^8.0.0-beta.85",
-    "@praxisui/rich-content": "^8.0.0-beta.85",
-    "@praxisui/settings-panel": "^8.0.0-beta.85",
-    "@praxisui/table-rule-builder": "^8.0.0-beta.85",
+    "@praxisui/ai": "^8.0.0-beta.86",
+    "@praxisui/core": "^8.0.0-beta.86",
+    "@praxisui/dynamic-fields": "^8.0.0-beta.86",
+    "@praxisui/dynamic-form": "^8.0.0-beta.86",
+    "@praxisui/metadata-editor": "^8.0.0-beta.86",
+    "@praxisui/rich-content": "^8.0.0-beta.86",
+    "@praxisui/settings-panel": "^8.0.0-beta.86",
+    "@praxisui/table-rule-builder": "^8.0.0-beta.86",
     "@angular/cdk": "^21.0.0",
     "@angular/forms": "^21.0.0",
     "@angular/material": "^21.0.0",
     "@angular/router": "^21.0.0",
-    "@praxisui/dialog": "^8.0.0-beta.85",
+    "@praxisui/dialog": "^8.0.0-beta.86",
     "rxjs": "~7.8.0"
   },
   "dependencies": {

package/src/lib/praxis-table.json-api.md

@@ -316,6 +316,7 @@ Este arquivo foi adaptado para o padrao canonico atual sem remover conteudo tecn
 | `behavior.expansion.interaction.motion` | object | No | runtime-defaults | preset-driven | Presets controlados (`none`, `subtle-slide`, `accordion`, `fade-scale`) com respeito a `prefers-reduced-motion`; `durationMs` aceita `0` para desabilitar motion temporal. |
 | `appearance.responsive` | object | No | component-defaults | numeric-breakpoint | Breakpoint móvel inválido é normalizado para `768`. |
 | `toolbar.actions[]` | array | No | `[]` | action-contract | Ações de toolbar com roteamento para `toolbarAction`/`bulkAction`. |
+| `toolbar.appearance` | object | No | Material 3 fallback | token-contract | Governa variante, densidade, forma, divisores e tokens públicos da toolbar sem alterar a semântica das ações. |
 | `actions.row.actions[].recordSurface` | object | No | none | `ResourceSurfaceCatalogItem` | Preserva a identidade canônica da superfície relacionada aberta por uma ação de linha, mantendo `actions.row.actions[].id` como identidade do botão. |
 | `actions.row.discovery.enabled` | boolean | No | `true` | row-action-discovery | Controla se row actions podem ser enriquecidas por HATEOAS/capabilities. Configure `false` para manter somente ações declaradas em `actions.row.actions[]`. |
 | `columns[].renderer` | object | No | field-type-driven | renderer-contract | Renderers condicionais, payload expr e ações interativas. |
@@ -329,6 +330,8 @@ Este arquivo foi adaptado para o padrao canonico atual sem remover conteudo tecn
 
 - O bloco `toolbar` continua parte do contrato público principal.
 - Use `toolbar.actions[]` para quick actions e `toolbar.search` para busca quando o host não injeta shell própria.
+- Use `toolbar.appearance` para personalizar o chrome da toolbar por contrato governado. O runtime materializa `variant`, `density`, `shape`, `divider` e `tokens` como classes e CSS custom properties públicas; o host pode trocar aparência sem redefinir intenção, capability ou roteamento.
+- Tokens públicos suportados em `toolbar.appearance.tokens`: `bg`, `fg`, `borderColor`, `borderWidth`, `radius`, `shadow`, `paddingBlock`, `paddingInline`, `minHeight`, `gap`, `actionsGap`, `dividerColor`, `actionSize`, `actionRadius`, `actionBg`, `actionFg`, `actionHoverBg`, `actionActiveBg`, `actionFocusRing`, `aiAccentColor` e `statusFg`.
 - Para localizar paths específicos de toolbar, complemente a leitura com o `Appendix: JSON path index`.
 
 ### Messages contract
@@ -1157,6 +1160,7 @@ A superficie usa `horizontalScroll` com classes:
 | `columns[]` | `TableColumnConfig[]` | Yes | `[]` | Active | Definicao de colunas, renderers e regras de exibicao. |
 | `behavior` | `TableBehaviorConfig` | No | defaults do runtime | Partial | Inclui paginacao, filtro, selecao e expansao por blocos. |
 | `toolbar.actions[]` | `ToolbarActionConfig[]` | No | `[]` | Partial | Acoes de toolbar com roteamento para `toolbarAction` e `bulkAction`. |
+| `toolbar.appearance` | `TableToolbarAppearanceConfig` | No | fallback M3 | Active | Chrome visual governado da toolbar; tokens viram `--p-table-toolbar-*` no runtime. |
 | `messages` | `TableMessagesConfig` | No | defaults internos | Partial | Overrides de i18n e mensagens operacionais. |
 | `data` | `TableDataConfig` | No | modo local/remoto autodetectado | Partial | Integra origem local ou remota conforme `resourcePath`/inputs. |
 

package/types/praxisui-table.d.ts

@@ -1,7 +1,7 @@
 import * as _praxisui_core from '@praxisui/core';
-import { TableConfig, LoggerService, PraxisI18nService, GlobalConfigService, AsyncConfigStorage, FieldMetadata, SchemaIdParams, FormConfig, GenericCrudService, DynamicFormService, SchemaNormalizerService, ComponentKeyService, ComponentDocMeta, PraxisTextValue, PraxisAnalyticsProjection, PraxisDataQueryContext, ApiUrlConfig, PraxisQueryFilterExpression, RecordRelatedSurfaceContextPack, LoadingState, RestApiLinks, ColumnDefinition, RichBlockNode, ResourceCapabilityDigest, ConnectionStorage, LoadingOrchestrator, GlobalActionService, PraxisLoadingRenderer, TableDetailRichListNode, TableDetailCardGridNode, TableDetailCardGridCardNode, TableDetailTimelineNode, JsonLogicDataRecord, TableDetailListItemAction, TableDetailActionBarNode, TableDetailActionBarAction, TableDetailRefNode, TableDetailTemplateRefNode, TableDetailDiagramEmbedNode, TableDetailEmbedAction, PraxisExportScope, GlobalActionRef, PraxisRuntimeGlobalActionEffect, ResourceActionCatalogItem, ResourceSurfaceCatalogItem, JsonLogicExpression, GlobalActionCatalogEntry, IconPickerService, SurfaceOpenPayload, GlobalActionField, FieldDefinition, PraxisRuntimeConditionalEffectRule, PraxisJsonLogicService, TableConfigService, SettingsValueProvider as SettingsValueProvider$1, AnalyticsSchemaContractService, AnalyticsPresentationResolver, RichPresenterNode, RichComposeNode, ComponentAuthoringManifest, AiCapability, AiCapabilityCategory, AiValueKind, AiCapabilityCatalog } from '@praxisui/core';
+import { TableToolbarAppearanceConfig, TableConfig, LoggerService, PraxisI18nService, TableToolbarAppearanceVariant, TableToolbarAppearanceDensity, TableToolbarAppearanceShape, TableToolbarAppearanceDivider, TableToolbarTokenName, GlobalConfigService, AsyncConfigStorage, FieldMetadata, SchemaIdParams, FormConfig, GenericCrudService, DynamicFormService, SchemaNormalizerService, ComponentKeyService, ComponentDocMeta, PraxisTextValue, PraxisAnalyticsProjection, PraxisDataQueryContext, ApiUrlConfig, PraxisQueryFilterExpression, RecordRelatedSurfaceContextPack, LoadingState, RestApiLinks, ColumnDefinition, RichBlockNode, ResourceCapabilityDigest, ConnectionStorage, LoadingOrchestrator, GlobalActionService, PraxisLoadingRenderer, TableDetailRichListNode, TableDetailCardGridNode, TableDetailCardGridCardNode, TableDetailTimelineNode, JsonLogicDataRecord, TableDetailListItemAction, TableDetailActionBarNode, TableDetailActionBarAction, TableDetailRefNode, TableDetailTemplateRefNode, TableDetailDiagramEmbedNode, TableDetailEmbedAction, PraxisExportScope, GlobalActionRef, PraxisRuntimeGlobalActionEffect, ResourceActionCatalogItem, ResourceSurfaceCatalogItem, JsonLogicExpression, GlobalActionCatalogEntry, IconPickerService, SurfaceOpenPayload, GlobalActionField, FieldDefinition, PraxisRuntimeConditionalEffectRule, PraxisJsonLogicService, TableConfigService, SettingsValueProvider as SettingsValueProvider$1, AnalyticsSchemaContractService, AnalyticsPresentationResolver, RichPresenterNode, RichComposeNode, ComponentAuthoringManifest, AiCapability, AiCapabilityCategory, AiValueKind, AiCapabilityCatalog } from '@praxisui/core';
 import * as i0 from '@angular/core';
-import { OnDestroy, EventEmitter, ElementRef, OnInit, OnChanges, AfterViewInit, DoCheck, DestroyRef, ChangeDetectorRef, NgZone, SimpleChanges, ComponentRef, Provider, AfterContentInit, Injector } from '@angular/core';
+import { InjectionToken, OnDestroy, EventEmitter, ElementRef, Provider, OnInit, OnChanges, AfterViewInit, DoCheck, DestroyRef, ChangeDetectorRef, NgZone, SimpleChanges, ComponentRef, AfterContentInit, Injector } from '@angular/core';
 import { ActivatedRoute } from '@angular/router';
 import { MatTable, MatTableDataSource } from '@angular/material/table';
 import * as _angular_material_paginator from '@angular/material/paginator';
@@ -36,11 +36,17 @@ interface ActionLike {
 }
 declare function getActionId(action: ActionLike): string;
 
+declare const PRAXIS_TABLE_TOOLBAR_DEFAULT_APPEARANCE: InjectionToken<TableToolbarAppearanceConfig>;
+declare const PRAXIS_TABLE_TOOLBAR_TOKEN_PRESETS: InjectionToken<Record<string, TableToolbarAppearanceConfig>>;
+declare function providePraxisTableToolbarAppearance(appearance: TableToolbarAppearanceConfig, presets?: Record<string, TableToolbarAppearanceConfig>): Provider[];
 declare class PraxisTableToolbar implements OnDestroy {
     private hostRef;
     private logger?;
     private i18n?;
+    private defaultAppearance?;
+    private tokenPresets?;
     config?: TableConfig;
+    appearance?: TableToolbarAppearanceConfig | null;
     backgroundColor: string | null;
     placement: 'header' | 'footer';
     showMain: boolean;
@@ -67,12 +73,25 @@ declare class PraxisTableToolbar implements OnDestroy {
     private readonly warnedShortcutConflicts;
     private fallbackLogger?;
     private fallbackLoggerEnvironment;
-    constructor(hostRef?: ElementRef<HTMLElement> | null, logger?: LoggerService | undefined, i18n?: PraxisI18nService | undefined);
+    constructor(hostRef?: ElementRef<HTMLElement> | null, logger?: LoggerService | undefined, i18n?: PraxisI18nService | undefined, defaultAppearance?: TableToolbarAppearanceConfig | undefined, tokenPresets?: Record<string, TableToolbarAppearanceConfig> | undefined);
+    getToolbarAriaLabel(): string;
+    getToolbarLeadingLabel(): string;
+    getToolbarActionsLabel(): string;
+    getToolbarConfigurationLabel(): string;
     getExportDataLabel(): string;
     getMoreActionsLabel(): string;
     emitExportAction(event: Event, format: string): void;
     private tx;
     ngOnDestroy(): void;
+    getToolbarVariant(): TableToolbarAppearanceVariant;
+    getToolbarDensity(): TableToolbarAppearanceDensity;
+    getToolbarShape(): TableToolbarAppearanceShape;
+    getToolbarDivider(): TableToolbarAppearanceDivider;
+    getToolbarToken(name: TableToolbarTokenName): string | null;
+    private resolveToolbarAppearance;
+    private resolveToolbarAppearancePreset;
+    private mergeToolbarAppearance;
+    private normalizeTokenValue;
     private getNestedPropertyValue;
     private cloneForEmit;
     private getLogger;
@@ -117,8 +136,8 @@ declare class PraxisTableToolbar implements OnDestroy {
     private warnShortcutConflict;
     private sortActions;
     getExportIcon(format: string): string;
-    static ɵfac: i0.ɵɵFactoryDeclaration<PraxisTableToolbar, [null, { optional: true; }, { optional: true; }]>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<PraxisTableToolbar, "praxis-table-toolbar", never, { "config": { "alias": "config"; "required": false; }; "backgroundColor": { "alias": "backgroundColor"; "required": false; }; "placement": { "alias": "placement"; "required": false; }; "showMain": { "alias": "showMain"; "required": false; }; "showActionsGroup": { "alias": "showActionsGroup"; "required": false; }; "showEndActions": { "alias": "showEndActions"; "required": false; }; "showMobileActions": { "alias": "showMobileActions"; "required": false; }; "exportBusy": { "alias": "exportBusy"; "required": false; }; "evaluationContext": { "alias": "evaluationContext"; "required": false; }; }, { "toolbarAction": "toolbarAction"; "exportAction": "exportAction"; }, never, ["[advancedFilter]", "[toolbar]", "[end-actions]"], true, never>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<PraxisTableToolbar, [null, { optional: true; }, { optional: true; }, { optional: true; }, { optional: true; }]>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<PraxisTableToolbar, "praxis-table-toolbar", never, { "config": { "alias": "config"; "required": false; }; "appearance": { "alias": "appearance"; "required": false; }; "backgroundColor": { "alias": "backgroundColor"; "required": false; }; "placement": { "alias": "placement"; "required": false; }; "showMain": { "alias": "showMain"; "required": false; }; "showActionsGroup": { "alias": "showActionsGroup"; "required": false; }; "showEndActions": { "alias": "showEndActions"; "required": false; }; "showMobileActions": { "alias": "showMobileActions"; "required": false; }; "exportBusy": { "alias": "exportBusy"; "required": false; }; "evaluationContext": { "alias": "evaluationContext"; "required": false; }; }, { "toolbarAction": "toolbarAction"; "exportAction": "exportAction"; }, never, ["[advancedFilter]", "[toolbar]", "[end-actions]"], true, never>;
 }
 
 type ColumnDataType$1 = 'date' | 'number' | 'currency' | 'percentage' | 'string' | 'boolean' | 'custom';
@@ -619,6 +638,7 @@ declare class PraxisFilter implements OnInit, OnChanges, AfterViewInit, OnDestro
     private computeIsMobile;
     ngOnChanges(changes: SimpleChanges): void;
     private areStringArraysEqual;
+    private normalizeFieldIdList;
     private areMetadataOverrideMapsEqual;
     /** Force-sync settings coming from parent table config updates. */
     applyExternalSettings(cfg?: Partial<FilterConfig>): void;
@@ -1311,6 +1331,7 @@ declare class PraxisTable implements OnInit, OnChanges, AfterViewInit, AfterCont
     onAiAssistantQuickReply(reply: PraxisAssistantShellQuickReply): void;
     getAiAssistantRecommendedIntents(): readonly PraxisAssistantRecommendedIntent[];
     onAiAssistantRecommendedIntent(intent: PraxisAssistantRecommendedIntent): void;
+    private getAiAssistantRecommendationResponseContract;
     onAiAssistantEditMessage(message: PraxisAssistantShellMessage): void;
     onAiAssistantResendMessage(message: PraxisAssistantShellMessage): void;
     onAiAssistantLayoutChange(layout: PraxisAssistantShellLayout): void;
@@ -1713,6 +1734,8 @@ declare class PraxisTable implements OnInit, OnChanges, AfterViewInit, AfterCont
     private ensureRowCapabilitySnapshot;
     private ensureRowActionCatalog;
     private getCachedRowCapabilitySnapshot;
+    private getAiAssistantRowDiscoveryLinks;
+    private mergeRowCapabilitySnapshots;
     private hasResolvedRowActionCatalog;
     isRowDiscoveryPending(row: any): boolean;
     private getCachedRowActionCatalog;
@@ -3800,6 +3823,9 @@ declare class PraxisTableInlineAuthoringEditorComponent implements OnChanges {
     toolbarVisible: boolean;
     density: 'compact' | 'comfortable' | 'spacious';
     toolbarActionsPosition: 'top' | 'bottom' | 'both';
+    toolbarAppearanceVariant: 'flat' | 'outlined' | 'elevated' | 'integrated';
+    toolbarAppearanceShape: 'square' | 'rounded' | 'pill';
+    toolbarAppearanceDivider: 'none' | 'start' | 'between-groups';
     toolbarHeight: number;
     toolbarActionsBackgroundColor: string;
     paginationEnabled: boolean;
@@ -3827,6 +3853,9 @@ declare class PraxisTableInlineAuthoringEditorComponent implements OnChanges {
     setToolbarVisible(value: boolean): void;
     setDensity(value: 'compact' | 'comfortable' | 'spacious'): void;
     setToolbarActionsPosition(value: 'top' | 'bottom' | 'both'): void;
+    setToolbarAppearanceVariant(value: 'flat' | 'outlined' | 'elevated' | 'integrated'): void;
+    setToolbarAppearanceShape(value: 'square' | 'rounded' | 'pill'): void;
+    setToolbarAppearanceDivider(value: 'none' | 'start' | 'between-groups'): void;
     setToolbarHeight(value: number | string): void;
     setToolbarActionsBackgroundColor(value: string): void;
     setPaginationEnabled(value: boolean): void;
@@ -3854,6 +3883,7 @@ declare class PraxisTableInlineAuthoringEditorComponent implements OnChanges {
     tx(key: string, fallback: string): string;
     private emitConfig;
     private patchToolbar;
+    private patchToolbarAppearance;
     private patchBehavior;
     private patchPagination;
     private patchSorting;
@@ -4441,5 +4471,5 @@ declare function coerceTableComponentEditPlan(value: unknown): TableComponentEdi
 declare function compileTableComponentEditPlans(plans: TableComponentEditPlan[], currentConfig: TableConfig): TableComponentEditPlanCompileResult;
 declare function compileTableComponentEditPlan(plan: TableComponentEditPlan, currentConfig: TableConfig): TableComponentEditPlanCompileResult;
 
-export { AnalyticsTableConfigAdapterService, AnalyticsTableContractService, AnalyticsTableStatsApiService, BOOLEAN_PRESETS, BehaviorConfigEditorComponent, CURRENCY_PRESETS, ColumnsConfigEditorComponent, DATE_PRESETS, DataFormatterComponent, DataFormattingService, FORMULA_TEMPLATES, FilterConfigService, FilterSettingsComponent, FormulaGeneratorService, JsonConfigEditorComponent, MessagesLocalizationEditorComponent, NUMBER_PRESETS, PERCENTAGE_PRESETS, PRAXIS_FILTER_COMPONENT_METADATA, PRAXIS_TABLE_AUTHORING_MANIFEST, PRAXIS_TABLE_COMPONENT_METADATA, PraxisFilter, PraxisFilterWidgetConfigEditor, PraxisTable, PraxisTableConfigEditor, PraxisTableInlineAuthoringEditorComponent, PraxisTableToolbar, PraxisTableWidgetConfigEditor, STRING_PRESETS, TABLE_AI_CAPABILITIES, TABLE_COMPONENT_AI_CAPABILITIES, TABLE_COMPONENT_EDIT_PLAN_ALLOWED_CHANGE_KINDS, TABLE_COMPONENT_EDIT_PLAN_BATCH_KIND, TABLE_COMPONENT_EDIT_PLAN_EXPECTED_PATHS, TABLE_COMPONENT_EDIT_PLAN_JSON_SCHEMA, TABLE_COMPONENT_EDIT_PLAN_KIND, TABLE_COMPONENT_EDIT_PLAN_VERSION, TASK_PRESETS, TableDefaultsProvider, TableRulesEditorComponent, ToolbarActionsEditorComponent, ValueMappingEditorComponent, VisualFormulaBuilderComponent, buildTableApplyPlan, coerceTableComponentEditPlan, coerceTableComponentEditPlans, compileTableComponentEditPlan, compileTableComponentEditPlans, createTableAuthoringDocument, getActionId, getEnum, getTableCapabilities, getTableComponentEditPlanCapabilities, isTableRendererSupportedByRichContentP0, mapTableRendererToRichContentP0, normalizeTableAuthoringDocument, parseLegacyOrTableDocument, providePraxisFilterMetadata, providePraxisTableMetadata, serializeTableAuthoringDocument, toCanonicalTableConfig, validateTableAuthoringDocument };
+export { AnalyticsTableConfigAdapterService, AnalyticsTableContractService, AnalyticsTableStatsApiService, BOOLEAN_PRESETS, BehaviorConfigEditorComponent, CURRENCY_PRESETS, ColumnsConfigEditorComponent, DATE_PRESETS, DataFormatterComponent, DataFormattingService, FORMULA_TEMPLATES, FilterConfigService, FilterSettingsComponent, FormulaGeneratorService, JsonConfigEditorComponent, MessagesLocalizationEditorComponent, NUMBER_PRESETS, PERCENTAGE_PRESETS, PRAXIS_FILTER_COMPONENT_METADATA, PRAXIS_TABLE_AUTHORING_MANIFEST, PRAXIS_TABLE_COMPONENT_METADATA, PRAXIS_TABLE_TOOLBAR_DEFAULT_APPEARANCE, PRAXIS_TABLE_TOOLBAR_TOKEN_PRESETS, PraxisFilter, PraxisFilterWidgetConfigEditor, PraxisTable, PraxisTableConfigEditor, PraxisTableInlineAuthoringEditorComponent, PraxisTableToolbar, PraxisTableWidgetConfigEditor, STRING_PRESETS, TABLE_AI_CAPABILITIES, TABLE_COMPONENT_AI_CAPABILITIES, TABLE_COMPONENT_EDIT_PLAN_ALLOWED_CHANGE_KINDS, TABLE_COMPONENT_EDIT_PLAN_BATCH_KIND, TABLE_COMPONENT_EDIT_PLAN_EXPECTED_PATHS, TABLE_COMPONENT_EDIT_PLAN_JSON_SCHEMA, TABLE_COMPONENT_EDIT_PLAN_KIND, TABLE_COMPONENT_EDIT_PLAN_VERSION, TASK_PRESETS, TableDefaultsProvider, TableRulesEditorComponent, ToolbarActionsEditorComponent, ValueMappingEditorComponent, VisualFormulaBuilderComponent, buildTableApplyPlan, coerceTableComponentEditPlan, coerceTableComponentEditPlans, compileTableComponentEditPlan, compileTableComponentEditPlans, createTableAuthoringDocument, getActionId, getEnum, getTableCapabilities, getTableComponentEditPlanCapabilities, isTableRendererSupportedByRichContentP0, mapTableRendererToRichContentP0, normalizeTableAuthoringDocument, parseLegacyOrTableDocument, providePraxisFilterMetadata, providePraxisTableMetadata, providePraxisTableToolbarAppearance, serializeTableAuthoringDocument, toCanonicalTableConfig, validateTableAuthoringDocument };
 export type { ActionLike, AnalyticsTableConfigAdapterOptions, AnalyticsTableContractDefinition, AnalyticsTableContractLoadOptions, AnalyticsTableContractLoadResult, AnalyticsTableContractSource, AnalyticsTableRow, AnalyticsTableViewModel, ArithmeticParams, BehaviorConfigChange, BooleanFormatterOptions, BulkAction, Capability$1 as Capability, CapabilityCatalog$1 as CapabilityCatalog, CapabilityCategory$1 as CapabilityCategory, ColumnChange, ColumnDataType$1 as ColumnDataType, ConcatenationParams, ConditionalMappingParams, CurrencyFormatterOptions, DataFormattingOptions, DataMode, DateFormatterOptions, DefaultValueParams, EditorDiagnostic, EditorDocument, FieldSchema, FilterConfig, FilterTag, FormatPreset, FormatterConfig, FormulaDefinition, FormulaParameterSchema, FormulaParams, FormulaTemplate, FormulaType, I18n, JsonEditorEvent, JsonValidationResult, MessagesLocalizationChange, NestedPropertyParams, NumberFormatterOptions, PercentageFormatterOptions, PraxisFilterWidgetEditorInputs, PraxisFilterWidgetEditorValue, PraxisTableWidgetEditorInputs, PraxisTableWidgetEditorValue, ResourcePathIntent, RowAction, RowExpansionChangeBase, RowExpansionChangeEvent, RowExpansionReasonCode, RowExpansionTrigger, StringFormatterOptions, TableAiContext, TableAiNavigationContextPack, TableAiNavigationDestinationContext, TableApplyPlan, TableAuthoringDocument, TableBindings, Capability as TableComponentCapability, CapabilityCatalog as TableComponentCapabilityCatalog, CapabilityCategory as TableComponentCapabilityCategory, TableComponentEditChangeKind, TableComponentEditPlan, TableComponentEditPlanCompileResult, ValueKind as TableComponentValueKind, TableHorizontalScroll, TableProjectionContext, TableRichContentP0Node, TableRuntimeContext, TableValidationContext, ToolbarAction, ToolbarActionsChange, ValueKind$1 as ValueKind, ValueMappingPair };