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

package/fesm2022/{praxisui-table-table-agentic-authoring-turn-flow-BzjYuDvo.mjs → praxisui-table-table-agentic-authoring-turn-flow-sQz0BpSY.mjs}

@@ -1,6 +1,6 @@
 import { Observable, firstValueFrom } from 'rxjs';
 import { withAuthoringScopePolicy } from '@praxisui/ai';
-import { af as setTableActionGlobalActionRef } from './praxisui-table-praxisui-table-DKvwb6v1.mjs';
+import { ax as setTableActionGlobalActionRef } from './praxisui-table-praxisui-table-CdEy3SYM.mjs';
 
 class TableAgenticAuthoringTurnFlow {
     adapter;

package/fesm2022/{praxisui-table-table-ai.adapter-CPgpIGoi.mjs → praxisui-table-table-ai.adapter-DEetBMv9.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 { L as TABLE_COMPONENT_EDIT_PLAN_OPERATION_IDS, n as PRAXIS_TABLE_AUTHORING_MANIFEST, T as TABLE_AI_CAPABILITIES, $ as coerceTableComponentEditPlans, a1 as compileTableComponentEditPlans, Q as TASK_PRESETS, a6 as getTableComponentEditPlanCapabilities, H as TABLE_COMPONENT_EDIT_PLAN_EXPECTED_PATHS, E as TABLE_COMPONENT_EDIT_PLAN_ALLOWED_CHANGE_KINDS, I as TABLE_COMPONENT_EDIT_PLAN_JSON_SCHEMA, O as TABLE_COMPONENT_EDIT_PLAN_VERSION, G as TABLE_COMPONENT_EDIT_PLAN_BATCH_KIND, K as TABLE_COMPONENT_EDIT_PLAN_KIND } from './praxisui-table-praxisui-table-DKvwb6v1.mjs';
+import { W as TABLE_COMPONENT_EDIT_PLAN_OPERATION_IDS, p as PRAXIS_TABLE_AUTHORING_MANIFEST, T as TABLE_AI_CAPABILITIES, a7 as coerceTableComponentEditPlans, a9 as compileTableComponentEditPlans, Z as TASK_PRESETS, ah as getTableComponentEditPlanCapabilities, R as TABLE_COMPONENT_EDIT_PLAN_EXPECTED_PATHS, O as TABLE_COMPONENT_EDIT_PLAN_ALLOWED_CHANGE_KINDS, U as TABLE_COMPONENT_EDIT_PLAN_JSON_SCHEMA, X as TABLE_COMPONENT_EDIT_PLAN_VERSION, Q as TABLE_COMPONENT_EDIT_PLAN_BATCH_KIND, V as TABLE_COMPONENT_EDIT_PLAN_KIND } from './praxisui-table-praxisui-table-CdEy3SYM.mjs';
 
 const TABLE_ROW_EXPRESSION_CONTEXT_OPTION = {
     mode: 'expression',
@@ -1913,11 +1913,12 @@ class TableDataProfiler {
         if (first instanceof Date)
             return 'date';
         // Check string formats
-        const str = String(first);
-        if (!isNaN(Number(str)) && str.trim() !== '')
+        const str = String(first).trim();
+        if (!isNaN(Number(str)) && str !== '')
             return 'number';
-        if (!isNaN(Date.parse(str)) && str.length > 5)
-            return 'date'; // length check avoids short strings being parsed as dates
+        if (!/^v?\d+\.\d+\.\d+(?:[-+][0-9A-Za-z.-]+)?$/.test(str) && !isNaN(Date.parse(str)) && str.length > 5) {
+            return 'date'; // length and semver checks avoid short/version strings being parsed as dates
+        }
         return 'string';
     }
     static sanitizeValue(val, type) {

package/fesm2022/praxisui-table.mjs

@@ -1 +1,2 @@
-export { A as ANALYTICS_TABLE_ROW_KEY_FIELD, a as AnalyticsTableConfigAdapterService, b as AnalyticsTableContractService, c as AnalyticsTableStatsApiService, B as BOOLEAN_PRESETS, d as BehaviorConfigEditorComponent, C as CURRENCY_PRESETS, e as ColumnsConfigEditorComponent, D as DATE_PRESETS, f as DataFormatterComponent, g as DataFormattingService, F as FORMULA_TEMPLATES, h as FilterConfigService, i as FilterSettingsComponent, j as FormulaGeneratorService, J as JsonConfigEditorComponent, M as MessagesLocalizationEditorComponent, N as NUMBER_PRESETS, P as PERCENTAGE_PRESETS, k as PRAXIS_FILTER_AUTHORING_MANIFEST, l as PRAXIS_FILTER_COMPONENT_METADATA, m as PRAXIS_FILTER_VIEW_CONTEXT_SCHEMA_VERSION, n as PRAXIS_TABLE_AUTHORING_MANIFEST, o as PRAXIS_TABLE_COMPONENT_METADATA, p as PRAXIS_TABLE_TOOLBAR_APPEARANCE_PRESETS, q as PRAXIS_TABLE_TOOLBAR_DEFAULT_APPEARANCE, r as PRAXIS_TABLE_TOOLBAR_TOKEN_PRESETS, s as PraxisFilter, t as PraxisFilterWidgetConfigEditor, u as PraxisTable, v as PraxisTableConfigEditor, w as PraxisTableInlineAuthoringEditorComponent, x as PraxisTableToolbar, y as PraxisTableWidgetConfigEditor, S as STRING_PRESETS, T as TABLE_AI_CAPABILITIES, z as TABLE_COMPONENT_AI_CAPABILITIES, E as TABLE_COMPONENT_EDIT_PLAN_ALLOWED_CHANGE_KINDS, G as TABLE_COMPONENT_EDIT_PLAN_BATCH_KIND, H as TABLE_COMPONENT_EDIT_PLAN_EXPECTED_PATHS, I as TABLE_COMPONENT_EDIT_PLAN_JSON_SCHEMA, K as TABLE_COMPONENT_EDIT_PLAN_KIND, O as TABLE_COMPONENT_EDIT_PLAN_VERSION, Q as TASK_PRESETS, R as TableDefaultsProvider, U as TableRulesEditorComponent, V as ToolbarActionsEditorComponent, W as ValueMappingEditorComponent, X as VisualFormulaBuilderComponent, Y as analyticsComparisonMetricField, Z as buildTableApplyPlan, _ as coerceTableComponentEditPlan, $ as coerceTableComponentEditPlans, a0 as compileTableComponentEditPlan, a1 as compileTableComponentEditPlans, a2 as createTableAuthoringDocument, a3 as getActionId, a4 as getEnum, a5 as getTableCapabilities, a6 as getTableComponentEditPlanCapabilities, a7 as isTableRendererSupportedByRichContentP0, a8 as mapTableRendererToRichContentP0, a9 as normalizeTableAuthoringDocument, aa as parseLegacyOrTableDocument, ab as providePraxisFilterMetadata, ac as providePraxisTableMetadata, ad as providePraxisTableToolbarAppearance, ae as serializeTableAuthoringDocument, ag as toCanonicalTableConfig, ah as validateTableAuthoringDocument } from './praxisui-table-praxisui-table-DKvwb6v1.mjs';
+export { A as ANALYTICS_TABLE_ROW_KEY_FIELD, a as AnalyticalDrawerRegistryService, b as AnalyticsTableConfigAdapterService, c as AnalyticsTableContractService, d as AnalyticsTableStatsApiService, B as BOOLEAN_PRESETS, e as BehaviorConfigEditorComponent, C as CURRENCY_PRESETS, f as ColumnsConfigEditorComponent, D as DATE_PRESETS, g as DataFormatterComponent, h as DataFormattingService, F as FORMULA_TEMPLATES, i as FilterConfigService, j as FilterSettingsComponent, k as FormulaGeneratorService, J as JsonConfigEditorComponent, M as MessagesLocalizationEditorComponent, N as NUMBER_PRESETS, P as PERCENTAGE_PRESETS, l as PRAXIS_ANALYTICAL_DRAWER_SCHEMAS, m as PRAXIS_FILTER_AUTHORING_MANIFEST, n as PRAXIS_FILTER_COMPONENT_METADATA, o as PRAXIS_FILTER_VIEW_CONTEXT_SCHEMA_VERSION, p as PRAXIS_TABLE_AUTHORING_MANIFEST, q as PRAXIS_TABLE_COMPONENT_METADATA, r as PRAXIS_TABLE_TOOLBAR_APPEARANCE_PRESETS, s as PRAXIS_TABLE_TOOLBAR_DEFAULT_APPEARANCE, t as PRAXIS_TABLE_TOOLBAR_TOKEN_PRESETS, u as PraxisAnalyticalDrawerComponent, v as PraxisFilter, w as PraxisFilterOutletComponent, x as PraxisFilterOutletDirective, y as PraxisFilterWidgetConfigEditor, z as PraxisScopeBarComponent, E as PraxisTable, G as PraxisTableConfigEditor, H as PraxisTableInlineAuthoringEditorComponent, I as PraxisTableToolbar, K as PraxisTableWidgetConfigEditor, S as STRING_PRESETS, T as TABLE_AI_CAPABILITIES, L as TABLE_COMPONENT_AI_CAPABILITIES, O as TABLE_COMPONENT_EDIT_PLAN_ALLOWED_CHANGE_KINDS, Q as TABLE_COMPONENT_EDIT_PLAN_BATCH_KIND, R as TABLE_COMPONENT_EDIT_PLAN_EXPECTED_PATHS, U as TABLE_COMPONENT_EDIT_PLAN_JSON_SCHEMA, V as TABLE_COMPONENT_EDIT_PLAN_KIND, X as TABLE_COMPONENT_EDIT_PLAN_VERSION, Y as TABLE_GOVERNED_PAGE_PREVIEW_ADAPTER, Z as TASK_PRESETS, _ as TableDefaultsProvider, $ as TableRulesEditorComponent, a0 as ToolbarActionsEditorComponent, a1 as ValueMappingEditorComponent, a2 as VisualFormulaBuilderComponent, a3 as analyticsComparisonMetricField, a4 as applyComputedFieldsToRows, a5 as buildTableApplyPlan, a6 as coerceTableComponentEditPlan, a7 as coerceTableComponentEditPlans, a8 as compileTableComponentEditPlan, a9 as compileTableComponentEditPlans, aa as createTableAuthoringDocument, ab as decodeTablePageInputs, ac as encodeTablePageInputs, ad as formatComputedFieldValue, ae as getActionId, af as getEnum, ag as getTableCapabilities, ah as getTableComponentEditPlanCapabilities, ai as interpolateRelationEndpoint, aj as isAnalyticalDrawerSchema, ak as isTableRendererSupportedByRichContentP0, al as mapTableRendererToRichContentP0, am as materializeTablePageRuntimeInputs, an as normalizeComputedFieldDefinition, ao as normalizeTableAuthoringDocument, ap as parseLegacyOrTableDocument, ar as projectTablePageEditorChanges, as as providePraxisAnalyticalDrawerSchemas, at as providePraxisFilterMetadata, au as providePraxisTableMetadata, av as providePraxisTableToolbarAppearance, aw as serializeTableAuthoringDocument, ay as toCanonicalTableConfig, az as validateTableAuthoringDocument, aA as validateTablePageWidget } from './praxisui-table-praxisui-table-CdEy3SYM.mjs';
+export { createDynamicRecord, extractRecordId, isDynamicDataRecord, resolveDataField } from '@praxisui/core';

package/package.json

@@ -1,24 +1,24 @@
 {
   "name": "@praxisui/table",
-  "version": "10.0.0-rc.4",
+  "version": "10.0.0-rc.41",
   "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",
     "@angular/platform-browser": "^21.0.0",
-    "@praxisui/ai": "^10.0.0-rc.4",
-    "@praxisui/core": "^10.0.0-rc.4",
-    "@praxisui/dynamic-fields": "^10.0.0-rc.4",
-    "@praxisui/dynamic-form": "^10.0.0-rc.4",
-    "@praxisui/metadata-editor": "^10.0.0-rc.4",
-    "@praxisui/rich-content": "^10.0.0-rc.4",
-    "@praxisui/settings-panel": "^10.0.0-rc.4",
-    "@praxisui/table-rule-builder": "^10.0.0-rc.4",
+    "@praxisui/ai": "^10.0.0-rc.41",
+    "@praxisui/core": "^10.0.0-rc.41",
+    "@praxisui/dynamic-fields": "^10.0.0-rc.41",
+    "@praxisui/dynamic-form": "^10.0.0-rc.41",
+    "@praxisui/metadata-editor": "^10.0.0-rc.41",
+    "@praxisui/rich-content": "^10.0.0-rc.41",
+    "@praxisui/settings-panel": "^10.0.0-rc.41",
+    "@praxisui/table-rule-builder": "^10.0.0-rc.41",
     "@angular/cdk": "^21.0.0",
     "@angular/forms": "^21.0.0",
     "@angular/material": "^21.0.0",
     "@angular/router": "^21.0.0",
-    "@praxisui/dialog": "^10.0.0-rc.4",
+    "@praxisui/dialog": "^10.0.0-rc.41",
     "rxjs": "~7.8.0"
   },
   "dependencies": {
@@ -50,6 +50,10 @@
       "types": "./types/praxisui-table.d.ts",
       "default": "./fesm2022/praxisui-table.mjs"
     },
+    "./authoring": {
+      "types": "./types/praxisui-table-authoring.d.ts",
+      "default": "./fesm2022/praxisui-table-authoring.mjs"
+    },
     "./filter-drawer-adapter": {
       "types": "./types/praxisui-table-filter-drawer-adapter.d.ts",
       "default": "./fesm2022/praxisui-table-filter-drawer-adapter.mjs"

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

@@ -109,11 +109,16 @@ Este documento e a referencia canonica da API JSON de praxis-table.
 > [!WARNING]
 > **Segurança Corporativa em Cenários Corporativos**: A visibilidade de colunas via dropdown da toolbar é um recurso estritamente visual (layout de apresentação do lado do cliente). A ocultação de colunas **não** protege o dado sensível da transmissão de rede nem de inspeção técnica. Se determinados campos (ex: salários, senhas ou tokens) forem confidenciais para o nível de permissão do usuário atual, a restrição de dados deve ser realizada obrigatoriamente no lado do servidor (através da filtragem de propriedades nas APIs de CRUD e consulta), e nunca por meio de ocultação puramente visual na tabela.
 
-## Quick filters and density
-
-- `config.toolbar.filters.quickFilters[]` materializa um pequeno seletor de escopo na toolbar. Cada item declara `id`, `label`, `filter` e `icon` opcional. O runtime mantém no máximo um item ativo; acionar novamente o item atual restaura os critérios anteriores.
-- O filtro rápido é combinado com os critérios já ativos. Ao desativá-lo, a tabela restaura os critérios anteriores sem perder o contexto do operador.
-- Aplicar ou limpar o formulário de filtros avançados encerra o estado visual do filtro rápido para evitar dois controles aparentarem governar critérios divergentes.
+## Quick filters, unified filter region, and density
+
+- **Região única de filtros e dono explícito da consulta**: Em telas de coleção com `praxis-table`, a própria tabela é a dona canônica dos filtros editáveis pelo usuário. Quando um campo (ex.: `ativo` / `status`) é governado por `config.toolbar.filters.quickFilters[]`, evite duplicá-lo em `alwaysVisibleFields` (mantenha-o apenas nos escopos rápidos e opcionalmente na gaveta avançada `selectedFieldIds`).
+- `config.toolbar.filters.quickFilters[]` materializa um seletor de escopo governado na toolbar. Cada item declara `id`, `label`, `filter` e `icon` opcional.
+  - Um item com `filter: {}` representa o escopo **"Todos"** (sem restrição editável): acioná-lo limpa critérios editáveis anteriores em `filterCriteria` e em `queryContext.filters` não estruturais sem exigir reload da página.
+  - Critérios booleanos explícitos `false` (ex.: `{ ativo: false }`) são preservados integralmente na serialização remota e na avaliação local.
+- **Reconciliação de atalhos externos (`queryContext.filters`) vs. filtros estruturais (`queryContext.meta`)**:
+  - Quando cards de KPI ou widgets externos aplicam um filtro editável via `queryContext.filters` (ex.: `{ ativo: true }`), a tabela sincroniza `advancedFilterValue`, `activeCrossFilters` e `activeQuickFilterId` correspondente.
+  - Se o operador alterar o escopo rápido (`onQuickFilterChange`), submeter/limpar os filtros da tabela (`onAdvancedFilterSubmit` / `onAdvancedFilterClear`) ou remover chips (`onClearCrossFilter` / `onClearAllCrossFilters`), a tabela reconcilia as chaves editáveis em `queryContext.filters` e emite `queryContextChange` e `queryContextClear`, impedindo que `queryContext.filters` órfãos continuem sobrescrevendo `filterCriteria`.
+  - Filtros estruturais de contexto (`queryContext.meta.relatedResource === true` + `parentFilterField`, `queryContext.meta.structuralFields`, `queryContext.meta.immutableFields` ou `queryContext.meta.structural === true`) permanecem protegidos e nunca são limpos por ações de filtro do usuário.
 - A composição adaptativa é responsabilidade do runtime: identidade, escopo, consulta e comandos se reorganizam pela largura do container da tabela. Dentro da consulta, campos editáveis formam a região de critérios; tags/atalhos salvos e comandos de gerenciamento formam um único cluster auxiliar. Em largura intermediária, os critérios e esse cluster completo compartilham o mesmo fluxo de quebra para aproveitar a faixa final sem criar uma linha órfã; em largura estreita, o cluster migra inteiro para a faixa seguinte. O host não precisa declarar coordenadas, breakpoints ou ordem visual adicional.
 - Em superfícies de até `640px`, os campos de consulta absorvem o espaço residual da própria linha até o limite do arquétipo; em `320px`, entradas que não cabem em pares ocupam a largura útil integral. Presets e comandos curtos preservam largura intrínseca. Grupos binários de filtros rápidos equilibram as duas opções em até `540px`, enquanto grupos maiores mantêm largura por conteúdo e overflow acessível.
 - `advancedFilters.settings.alwaysVisibleFields` deve conter apenas critérios frequentes. Atalhos persistidos e comandos de gerenciamento não devem ser simulados como campos sempre visíveis nem reposicionados por seletores CSS internos do host.
@@ -361,8 +366,15 @@ Este arquivo foi adaptado para o padrao canonico atual sem remover conteudo tecn
 | `toolbar.appearance` | object | No | Material 3 fallback | token-contract | Governa preset, variante, densidade, forma, divisores e tokens públicos da toolbar sem alterar a semântica das ações. |
 | `actions.collection.discovery.enabled` | boolean | No | `true` | collection-action-discovery | Controla se ações de coleção podem ser materializadas por HATEOAS/capabilities. Configure `false` em lookups/seletores para manter consulta remota e somente ações explicitamente declaradas. |
 | `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.actions[].quickView` | `ResourceQuickViewBinding` | No | none | `recordOpen` obrigatório | Habilita abertura de visualização rápida read-only ancorada ao botão da ação de linha (no hover para ações inline e no clique/teclado para ações inline ou no menu de overflow). |
 | `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[].quickView` | `ResourceQuickViewBinding` | No | none | `recordOpen` obrigatório | Habilita Quick View governado na célula via `[praxisQuickView]`, resolvendo leitura e ações somente-leitura pelo catálogo do recurso referenciado. |
 | `columns[].renderer` | object | No | field-type-driven | renderer-contract | Renderers condicionais, payload expr e ações interativas. |
+| `columns[].renderer.link.quickView` | `ResourceQuickViewBinding` | No | none | `recordOpen` obrigatório | Sobrescreve ou habilita Quick View específico para o renderer `link` (`hover-only` quando há `href` navegável; `hover-and-click` quando `href` está ausente). |
+| `columns[].renderer.badge.quickView` | `ResourceQuickViewBinding` | No | none | `recordOpen` obrigatório | Sobrescreve ou habilita Quick View específico para o renderer `badge`. |
+| `columns[].renderer.chip.quickView` | `ResourceQuickViewBinding` | No | none | `recordOpen` obrigatório | Sobrescreve ou habilita Quick View específico para o renderer `chip`. |
+| `columns[].renderer.icon.quickView` | `ResourceQuickViewBinding` | No | none | `recordOpen` obrigatório | Sobrescreve ou habilita Quick View específico para o renderer `icon`. |
+| `columns[].renderer.compose.items[].quickView` | `ResourceQuickViewBinding` | No | none | `recordOpen` obrigatório | Habilita Quick View específico para itens individuais (`value`, `link`, `badge`, `chip`, `icon`) dentro de uma célula `compose`. |
 
 Quando `actions.row.discovery.enabled` esta ativo e o item publica
 capabilities CRUD canonicas, `PraxisTable` pode sintetizar entradas
@@ -386,6 +398,10 @@ Renderer defaults:
 - Em `renderer.compose.items[]` com `type = "value"`, `emphasis = "strong"` representa o valor primário e `emphasis = "subtle"` o contexto de apoio. São os únicos níveis de hierarquia visual no item de texto; `style` arbitrário não integra o contrato de compose.
 
 - Em tabela, campos `*Expr` da visualizacao, como `valueExpr`, `targetExpr`, `segmentsExpr`, `toneExpr` e `fallbackTextExpr`, sao resolvidos contra o contexto da linha antes de renderizar. Strings simples sao caminhos (`row.slaAtual`) e objetos seguem Json Logic. Para `kind = "comparison"`, use `points`/`pointsExpr`; `items` fica reservado para visualizacoes orientadas a itens/etapas.
+- `columns[].quickView` e `columns[].renderer.link.quickView` (`ResourceQuickViewBinding`) materializam o gatilho canônico `[praxisQuickView]` (`PraxisQuickViewTriggerDirective`):
+  - `renderer.link.quickView` tem precedência sobre `columns[].quickView`.
+  - Em links com `href` real (`renderer.type = "link"`), o modo de disparo é `hover-only` no ponteiro (com chip acessível explícito em teclado/touch) para não sequestrar a navegação nativa do `<a href>`.
+  - Em células de texto, `badge`, `chip`, `compose` ou `link` sem `href`, o modo é `hover-and-click` (`tabindex="0"`, `Enter`/`Space` e clique isolado com `stopPropagation()` para não disparar seleção ou expansão da linha).
 
 ### Toolbar contract
 
@@ -949,13 +965,13 @@ O contrato principal e `TableConfig` (alias de `TableConfigV2`) com extensoes de
 
 #### Projeção governada de colunas
 
-Quando `columnProjection.source = "schema"`, a lista estrutural de colunas é
-materializada a partir de `/schemas/filtered`; a página declara apenas diferenças
-em `columnProjection.overrides`, indexadas pelo nome canônico do campo:
+Quando `columnProjection.source = "schema"`, a declaração explícita de `columns` é opcional.
+A lista estrutural de colunas é materializada em tempo de execução a partir de `/schemas/filtered`;
+a configuração declara apenas a seleção ordenada em `columnProjection.include` e as decisões
+editoriais pontuais em `columnProjection.overrides`, indexadas pelo nome canônico do campo:
 
 ```json
 {
-  "columns": [],
   "columnProjection": {
     "source": "schema",
     "include": ["competencia", "salarioBruto", "salarioLiquido"],
@@ -969,6 +985,11 @@ em `columnProjection.overrides`, indexadas pelo nome canônico do campo:
 }
 ```
 
+Quando consumido dentro de `<praxis-crud>`, o contrato também auto-infere a `schemaUrl`
+de `behavior.filtering.advancedFilters` a partir de `resource.schemaPath` ou `resource.path`
+(normalizado para `/schemas/filtered?path=/api/.../filter&operation=post&schemaType=request`),
+eliminando URLs estáticas duplicadas nos arquivos de configuração.
+
 O runtime reaplica os overrides após bootstrap e atualização do schema. Uma chave
 desconhecida não cria coluna, e `field` não pode ser alterado pelo override. Este
 contrato não cria “defaults da surface” paralelos: tipo, visibilidade, ordem e
@@ -1293,7 +1314,16 @@ Em `scroll-auto`, o viewport e uma regiao focalizavel por teclado para que o scr
 | Path | Type | Required | Default | Status | Notes |
 | --- | --- | --- | --- | --- | --- |
 | `columns[]` | `TableColumnConfig[]` | Yes | `[]` | Active | Definicao de colunas, renderers e regras de exibicao. |
+| `columns[].quickView` | `ResourceQuickViewBinding` | No | `undefined` | Active | Binding governado de Quick View (`recordOpen`, `detailPresentation?`, `contentRef?`) na celula. |
+| `columns[].renderer.link.quickView` | `ResourceQuickViewBinding` | No | `undefined` | Active | Override de Quick View no renderer `link` (`hover-only` com `href` valido). |
+| `columns[].renderer.badge.quickView` | `ResourceQuickViewBinding` | No | `undefined` | Active | Override de Quick View no renderer `badge`. |
+| `columns[].renderer.chip.quickView` | `ResourceQuickViewBinding` | No | `undefined` | Active | Override de Quick View no renderer `chip`. |
+| `columns[].renderer.icon.quickView` | `ResourceQuickViewBinding` | No | `undefined` | Active | Override de Quick View no renderer `icon`. |
+| `columns[].renderer.compose.items[].quickView` | `ResourceQuickViewBinding` | No | `undefined` | Active | Binding de Quick View por subitem em celulas `compose`. |
+| `actions.row.actions[].quickView` | `ResourceQuickViewBinding` | No | `undefined` | Active | Binding de Quick View ancorado ao botao da acao de linha. |
 | `behavior` | `TableBehaviorConfig` | No | defaults do runtime | Partial | Inclui paginacao, filtro, selecao e expansao por blocos. |
+| `behavior.filtering.advancedFilters.settings.showAddButton` | `boolean` | No | `true` | Active | Controla a exibicao do botao `+` de adicionar campos rapidos (`alwaysVisibleFields`) na barra do `PraxisFilter` embutido. |
+| `behavior.filtering.advancedFilters.settings.showFilterSettings` | `boolean` | No | `isCustomizationAvailable()` | Active | Controla a exibicao da engrenagem de preferencias do `PraxisFilter` embutido; quando `enableCustomization` esta desabilitado, permanece oculta. |
 | `toolbar.actions[]` | `ToolbarActionConfig[]` | No | `[]` | Partial | Acoes de toolbar com roteamento para `toolbarAction` e `bulkAction`. |
 | `toolbar.title` | `string` | No | `undefined` | Active | Titulo renderizado na regiao de identidade da toolbar principal, antes de filtros e acoes. |
 | `toolbar.subtitle` | `string` | No | `undefined` | Active | Texto auxiliar renderizado abaixo do titulo quando houver espaco. |

package/types/praxisui-table-authoring.d.ts

@@ -0,0 +1,132 @@
+import { TableConfig, FieldDefinition, GovernedPagePreviewWidgetAdapter, WidgetInstance } from '@praxisui/core';
+
+interface EditorDocument<TConfig, TBindings = unknown> {
+    kind: string;
+    version: number;
+    config: TConfig;
+    bindings?: TBindings;
+}
+type TableHorizontalScroll = 'auto' | 'wrap' | 'none';
+interface TableBindings {
+    resourcePath?: string | null;
+    horizontalScroll?: TableHorizontalScroll;
+}
+interface TableAuthoringDocument extends EditorDocument<TableConfig, TableBindings> {
+    kind: 'praxis.table.editor';
+    version: 1;
+}
+interface EditorDiagnostic {
+    level: 'error' | 'warning' | 'info';
+    code: string;
+    message: string;
+    path?: string;
+}
+interface TableValidationContext {
+    hasLocalDataInput?: boolean;
+    localDataModeDefaultEnabled?: boolean;
+    server?: {
+        idField?: string;
+        schemaHash?: string;
+    };
+}
+interface TableProjectionContext {
+    hasLocalDataInput?: boolean;
+    localDataModeDefaultEnabled?: boolean;
+}
+interface TableRuntimeContext {
+    hasLocalDataInput?: boolean;
+    localDataModeDefaultEnabled?: boolean;
+    server?: {
+        idField?: string;
+        schemaId?: string;
+        schemaHash?: string;
+    };
+    crud?: {
+        tableId: string;
+        componentKeyId?: string;
+    };
+    currentBindings?: TableBindings;
+}
+interface TableApplyPlan {
+    canonicalConfig: TableConfig;
+    bindingsPatch?: TableBindings;
+    persistence?: {
+        saveConfig?: boolean;
+        saveBindings?: boolean;
+    };
+    runtime?: {
+        reconnectDataSource?: boolean;
+        reloadSchema?: boolean;
+        fetchData?: boolean;
+        refreshLocalView?: boolean;
+    };
+    metadata?: {
+        attachServerMeta?: boolean;
+    };
+    diff?: {
+        resourcePathChanged?: boolean;
+        horizontalScrollChanged?: boolean;
+        requiresDataRefresh?: boolean;
+    };
+    diagnostics: EditorDiagnostic[];
+}
+
+/** Owner inputs exposed through @praxisui/table/authoring. Fields must already be normalized by admitted Core code.
+ * Config and bindings are variable native inputs, not recoverable from a schema.
+ * This helper neither admits sources nor evaluates raw schema expressions.
+ */
+interface TableEditorDocumentDerivationInput {
+    config: TableConfig;
+    bindings: TableBindings;
+    fields: FieldDefinition[];
+}
+/** Full native document: canonical defaults/action normalization are owned by
+ * createTableAuthoringDocument. This is not a public host executor or attestation.
+ */
+declare function deriveTableEditorDocument(input: TableEditorDocumentDerivationInput): TableAuthoringDocument;
+
+declare function createTableAuthoringDocument(source: {
+    config?: unknown;
+    bindings?: unknown;
+}): TableAuthoringDocument;
+declare function parseLegacyOrTableDocument(raw: unknown): TableAuthoringDocument;
+declare function normalizeTableAuthoringDocument(doc: TableAuthoringDocument): TableAuthoringDocument;
+declare function validateTableAuthoringDocument(doc: TableAuthoringDocument, context?: TableValidationContext): EditorDiagnostic[];
+declare function toCanonicalTableConfig(doc: TableAuthoringDocument, context?: TableProjectionContext): TableConfig;
+declare function buildTableApplyPlan(doc: TableAuthoringDocument, runtime?: TableRuntimeContext, options?: {
+    saveConfig?: boolean;
+    saveBindings?: boolean;
+    attachServerMeta?: boolean;
+}): TableApplyPlan;
+declare function serializeTableAuthoringDocument(doc: TableAuthoringDocument): unknown;
+
+/** Raw compact schema authorship only; native normalization remains an editor/runtime projection. */
+declare function decodeTablePageInputs(value: unknown): {
+    document: TableAuthoringDocument | null;
+    diagnostics: EditorDiagnostic[];
+};
+/** Core prefixes these widget-relative JSON Pointers; this callback never resolves a source/latest. */
+declare function validateTablePageWidget(widget: WidgetInstance): readonly {
+    code: string;
+    path: string;
+}[];
+declare function encodeTablePageInputs(value: unknown): {
+    inputs: Record<string, unknown> | null;
+    diagnostics: EditorDiagnostic[];
+};
+/** No-change values in a materialized native editor cannot author defaults or erase absent keys. */
+declare function projectTablePageEditorChanges(authoredInputs: unknown, editorBaseline: unknown, editorValue: unknown): {
+    inputs: Record<string, unknown> | null;
+    diagnostics: EditorDiagnostic[];
+};
+/** Derive execution-only identity and disable independent preferences. Never persist this projection. */
+declare function materializeTablePageRuntimeInputs(value: unknown, pageId: string, widgetKey: string, options?: {
+    preview?: boolean;
+}): {
+    inputs: Record<string, unknown> | null;
+    diagnostics: EditorDiagnostic[];
+};
+declare const TABLE_GOVERNED_PAGE_PREVIEW_ADAPTER: GovernedPagePreviewWidgetAdapter;
+
+export { TABLE_GOVERNED_PAGE_PREVIEW_ADAPTER, buildTableApplyPlan, createTableAuthoringDocument, decodeTablePageInputs, deriveTableEditorDocument, encodeTablePageInputs, materializeTablePageRuntimeInputs, normalizeTableAuthoringDocument, parseLegacyOrTableDocument, projectTablePageEditorChanges, serializeTableAuthoringDocument, toCanonicalTableConfig, validateTableAuthoringDocument, validateTablePageWidget };
+export type { EditorDiagnostic, TableApplyPlan, TableAuthoringDocument, TableBindings, TableEditorDocumentDerivationInput, TableProjectionContext, TableRuntimeContext, TableValidationContext };