@praxisui/table 9.0.68-rc.3 → 10.0.0-rc.3

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

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

package/fesm2022/{praxisui-table-table-ai.adapter-B2LTkMdM.mjs → praxisui-table-table-ai.adapter-CPgpIGoi.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-EGWwY1dR.mjs';
+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';
 
 const TABLE_ROW_EXPRESSION_CONTEXT_OPTION = {
     mode: 'expression',
@@ -207,15 +207,16 @@ const TABLE_COMPONENT_CONTEXT_PACK = {
                 { value: 'false', label: 'Disabled' },
             ],
         },
-        'behavior.expansion.detail.source.mode': {
+        'behavior.detail.source.mode': {
             mode: 'enum',
             options: [
                 { value: 'inline', label: 'Inline' },
                 { value: 'resource', label: 'Resource' },
                 { value: 'resourcePath', label: 'Resource Path' },
+                { value: 'hypermedia', label: 'Hypermedia' },
             ],
         },
-        'behavior.expansion.detail.source.resource.kind': {
+        'behavior.detail.source.resource.kind': {
             mode: 'enum',
             options: [
                 { value: 'ui-composition', label: 'UI Composition' },
@@ -224,34 +225,34 @@ const TABLE_COMPONENT_CONTEXT_PACK = {
                 { value: 'dashboard-schema', label: 'Dashboard Schema' },
             ],
         },
-        'behavior.expansion.detail.source.resourcePath.method': {
+        'behavior.detail.source.resourcePath.method': {
             mode: 'enum',
             options: [
                 { value: 'GET', label: 'GET' },
                 { value: 'POST', label: 'POST' },
             ],
         },
-        'behavior.expansion.detail.source.resourcePath.paramsMap': {
+        'behavior.detail.source.resourcePath.paramsMap': {
             mode: 'suggested',
             options: [
                 { value: '{"id":"$row.id"}', label: 'Row ID' },
                 { value: '{"id":"$row.id","table":"$ctx.tableId"}', label: 'Row + Table' },
             ],
         },
-        'behavior.expansion.detail.source.resourceAllowList[]': {
+        'behavior.detail.source.resourceAllowList[]': {
             mode: 'suggested',
             options: [
                 { value: 'api/orders/*/detail-schema', label: 'Orders detail schema' },
                 { value: 'api/customers/*/detail-schema', label: 'Customers detail schema' },
             ],
         },
-        'behavior.expansion.detail.rendering.strategy': {
+        'behavior.detail.rendering.strategy': {
             mode: 'enum',
             options: [
                 { value: 'registry', label: 'Registry' },
             ],
         },
-        'behavior.expansion.detail.rendering.hostLayout': {
+        'behavior.detail.rendering.hostLayout': {
             mode: 'enum',
             options: [
                 { value: 'auto', label: 'Auto' },
@@ -259,14 +260,14 @@ const TABLE_COMPONENT_CONTEXT_PACK = {
                 { value: 'tabs', label: 'Tabs' },
             ],
         },
-        'behavior.expansion.detail.rendering.fallbackNodePolicy': {
+        'behavior.detail.rendering.fallbackNodePolicy': {
             mode: 'enum',
             options: [
                 { value: 'failClosed', label: 'Fail Closed' },
                 { value: 'renderPlaceholder', label: 'Render Placeholder' },
             ],
         },
-        'behavior.expansion.detail.height.mode': {
+        'behavior.detail.height.mode': {
             mode: 'enum',
             options: [
                 { value: 'fixed', label: 'Fixed' },
@@ -1349,16 +1350,16 @@ const TABLE_COMPONENT_CONTEXT_PACK = {
             defaultValue: true,
             patchTemplate: {
                 behavior: {
+                    detail: {
+                        schemaContract: { kind: 'praxis.detail.schema', version: '1.0.0' },
+                        source: { mode: 'inline', inlineSchema: { layout: 'stack', items: [] } },
+                        rendering: { strategy: 'registry', registryId: 'praxis.detail.default' }
+                    },
                     expansion: {
                         enabled: true,
                         contractVersion: '1.0.0',
                         interaction: { trigger: 'icon', keyboard: { profile: 'disclosure' } },
                         limits: { allowMultiple: false, maxExpandedRows: 1, onOverflow: 'collapseOldest' },
-                        detail: {
-                            schemaContract: { kind: 'praxis.detail.schema', version: '1.0.0' },
-                            source: { mode: 'inline', inlineSchema: { layout: 'stack', items: [] } },
-                            rendering: { strategy: 'registry', registryId: 'praxis.detail.default' }
-                        }
                     }
                 }
             }
@@ -1371,7 +1372,8 @@ const TABLE_COMPONENT_CONTEXT_PACK = {
             operation: 'update',
             requiresExistingTarget: false,
             patchTemplate: {
-                behavior: { expansion: { detail: { source: { mode: '{{value}}' } } } }
+                behavior: { detail: { source: { mode: '{{value}}' } },
+                    expansion: {} }
             }
         },
         {
@@ -1383,18 +1385,17 @@ const TABLE_COMPONENT_CONTEXT_PACK = {
             requiresExistingTarget: false,
             patchTemplate: {
                 behavior: {
-                    expansion: {
-                        detail: {
-                            source: {
-                                mode: 'resource',
-                                resource: {
-                                    kind: '{{params.kind}}',
-                                    id: '{{params.id}}',
-                                    version: '{{params.version}}'
-                                }
+                    detail: {
+                        source: {
+                            mode: 'resource',
+                            resource: {
+                                kind: '{{params.kind}}',
+                                id: '{{params.id}}',
+                                version: '{{params.version}}'
                             }
                         }
-                    }
+                    },
+                    expansion: {}
                 }
             }
         },
@@ -1681,9 +1682,9 @@ const TABLE_COMPONENT_CONTEXT_PACK = {
         'DOC: Widget purpose: data table with sorting, filtering, pagination, and actions.',
         'DOC: Host inputs: tableId (required), resourcePath (optional), config (optional).',
         'DOC: config defaults to createDefaultTableConfig(); columns may start empty.',
-        'DOC: behavior.expansion.detail é schema-driven; altere source.mode (inline/resource/resourcePath), não use detail.type.',
+        'DOC: behavior.detail é schema-driven; altere source.mode (inline/resource/resourcePath), não use detail.type.',
         'DOC: Para detail.source.mode=resource, sempre informar resource.kind + resource.id + resource.version.',
-        'DOC: Para detail.source.mode=resourcePath, sempre informar resourcePath.paramsMap + resourceAllowList[]; URL absoluta/scheme (http:, https:, data:, javascript:) é bloqueada e o runtime aplica fail-closed.',
+        'DOC: Para detail.source.mode=resourcePath, sempre informar resourcePath.paramsMap + resourceAllowList[] de pathname; o runtime resolve contra document.baseURI, exige origem do host, compara o pathname canonicalizado e bloqueia URL absoluta/scheme, redirects e representações ambíguas. A allowlist é guardrail do documento, não autorização nem política por método; o backend continua responsável por autorizar GET/POST.',
         'DOC: collapseOn ativo no runtime P0A: sortChange, pageChange, filterChange e dataRefresh.',
         'DOC: When resourcePath is available, the table can load schema and data; ask the user to pick an API resource when missing.',
         'DOC: resourcePath must be the base resource path only (no /filter, /all, /{id}). CRUD endpoints are handled internally.',
@@ -3699,8 +3700,8 @@ Columns Analysis:
         const warnings = [];
         // Some schema-driven nodes are intentionally open objects and must be preserved as-is.
         const passthroughObjectPaths = new Set([
-            'behavior.expansion.detail.source.inlineSchema',
-            'behavior.expansion.detail.source.resourcePath.paramsMap',
+            'behavior.detail.source.inlineSchema',
+            'behavior.detail.source.resourcePath.paramsMap',
         ]);
         const jsonLogicObjectPaths = new Set([
             'columns[].computed.expression',

package/fesm2022/praxisui-table.mjs

@@ -1 +1 @@
-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-EGWwY1dR.mjs';
+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';

package/package.json

@@ -1,24 +1,24 @@
 {
   "name": "@praxisui/table",
-  "version": "9.0.68-rc.3",
+  "version": "10.0.0-rc.3",
   "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": "^9.0.68-rc.3",
-    "@praxisui/core": "^9.0.68-rc.3",
-    "@praxisui/dynamic-fields": "^9.0.68-rc.3",
-    "@praxisui/dynamic-form": "^9.0.68-rc.3",
-    "@praxisui/metadata-editor": "^9.0.68-rc.3",
-    "@praxisui/rich-content": "^9.0.68-rc.3",
-    "@praxisui/settings-panel": "^9.0.68-rc.3",
-    "@praxisui/table-rule-builder": "^9.0.68-rc.3",
+    "@praxisui/ai": "^10.0.0-rc.3",
+    "@praxisui/core": "^10.0.0-rc.3",
+    "@praxisui/dynamic-fields": "^10.0.0-rc.3",
+    "@praxisui/dynamic-form": "^10.0.0-rc.3",
+    "@praxisui/metadata-editor": "^10.0.0-rc.3",
+    "@praxisui/rich-content": "^10.0.0-rc.3",
+    "@praxisui/settings-panel": "^10.0.0-rc.3",
+    "@praxisui/table-rule-builder": "^10.0.0-rc.3",
     "@angular/cdk": "^21.0.0",
     "@angular/forms": "^21.0.0",
     "@angular/material": "^21.0.0",
     "@angular/router": "^21.0.0",
-    "@praxisui/dialog": "^9.0.68-rc.3",
+    "@praxisui/dialog": "^10.0.0-rc.3",
     "rxjs": "~7.8.0"
   },
   "dependencies": {

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

@@ -128,6 +128,9 @@ Este documento e a referencia canonica da API JSON de praxis-table.
 - Renderers interativos como `button`, `toggle`, `menu`, `link`, `html` e `rating`, alem do shell de detail/expansion, continuam table-owned e fora do contrato compartilhado `1.0` ate promocao semantica explicita.
 
 ## Detail rich surfaces
+- `richContent` incorpora um documento canônico `praxis.rich-content@1.0.0` no corpo do registro selecionado. Use-o para `callout`, cartões semânticos, ícones, hierarquia tipográfica e ações sem duplicar essa taxonomia dentro de Table.
+- O documento é validado integralmente antes do render. Cada `actionId` do conteúdo rico precisa existir em `actions.row.actions[]`; referências não declaradas ficam indisponíveis e não são despachadas. Ações declaradas são mediadas pelo host e seguem `onRowAction`; confirmação, capabilities e autorização continuam governadas pela Table e pelo backend.
+- O editor visual de Detalhes delega `richContent.document` ao `PraxisRichContentConfigEditor`, incluindo tons `neutral|info|success|warning|danger`, bindings como `row.note`, mídia e botões. Tokens semânticos são o caminho recomendado; gradientes são estilo avançado e exigem prova de contraste nos temas suportados.
 - `actionBar` entra na mesma fronteira canônica de detail row para agrupar ações contextuais host-mediated.
 - `actionBar` é host-mediated:
   - o host resolve visibilidade, disabled e dispatch
@@ -138,7 +141,7 @@ Este documento e a referencia canonica da API JSON de praxis-table.
   - cada entrada usa `itemSchema` para mapear `title`, `subtitle`, `meta`, `icon` e `badge`
   - o host resolve dados e fallback, mas o rendering cronologico final fica no `PraxisRichContent`
 
-- `behavior.expansion.detail.schemaContract.allowedNodes` inclui `detailList` e `cardGrid` como surfaces canônicas de detail row.
+- `behavior.detail.schemaContract.allowedNodes` inclui `detailList` e `cardGrid` como surfaces canônicas de detail row.
 - `list` continua sendo lista simples e nao aceita subtree declarativa por item.
 - `mediaBlock` tambem faz parte da fronteira canonica do detail row, como primitive compartilhada para avatar/imagem, headline, subtitle, meta e trailing leve.
 - `detailList` e host-mediated:
@@ -312,12 +315,12 @@ type TableAuthoringDocument = {
 
 | Path | Enablement (flag/guard) | Stability | Rollout notes | Notes |
 | --- | --- | --- | --- | --- |
-| `behavior.expansion.detail.source.resourcePath` | `resourceAllowList` + `schemaContract` + renderer contract | Partial | Guard rails ativos; requer evidência de host para produção | Fluxo com fail-closed quando contrato/allowlist falha. |
-| `behavior.expansion.detail.source.hypermedia` | `_links.capabilities` + `schemaContract` + renderer contract | Partial | Usa discovery canônico do backend; fail-closed sem `rel="capabilities"` | Primeiro corte gera detail schema leve a partir do snapshot agregado. |
+| `behavior.detail.source.resourcePath` | `resourceAllowList` + `schemaContract` + renderer contract | Partial | Guard rails ativos; requer evidência de host para produção | Fluxo com fail-closed quando contrato/allowlist falha. |
+| `behavior.detail.source.hypermedia` | `_links.capabilities` + `schemaContract` + renderer contract | Partial | Usa discovery canônico do backend; fail-closed sem `rel="capabilities"` | Primeiro corte gera detail schema leve a partir do snapshot agregado. |
 
 ### Hypermedia detail semantics
 
-- `behavior.expansion.detail.source.mode = "hypermedia"` começa sempre em `_links.capabilities`.
+- `behavior.detail.source.mode = "hypermedia"` começa sempre em `_links.capabilities`.
 - `surfaces`, `actions` e `canonicalOperations` são lidos do `ResourceCapabilitySnapshot` retornado pelo backend.
 - O primeiro corte monta um detail schema leve de resumo contextual; ele não embute execução inline de `surface.open` nem de workflow.
 - O runtime faz prefetch por linha somente quando existe ao menos uma ação contextual configurada para projeção inline (`display="icons"|"buttons"`). Ações restritas ao menu preservam discovery sob demanda ao abrir o overflow; expansion `hypermedia` sem row actions continua resolvendo o contexto ao expandir a linha.
@@ -556,11 +559,11 @@ degraded filter.
 
 - input explícito de runtime tem precedência sobre persistência local.
 - paths canônicos têm precedência sobre aliases internos remanescentes (`__forceRemoteMode__`).
-- em `behavior.expansion.detail`, contrato inválido aplica fail-closed para detail row.
-- `behavior.expansion.detail.source.mode = "hypermedia"` usa `_links.capabilities` como ponto único de entrada e não executa `surface.open` inline no primeiro corte.
+- em `behavior.detail`, contrato inválido aplica fail-closed para detail row.
+- `behavior.detail.source.mode = "hypermedia"` usa `_links.capabilities` como ponto único de entrada e não executa `surface.open` inline no primeiro corte.
 
 Observação adicional:
-- no primeiro corte, `behavior.expansion.detail.source.mode = "hypermedia"` usa `_links.capabilities` como ponto único de entrada, consome `surfaces/actions/canonicalOperations` do snapshot agregado e não executa `surface.open` inline.
+- no primeiro corte, `behavior.detail.source.mode = "hypermedia"` usa `_links.capabilities` como ponto único de entrada, consome `surfaces/actions/canonicalOperations` do snapshot agregado e não executa `surface.open` inline.
 
 ## Validation and error semantics
 
@@ -570,9 +573,9 @@ Observação adicional:
 | --- | --- | --- | --- | --- |
 | `tableId` para persistência | init/runtime | warn + disable persistence | `praxis-table:missing-table-id` | Tabela segue funcional sem persistir preferências. |
 | `appearance.responsive.breakpoints.mobile` | runtime normalization | fallback para `768` | `praxis-table:responsive-breakpoint-mobile-invalid` | Comportamento fail-open com warning deduplicado. |
-| `behavior.expansion.detail.schemaContract.kind/version` | runtime validation | fail-closed (sem render de detail) | `praxis-table:expansion:detail:schema-contract-kind-version-invalid` | Bloqueia detail schema inválido. |
-| `behavior.expansion.detail.source.resourcePath` allowlist | runtime validation | fail-closed | `praxis-table:expansion:detail:resource-path-not-allowlisted` | Bloqueia path fora de allowlist/URL absoluta. |
-| `behavior.expansion.detail.source.hypermedia` sem `_links.capabilities` | runtime validation | fail-closed | `praxis-table:expansion:detail:hypermedia-links-missing` | Bloqueia detail hypermedia quando o item não expõe affordance canônica. |
+| `behavior.detail.schemaContract.kind/version` | runtime validation | fail-closed (sem render de detail) | `praxis-table:expansion:detail:schema-contract-kind-version-invalid` | Bloqueia detail schema inválido. |
+| `behavior.detail.source.resourcePath` policy | canonical URL + same-origin pathname allowlist | fail-closed | `praxis-table:expansion:detail:resource-path-policy-blocked:*` | Bloqueia URL absoluta, origem divergente, traversal/representações ambíguas, path efetivo fora da allowlist e redirects. Usa credenciais same-origin e `EnterpriseRuntimeContextService.effectiveRequestHeaders()`. A allowlist protege o documento; autorização GET/POST continua no backend. Hosts dependentes de interceptors Angular devem usar o resolver governado de `source.mode=resource` ou configurar os headers canônicos. |
+| `behavior.detail.source.hypermedia` sem `_links.capabilities` | runtime validation | fail-closed | `praxis-table:expansion:detail:hypermedia-links-missing` | Bloqueia detail hypermedia quando o item não expõe affordance canônica. |
 | `detail rendering contract` | runtime validation | fail-closed | `praxis-table:expansion:detail:rendering-invalid` | Exige estratégia/registry consistentes. |
 
 ### Error semantics
@@ -1462,7 +1465,19 @@ Nota: exemplos especificos do componente foram preservados na secao detalhada pa
 
 ## Governed embeds
 
-- `behavior.expansion.detail.schemaContract.allowedNodes` agora tambem pode incluir `formRef`, `tableRef`, `chartRef`, `templateRef` e `diagramEmbed`.
+### Contextual detail presentation
+
+`behavior.detail` owns the shared schema, source, rendering, height and lazy-load configuration. `presentation.placement` selects `row` (the default) or `bottom`; `presentation.initiallyCollapsed` sets the initial disclosure state. For bottom presentation, `presentation.bottomStackPosition` selects `afterControls` (the default) or `beforeControls`, and `presentation.emptyBehavior` selects an instructional `message` (the default) or `hide`. A missing `height` defaults to dynamic sizing. `height.mode` accepts explicit `dynamic` or `fixed`; fixed mode requires a positive `px`. `behavior.expansion` owns row interaction only. Do not store detail inside expansion: the finite migration moves that branch and rejects differing old/new definitions. Runtime does not read the old path.
+
+Bottom detail uses the existing selection model. Exactly one visible record with a stable identity may provide the body. Zero or multiple selections retain an explicit empty/status region; a retained selection outside the current page never reads a detail body. Refreshing the same ID refreshes its context. Selection never executes a business action.
+
+Use `detail.presentation.configure` to choose bottom: it disables row expansion and enables single selection when selection is disabled, preserving an already enabled multiple-selection policy. Choosing row enables row expansion; disabling detail disables expansion. Conflicting hand-authored configurations fail closed. `detail.configure` and `expansion.configure` apply their declared activation semantics. `detail.source.configure` changes only the source; extension properties inside that source never act as presentation commands. Unknown extensions remain preserved, while malformed known groups, booleans and source modes block Apply. An existing dynamic height requires an explicit positive fixed-height adjustment before choosing bottom.
+
+The Details section edits the authored tree and preserves field expressions, unknown nodes and provider references. Its local preview does not perform remote reads or persist sample values. Invalid advanced JSON blocks Apply/Save. Discard restores detail edits; global defaults retain their existing reset semantics.
+
+The bottom body defaults to dynamic height with a small-viewport CSS limit. Fixed mode starts at 192px in the editor and provides vertical scrolling. It is outside the virtual viewport and defaults to after the footer controls, preserving the collection stack. Explicit collapse persists across selection changes. Inline charts require the Charts provider; unresolved references remain explained placeholders.
+
+- `behavior.detail.schemaContract.allowedNodes` agora tambem pode incluir `formRef`, `tableRef`, `chartRef`, `templateRef` e `diagramEmbed`.
 - Esses nodes continuam host-mediated:
   - o host resolve discovery, registry, abertura e policy
   - a tabela padroniza o shell, os metadados e a CTA do embed
@@ -1542,3 +1557,4 @@ The embedded table supplies the heading, advanced-action label, dialog title and
 Tokens project to CSS custom properties `--pfx-filter-gap`, `--pfx-filter-header-gap`, `--pfx-filter-header-color`, `--pfx-filter-header-font-size`, `--pfx-filter-header-font-weight`, `--pfx-filter-icon-size`, `--pfx-filter-action-gap`, `--pfx-filter-action-font-size`, and `--pfx-filter-action-font-weight`. Prefer the semantic size/position controls for ordinary authoring; tokens are for deliberate theme customization.
 
 AI authoring extends existing operations: `filter.advanced.configure` receives `settings.presentation` for tables; `filter.settings.configure` receives `presentation` for standalone filters. Neither operation authors a query through this object.
+Corporate context changes use the existing `EnterpriseRuntimeContextService`: Table invalidates rows, selection, discovery and pending data/detail responses before a new remote load. Local hosts must replace `data` for the effective context and discard their own obsolete asynchronous deliveries. This is runtime state isolation, not backend authorization. `initiallyCollapsed` is reapplied after persisted hydration and configuration Apply.