@praxisui/table 9.0.0-beta.2 → 9.0.0-beta.20

package/fesm2022/{praxisui-table-table-agentic-authoring-turn-flow-DL9l0XF7.mjs → praxisui-table-table-agentic-authoring-turn-flow-By_m3-Sf.mjs}

@@ -2403,6 +2403,7 @@ class TableAgenticAuthoringTurnFlow {
                     ? []
                     : this.toQuickReplies(response, request),
                 canApply: false,
+                diagnostics: response.warnings?.length ? { warnings: response.warnings } : undefined,
             };
         }
         if (response.type === 'error') {
@@ -2466,6 +2467,11 @@ class TableAgenticAuthoringTurnFlow {
         return this.normalizeLabel(response.code ?? '') === 'turn in progress';
     }
     compileAdapterResponse(response, request) {
+        response = this.normalizeConsultativeSourcePlaceholderResponse(response, request);
+        const consultativePresentationOptions = this.consultativePresentationOptionsBoundary(response, request);
+        if (consultativePresentationOptions) {
+            return consultativePresentationOptions;
+        }
         response = this.normalizeCategoricalRendererPalette(response, request);
         const incompatibleBooleanStatusPresentation = this.incompatibleBooleanStatusPresentationBoundary(response, request);
         if (incompatibleBooleanStatusPresentation) {
@@ -2764,6 +2770,43 @@ class TableAgenticAuthoringTurnFlow {
             return openOnlySurfaceRuntimeOperation;
         return this.normalizeGovernedCategoricalSelectionExecutableResponse(compiledResponse, request);
     }
+    consultativePresentationOptionsBoundary(response, request) {
+        if (!request)
+            return null;
+        if (this.requestIsCanonicalRendererSelection(request))
+            return null;
+        if (this.requestHasGovernedCategoricalSelection(request))
+            return null;
+        if (this.responseCarriesClarificationChoices(response))
+            return null;
+        if ((response.options ?? []).length || (response.optionPayloads ?? []).length)
+            return null;
+        const normalizedCurrentPrompt = this.normalizeLabel(request.prompt ?? '');
+        const normalizedConversationPrompt = this.normalizeLabel(this.componentPresentationPromptForTurn(request));
+        if (!this.promptRequestsPresentationOptions(normalizedConversationPrompt))
+            return null;
+        if (this.promptRequestsExplicitMaterialization(normalizedCurrentPrompt)
+            || this.promptRequestsExplicitMaterialization(normalizedConversationPrompt)) {
+            return null;
+        }
+        const hasExecutableEnvelope = this.responseMayContainExecutableEnvelope(response)
+            || this.componentEditOperations(response.componentEditPlan).length > 0
+            || !!this.toRecord(response.patch);
+        if (!hasExecutableEnvelope && response.type !== 'info' && response.type !== 'clarification') {
+            return null;
+        }
+        return {
+            ...response,
+            type: response.type === 'clarification' ? 'clarification' : 'info',
+            componentEditPlan: undefined,
+            patch: undefined,
+            warnings: [
+                ...(response.warnings ?? []),
+                'consultative-presentation-options-kept-non-executable',
+                'A residual continuity guard preserved a follow-up question about table presentation/formatting options as consultative because no explicit apply/change request was present; semantic intent still comes from the LLM-authored turn context.',
+            ],
+        };
+    }
     visualPresentationChoiceClarificationBoundary(response, request) {
         const carriesVisualPayload = (response.optionPayloads ?? [])
             .some((payload) => this.isVisualPresentationClarificationPayload(payload));
@@ -2848,6 +2891,32 @@ class TableAgenticAuthoringTurnFlow {
             'visual',
         ].some((token) => this.normalizedTextContainsApproxPhrase(normalized, token));
     }
+    promptRequestsExplicitMaterialization(normalizedPrompt) {
+        if (!normalizedPrompt)
+            return false;
+        return [
+            'aplica',
+            'aplicar',
+            'aplique',
+            'altera',
+            'alterar',
+            'altere',
+            'configura',
+            'configurar',
+            'configure',
+            'cria',
+            'criar',
+            'crie',
+            'muda',
+            'mudar',
+            'mude',
+            'mostra como',
+            'mostre como',
+            'transforma',
+            'transformar',
+            'transforme',
+        ].some((token) => this.normalizedTextContainsApproxPhrase(normalizedPrompt, token));
+    }
     normalizeCategoricalRendererPalette(response, request) {
         const plan = this.toRecord(response.componentEditPlan);
         const operations = this.componentEditOperations(plan);
@@ -9539,6 +9608,7 @@ class TableAgenticAuthoringTurnFlow {
     }
     withCapabilitySystemMessages(messages, contextHints, prompt = '') {
         const policies = [
+            this.buildConsultativeContextSystemPolicy(contextHints),
             this.buildRecommendedCapabilitiesSystemPolicy(contextHints),
             this.buildSelectedRecordsAnalysisSystemPolicy(contextHints),
             this.buildComponentPresentationAuthoringSystemPolicy(contextHints, prompt),
@@ -9548,6 +9618,152 @@ class TableAgenticAuthoringTurnFlow {
         ].filter((message) => !!message);
         return policies.length ? [...policies, ...messages] : messages;
     }
+    buildConsultativeContextSystemPolicy(contextHints) {
+        const facts = this.tableConsultativeContextFacts(contextHints);
+        if (!facts.length)
+            return null;
+        return {
+            role: 'system',
+            content: [
+                'Praxis table consultative context policy:',
+                '- The facts below are governed runtime/context evidence for read-only questions about the current table.',
+                '- When answering consultative questions, use the concrete fact value. Never answer with placeholders such as "fonte confirmada" or "source confirmed" when a value is declared.',
+                '- Do not emit visual presentation options, componentEditPlan, tableRuntimeOperations, or quick replies for a purely factual answer unless the user explicitly asks to change, apply, format, filter, open, or export something.',
+                '- Endpoint paths and resourcePath values are technical details: include them only when the user asks for the data source, origin, endpoint, resource, URL, path, or resourcePath.',
+                'Declared consultative facts:',
+                ...facts,
+            ].join('\n'),
+        };
+    }
+    tableConsultativeContextFacts(contextHints) {
+        const facts = [];
+        const resourcePath = this.extractResourcePath(contextHints)
+            ?? this.extractResourcePath(this.optionalJsonObject(this.adapter.getRuntimeState?.()))
+            ?? this.extractResourcePath(this.optionalJsonObject(this.adapter.getAuthoringContext?.()));
+        if (resourcePath) {
+            facts.push(`- resourcePath: ${resourcePath}`);
+        }
+        const dataProfile = this.optionalJsonObject(this.adapter.getDataProfile?.());
+        const rowCount = this.numberValue(dataProfile?.['rowCount'] ?? dataProfile?.['totalRows'] ?? dataProfile?.['totalElements']);
+        if (rowCount != null) {
+            facts.push(`- dataProfile.rowCount: ${rowCount}`);
+        }
+        const runtimeState = this.optionalJsonObject(this.adapter.getRuntimeState?.());
+        const pageSize = this.numberValue(runtimeState?.['pageSize']);
+        const pageIndex = this.numberValue(runtimeState?.['pageIndex'] ?? runtimeState?.['page']);
+        if (pageSize != null) {
+            facts.push(`- runtimeState.pageSize: ${pageSize}`);
+        }
+        if (pageIndex != null) {
+            facts.push(`- runtimeState.pageIndex: ${pageIndex}`);
+        }
+        const consultativeKinds = this.tableConsultativeQuestionKinds(contextHints);
+        if (consultativeKinds.length) {
+            facts.push(`- consultativeContext.answerableQuestionKinds: ${consultativeKinds.join(', ')}`);
+        }
+        const columnFacts = this.tableConsultativeColumnFacts();
+        if (columnFacts.length) {
+            facts.push('- declaredColumns:');
+            facts.push(...columnFacts);
+        }
+        return facts;
+    }
+    tableConsultativeQuestionKinds(contextHints) {
+        const consultativeContext = this.toRecord(this.toRecord(contextHints?.['authoringContract'])?.['consultativeContext']);
+        const kinds = consultativeContext?.['answerableQuestionKinds'];
+        if (!Array.isArray(kinds))
+            return [];
+        const unique = new Set();
+        kinds
+            .map((kind) => this.stringValue(kind).trim())
+            .filter((kind) => !!kind)
+            .forEach((kind) => unique.add(kind));
+        return [...unique].slice(0, 24);
+    }
+    tableConsultativeColumnFacts() {
+        const currentConfig = this.toRecord(this.adapter.getCurrentConfig?.());
+        const columns = Array.isArray(currentConfig?.['columns'])
+            ? currentConfig['columns']
+            : [];
+        const schemaFieldByName = new Map();
+        for (const schemaField of this.adapter.getSchemaFields?.() ?? []) {
+            const record = this.toRecord(schemaField);
+            if (!record)
+                continue;
+            const name = this.stringValue(record['name']) || this.stringValue(record['field']);
+            if (name)
+                schemaFieldByName.set(name, record);
+        }
+        return columns
+            .map((column) => this.toRecord(column))
+            .filter((column) => !!column)
+            .map((column) => {
+            const field = this.stringValue(column['field']).trim();
+            if (!field)
+                return null;
+            const schemaField = schemaFieldByName.get(field);
+            const label = this.stringValue(column['header'])
+                || this.stringValue(column['label'])
+                || this.stringValue(column['title'])
+                || this.stringValue(schemaField?.['label'])
+                || this.stringValue(schemaField?.['title'])
+                || field;
+            const schemaFormat = this.stringValue(schemaField?.['format']);
+            const type = this.tableConsultativeColumnType(column, schemaField, schemaFormat);
+            const format = this.stringValue(column['format']) || schemaFormat;
+            const renderer = this.stringValue(this.toRecord(column['renderer'])?.['type']);
+            return [
+                `  - ${field}`,
+                `label=${label}`,
+                `type=${type}`,
+                ...(format ? [`format=${format}`] : []),
+                ...(renderer ? [`renderer=${renderer}`] : []),
+            ].join('; ');
+        })
+            .filter((fact) => !!fact)
+            .slice(0, 40);
+    }
+    tableConsultativeColumnType(column, schemaField, schemaFormat) {
+        const columnType = this.stringValue(column['type']) || this.stringValue(column['dataType']);
+        const schemaType = this.stringValue(schemaField?.['type']) || this.stringValue(schemaField?.['dataType']);
+        if (schemaFormat === 'date' || schemaFormat === 'date-time')
+            return schemaFormat;
+        return columnType || schemaType || 'unknown';
+    }
+    normalizeConsultativeSourcePlaceholderResponse(response, request) {
+        if (response.type && response.type !== 'info')
+            return response;
+        if (response.patch && Object.keys(response.patch).length > 0)
+            return response;
+        const message = this.stringValue(response.message || response.explanation);
+        if (!this.isConfirmedSourcePlaceholderMessage(message))
+            return response;
+        const resourcePath = this.extractResourcePath(this.contextHintsForTurn)
+            ?? this.extractResourcePath(this.optionalJsonObject(request?.runtimeState))
+            ?? this.extractResourcePath(this.optionalJsonObject(this.adapter.getRuntimeState?.()))
+            ?? this.extractResourcePath(this.optionalJsonObject(this.adapter.getAuthoringContext?.()));
+        if (!resourcePath)
+            return response;
+        return {
+            ...response,
+            type: 'info',
+            message: `O resourcePath usado por esta tabela é \`${resourcePath}\`.`,
+            explanation: undefined,
+            optionPayloads: undefined,
+            options: undefined,
+            warnings: [
+                ...(response.warnings ?? []),
+                'consultative-source-placeholder-normalized',
+                'Resposta informativa normalizada a partir de authoringContract.consultativeContext.resourcePath; nao houve roteamento primario de intencao por palavras-chave.',
+            ],
+        };
+    }
+    isConfirmedSourcePlaceholderMessage(message) {
+        const normalized = this.normalizeLabel(message);
+        return !!normalized
+            && (normalized.includes('fonte confirmada') || normalized.includes('source confirmed'))
+            && (normalized.includes('fonte') || normalized.includes('source') || normalized.includes('resource'));
+    }
     buildSelectedRecordsAnalysisSystemPolicy(contextHints) {
         const selectedRecordsContext = this.selectedRecordsContextRecord(contextHints);
         if (!selectedRecordsContext)
@@ -9632,6 +9848,8 @@ class TableAgenticAuthoringTurnFlow {
     }
     buildComponentPresentationAuthoringSystemPolicy(contextHints, prompt) {
         const normalizedPrompt = this.normalizeLabel(prompt);
+        if (this.promptRequestsPresentationOptions(normalizedPrompt))
+            return null;
         const presentationIntent = this.promptRequestsVisualOrStructuralEdit(normalizedPrompt)
             || this.promptRequestsCompoundColumnPresentationEdit(normalizedPrompt);
         if (!presentationIntent)

package/fesm2022/{praxisui-table-table-ai.adapter-BvaMq2CS.mjs → praxisui-table-table-ai.adapter-CpxtKoLM.mjs}

@@ -1,7 +1,7 @@
 import { firstValueFrom } from 'rxjs';
 import { BaseAiAdapter, sanitizePraxisAssistantText, createComponentAuthoringContext } from '@praxisui/ai';
 import { PRAXIS_GLOBAL_ACTION_CATALOG, deepMerge } from '@praxisui/core';
-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-CunEk0vb.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--Mn44a7Y.mjs';
 
 const TABLE_COMPONENT_CONTEXT_PACK = {
     version: 'v1',
@@ -2204,6 +2204,9 @@ class TableAiAdapter extends BaseAiAdapter {
                     'bulk-actions',
                     'selection-derived-export-scope',
                     'styling-capabilities',
+                    'column-format-options',
+                    'column-presentation-options',
+                    'boolean-status-presentation-options',
                     'conditional-renderers',
                     'conditional-styles',
                     'conditional-animations',

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 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-CunEk0vb.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--Mn44a7Y.mjs';

package/package.json

@@ -1,23 +1,23 @@
 {
   "name": "@praxisui/table",
-  "version": "9.0.0-beta.2",
+  "version": "9.0.0-beta.20",
   "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": "^9.0.0-beta.2",
-    "@praxisui/core": "^9.0.0-beta.2",
-    "@praxisui/dynamic-fields": "^9.0.0-beta.2",
-    "@praxisui/dynamic-form": "^9.0.0-beta.2",
-    "@praxisui/metadata-editor": "^9.0.0-beta.2",
-    "@praxisui/rich-content": "^9.0.0-beta.2",
-    "@praxisui/settings-panel": "^9.0.0-beta.2",
-    "@praxisui/table-rule-builder": "^9.0.0-beta.2",
+    "@praxisui/ai": "^9.0.0-beta.20",
+    "@praxisui/core": "^9.0.0-beta.20",
+    "@praxisui/dynamic-fields": "^9.0.0-beta.20",
+    "@praxisui/dynamic-form": "^9.0.0-beta.20",
+    "@praxisui/metadata-editor": "^9.0.0-beta.20",
+    "@praxisui/rich-content": "^9.0.0-beta.20",
+    "@praxisui/settings-panel": "^9.0.0-beta.20",
+    "@praxisui/table-rule-builder": "^9.0.0-beta.20",
     "@angular/cdk": "^21.0.0",
     "@angular/forms": "^21.0.0",
     "@angular/material": "^21.0.0",
     "@angular/router": "^21.0.0",
-    "@praxisui/dialog": "^9.0.0-beta.2",
+    "@praxisui/dialog": "^9.0.0-beta.20",
     "rxjs": "~7.8.0"
   },
   "dependencies": {
@@ -27,17 +27,11 @@
   "publishConfig": {
     "access": "public"
   },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/codexrodrigues/praxis-ui-angular.git"
-  },
-  "homepage": "https://praxisui.dev",
-  "bugs": {
-    "url": "https://github.com/codexrodrigues/praxis-ui-angular/issues"
-  },
+  "homepage": "https://praxisui.dev/components/table",
   "keywords": [
     "angular",
     "praxisui",
+    "praxis",
     "table",
     "data-grid",
     "filtering",
@@ -58,7 +52,10 @@
     "./filter-drawer-adapter": {
       "types": "./types/praxisui-table-filter-drawer-adapter.d.ts",
       "default": "./fesm2022/praxisui-table-filter-drawer-adapter.mjs"
+    },
+    "./ai/component-registry.json": {
+      "default": "./ai/component-registry.json"
     }
   },
   "type": "module"
-}
+}

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

@@ -37,9 +37,9 @@ source_of_truth:
   - "projects/praxis-core/src/lib/tokens/global-action.catalog.ts"
   - "projects/praxis-core/src/lib/models/global-action.model.ts"
   - "projects/praxis-core/src/lib/actions/global-action-ui.ts"
-source_of_truth_last_verified: "2026-03-05"
+source_of_truth_last_verified: "2026-06-24"
 publish_source_of_truth: false
-last_updated: "2026-03-05"
+last_updated: "2026-06-24"
 toc: true
 sidebar: true
 tags:
@@ -92,6 +92,13 @@ Este documento e a referencia canonica da API JSON de praxis-table.
 - Para exportar apenas a selecao, combine `behavior.selection.enabled`, `config.export.general.scope: "selected"` e uma bulk action visivel apenas quando `selectedCount > 0`.
 - Quando `config.export.general.scope` e `"selected"`, a exportacao sem linhas selecionadas e bloqueada com feedback de usuario em vez de gerar um arquivo vazio.
 
+## AI assistant entrypoint
+
+- `config.ai.assistant.enabled` controla a visibilidade e o acionamento do assistente de IA embarcado na tabela.
+- Ausencia do campo equivale ao comportamento historico: o entrypoint continua disponivel quando o adapter de IA da tabela estiver carregado.
+- Use `false` para surfaces em que o host precisa remover a acao de IA por contrato publico, sem CSS contra classes internas da tabela ou do Angular Material.
+- Ao mudar para `false`, a tabela fecha o assistente e remove a sessao contextual da tabela no registry compartilhado de IA.
+
 ## Columns visibility dropdown
 
 - `config.toolbar.columnsVisibility.enabled` controla a exibição do botão de visibilidade de colunas na barra de ferramentas.
@@ -331,6 +338,9 @@ Este arquivo foi adaptado para o padrao canonico atual sem remover conteudo tecn
 | `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. |
 
+Renderer defaults:
+- `columns[].renderer.type = "avatar"` aplica `columns[].align = "center"` quando a coluna não declara alinhamento explícito. Esse default governa header e célula para manter foto/avatar centralizados em colunas dedicadas, preservando `align`, `width` e demais overrides declarados pelo host.
+
 ### Toolbar contract
 
 - Acoes globais de toolbar, row e bulk usam `effects[].kind = "global-action"` como envelope canonico de novo authoring.
@@ -365,7 +375,7 @@ Este arquivo foi adaptado para o padrao canonico atual sem remover conteudo tecn
 | `icon` | `string` | No | component-input | host-surface passthrough | Ícone opcional usado em affordances auxiliares do runtime. |
 | `autoDelete` | `boolean` | No | component-input | boolean coercion | Ativa deleção automática quando o host delega esse fluxo ao runtime. |
 | `enableCustomization` | `boolean` | No | component-input | boolean coercion | Controla entrada em editor/configuração; default canônico `false`. |
-| `dense` | `boolean` | No | component-input | boolean coercion | Força modo compacto quando o host precisa sobrepor densidade do contrato. |
+| `dense` | `boolean` | No | component-input | boolean coercion | Entrada legada de compactação. Equivale a `appearance.density="compact"` apenas quando o contrato não informa `appearance.density`. |
 | `notifyIfOutdated` | `'inline' \| 'snackbar' \| 'both' \| 'none'` | No | component-input | enum validation + prefs fallback | Política de aviso de drift de schema; o host escolhe banner inline, snackbar, ambos ou silêncio explícito. |
 | `snoozeMs` | `number` | No | component-input | numeric fallback + prefs fallback | Janela de snooze para avisos de drift; default do input é `86400000` (24h) e políticas globais podem complementar. |
 | `autoOpenSettingsOnOutdated` | `boolean` | No | component-input | schema-prefs resolution | Abre automaticamente o settings panel quando drift de schema é detectado. |
@@ -944,7 +954,10 @@ row selection through table affordances.
 | `--p-table-row-even-bg` | zebra row |
 | `--p-table-row-hover-bg` | hover row |
 | `--p-table-row-selected-bg` | row selecionada |
+| `--p-table-row-height` | altura da linha; sobrescreve o default do preset de densidade |
+| `--p-table-header-height` | altura do header; sobrescreve o default do preset de densidade |
 | `--p-header-padding` | padding do header |
+| `--p-cell-padding` | padding das células; sobrescreve o default do preset de densidade |
 | `--p-header-font-size` | fonte do header |
 | `--p-header-font-weight` | peso do header |
 | `--p-header-letter-spacing` | tracking do header |
@@ -966,6 +979,13 @@ row selection through table affordances.
 | `--p-table-drag-status-enter-duration` | duracao da entrada da mensagem visual de reorder |
 | `--p-actions-btn-size` | tamanho de botoes de acao |
 | `--p-actions-icon-size` | tamanho de icones de acao |
+| `--p-table-paginator-container-min-height` | altura minima do paginator |
+| `--p-table-paginator-container-padding` | padding do paginator |
+| `--p-table-paginator-container-gap` | espaçamento entre controles do paginator |
+| `--p-table-paginator-action-size` | tamanho dos botoes de navegacao do paginator |
+| `--p-table-paginator-select-width` | largura do seletor de tamanho de pagina |
+| `--p-table-paginator-select-height` | altura do seletor de tamanho de pagina |
+| `--p-table-paginator-select-padding-inline` | padding horizontal do seletor de tamanho de pagina |
 | `--p-table-state-success-*` | tokens de estado success |
 | `--p-table-state-warning-*` | tokens de estado warning |
 | `--p-table-state-danger-*` | tokens de estado danger |
@@ -982,6 +1002,8 @@ row selection through table affordances.
 | `pfx-column-drag-enabled` | habilita layout base de DnD de colunas |
 | `pfx-column-drag-indicator` | habilita indicador visual de drag |
 
+`appearance.density` seleciona apenas o preset de defaults. `appearance.spacing.*` e defaults globais também alimentam tokens `*-default`. Hosts podem redefinir livremente os tokens finais sem depender de seletores internos, por exemplo `--p-table-row-height`, `--p-table-header-height`, `--p-cell-padding`, `--p-actions-btn-size` e `--p-table-paginator-select-height`. Em virtualização sem `itemHeight` explícito, o runtime deriva a altura da densidade efetiva.
+
 #### DnD classes (globais)
 | Classe CSS | Escopo | Efeito |
 | --- | --- | --- |

package/types/praxisui-table.d.ts

@@ -1,5 +1,5 @@
 import * as _praxisui_core from '@praxisui/core';
-import { TableToolbarAppearanceConfig, TableConfig, LoggerService, PraxisI18nService, TableToolbarAppearanceVariant, TableToolbarAppearanceDensity, TableToolbarAppearanceShape, TableToolbarAppearanceDivider, TableToolbarTokenName, GlobalConfigService, AsyncConfigStorage, ApiUrlEntry, FieldMetadata, SchemaIdParams, FormConfig, GenericCrudService, DynamicFormService, SchemaNormalizerService, ComponentKeyService, ComponentDocMeta, PraxisTextValue, PraxisAnalyticsProjection, PraxisDataQueryContext, ApiUrlConfig, PraxisQueryFilterExpression, RecordRelatedSurfaceContextPack, LoadingState, RestApiLinks, ColumnDefinition, RichBlockNode, ResourceCapabilityDigest, ConnectionStorage, LoadingOrchestrator, GlobalActionService, PraxisLoadingRenderer, PraxisRuntimeComponentObservationEnvelope, 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, LocalStorageConfigService, ApiUrlEntry, FieldMetadata, SchemaIdParams, FormConfig, GenericCrudService, DynamicFormService, SchemaNormalizerService, ComponentKeyService, ComponentDocMeta, PraxisTextValue, PraxisAnalyticsProjection, PraxisDataQueryContext, ApiUrlConfig, PraxisQueryFilterExpression, RecordRelatedSurfaceContextPack, LoadingState, RestApiLinks, ColumnDefinition, RichBlockNode, ResourceCapabilityDigest, ConnectionStorage, LoadingOrchestrator, GlobalActionService, PraxisLoadingRenderer, PraxisRuntimeComponentObservationEnvelope, 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 { InjectionToken, OnDestroy, EventEmitter, ElementRef, Provider, OnInit, OnChanges, AfterViewInit, DoCheck, DestroyRef, ChangeDetectorRef, NgZone, SimpleChanges, ComponentRef, AfterContentInit, Injector } from '@angular/core';
 import { ActivatedRoute } from '@angular/router';
@@ -95,6 +95,7 @@ declare class PraxisTableToolbar implements OnDestroy {
     getMoreActionsLabel(): string;
     emitExportAction(event: Event, format: string): void;
     getColumnsVisibilityLabel(): string;
+    getColumnsVisibilityIcon(): string;
     isColumnsVisibilityEnabled(): boolean;
     getVisibleColumnsCount(): number;
     isColumnVisibilityToggleDisabled(column: {
@@ -359,8 +360,9 @@ type FilterConfig = {
 };
 declare class FilterConfigService {
     private storage;
+    private localStorage;
     private readonly PREFIX;
-    constructor(storage: AsyncConfigStorage);
+    constructor(storage: AsyncConfigStorage, localStorage: LocalStorageConfigService);
     /**
      * Load a persisted filter configuration for the given key.
      */
@@ -369,6 +371,11 @@ declare class FilterConfigService {
      * Persist a filter configuration for the given key.
      */
     save(key: string, config: FilterConfig): void;
+    /**
+     * Clear the persisted filter configuration from both remote storage and the
+     * local fallback cache so reset/reopen cannot revive stale preferences.
+     */
+    clear(key: string): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<FilterConfigService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<FilterConfigService>;
 }
@@ -651,6 +658,7 @@ declare class PraxisFilter implements OnInit, OnChanges, AfterViewInit, OnDestro
     private resolveInitialDto;
     private syncFormsFromDto;
     private refreshProgrammaticFilterFieldDisplays;
+    private getProgrammaticRefreshFieldNames;
     private refreshProgrammaticFilterFieldDisplay;
     ngOnInit(): Promise<void>;
     ngAfterViewInit(): void;
@@ -1251,6 +1259,9 @@ declare class PraxisTable implements OnInit, OnChanges, AfterViewInit, AfterCont
     set resolvedPrefs(val: any);
     get resolvedPrefs(): any;
     dense: boolean;
+    private hostDeclaredAppearanceDensity;
+    private hostDeclaredAppearanceSpacing;
+    private hostDeclaredAppearanceTypography;
     private resolveAppearanceDensity;
     get hostDensityCompactClass(): boolean;
     get hostDensityComfortableClass(): boolean;
@@ -1339,6 +1350,9 @@ declare class PraxisTable implements OnInit, OnChanges, AfterViewInit, AfterCont
     private tableConfigKey;
     private filterConfigKey;
     private ensureConfigDefaults;
+    private hasDeclaredAppearanceDensity;
+    private hasDeclaredAppearanceSection;
+    private shouldApplyAppearanceDefaultValue;
     private mergePersistedTableConfigWithInput;
     private reconcileHostDeclaredTableContract;
     private reconcileHostDeclaredColumns;
@@ -1361,6 +1375,8 @@ declare class PraxisTable implements OnInit, OnChanges, AfterViewInit, AfterCont
     aiAssistantTriggerBadge(): string;
     aiAssistantTriggerLabel(): string;
     aiAssistantTriggerTooltip(): string;
+    isAiAssistantEnabled(): boolean;
+    shouldShowAiAssistantEntrypoint(): boolean;
     openAiAssistantFromSession(session: PraxisAssistantSessionSnapshot): void;
     closeAiAssistant(): void;
     onAiAssistantPromptChange(prompt: string): void;
@@ -1404,6 +1420,7 @@ declare class PraxisTable implements OnInit, OnChanges, AfterViewInit, AfterCont
     private buildRuntimeObservationClaims;
     private isRuntimeObservationVisible;
     private syncAiAssistantSession;
+    private disableAiAssistantSession;
     private assistantContextRuntimeLocale;
     private refreshAiAssistantContextAfterSelectionChange;
     private hasAiAssistantSessionState;
@@ -1718,6 +1735,7 @@ declare class PraxisTable implements OnInit, OnChanges, AfterViewInit, AfterCont
     private resolveSortingStrategy;
     private applyDataSourceSettings;
     private sanitizeColumns;
+    private applyRendererPresentationDefaults;
     private setupColumns;
     private preserveSchemaDrivenColumnsIfConfigOmittedColumns;
     private isDataColumnField;
@@ -1781,10 +1799,6 @@ declare class PraxisTable implements OnInit, OnChanges, AfterViewInit, AfterCont
      * Runs only on initial bootstrap (when columns are derived from schema).
      */
     private applyAutoRenderer;
-    /**
-     * Check if a value is a valid ColumnDataType
-     */
-    private isValidColumnDataType;
     /**
      * Infer column data type from field name patterns when API type is not available
      * Refined logic to reduce false positives
@@ -2161,6 +2175,7 @@ declare class PraxisTable implements OnInit, OnChanges, AfterViewInit, AfterCont
     private getVirtualizationSources;
     isVirtualized(): boolean;
     getVirtItemHeight(): number;
+    private getDefaultDensityRowHeight;
     getVirtBufferSize(): number;
     getVirtMinHeightStyle(): string;
     getVirtMinHeightHostStyle(): string | null;
@@ -3108,6 +3123,7 @@ declare class FilterSettingsComponent implements OnChanges, AfterViewInit, OnDes
     private scrollTrackingRafId;
     readonly layoutPreviewFields: string[];
     private readonly storage;
+    private readonly filterConfigService;
     private readonly settingsPanel;
     private readonly snackBar;
     private readonly destroyRef;