@praxisui/dynamic-form 9.0.4-rc.18 → 9.0.4-rc.19

package/README.md

@@ -132,6 +132,13 @@ the runtime fails initialization instead of rendering a form from the wrong busi
 non-layout host/persisted concerns such as `actions`, `api`, `messages`, rules, hooks and rich
 blocks. Host-provided non-layout config has precedence over persisted config.
 
+For nested commands, `layoutPolicy.groupedCommand.contextFields` identifies request fields whose
+values are supplied by the surrounding surface (for example, the employee id inherited by a
+related-resource drawer). These fields remain schema-backed controls in the runtime form and are
+included in the submit payload, but are omitted from the interactive layout. The host must hydrate
+them through `initialValue` on create or through the entity read on edit; this policy must not hide
+values that the user is expected to choose.
+
 When `mode="view"` and the host does not provide `presentationModeGlobal`, a schema policy with
 `intent: "detail"` or `preset: "compactPresentation"` also enables presentation rendering. Hosts
 that need traditional disabled controls for the same schema can pass `[presentationModeGlobal]="false"`.

package/ai/component-registry.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": "1.0.0",
-  "generatedAt": "2026-08-03T19:37:31.311Z",
+  "generatedAt": "2026-08-04T03:36:47.613Z",
   "packageName": "@praxisui/dynamic-form",
-  "packageVersion": "9.0.4-rc.18",
+  "packageVersion": "9.0.4-rc.19",
   "sourceRegistry": "praxis-component-registry-ingestion",
   "sourceRegistryVersion": "1.0.0",
   "componentCount": 2,
@@ -4264,6 +4264,13 @@
           "description": "Define como uma linha groupedCommand com um unico campo usa o espaco restante. O default medium-and-wide expande spans 6 ou 8 e preserva campos compactos.",
           "safetyNotes": "Use preserve quando o espaco vazio for intencional; use all apenas quando ate campos xs/sm devam ocupar a linha completa."
         },
+        {
+          "path": "inputs.layoutPolicy.groupedCommand.contextFields",
+          "category": "inputs",
+          "valueKind": "array",
+          "description": "Campos canônicos do request cujo valor vem do contexto da surface. Eles permanecem no FormGroup e no payload, sem renderizar controles redundantes.",
+          "safetyNotes": "Use somente para campos realmente hidratados por initialValue ou leitura da entidade; nunca use para esconder dados que a pessoa ainda precisa informar."
+        },
         {
           "path": "inputs.layoutPolicy.detailSummary",
           "category": "inputs",
@@ -6205,7 +6212,7 @@
           {
             "name": "layoutPolicy",
             "type": "DynamicFormLayoutPolicy",
-            "description": "Politica opt-in para layout schema-driven transient. Use source=schema apenas quando o backend schema for a fonte canonica do agrupamento; use detailSummary para seleção de campos e densidade responsiva do resumo read-only compacto sem FormConfig.sections locais. Quando o resumo precisar vencer x-ui.width publicado para outras surfaces, use detailSummary.widthPrecedence=summary. Em groupedCommand, orphanFieldExpansion governa linhas com um unico campo; medium-and-wide e o default corporativo."
+            "description": "Politica opt-in para layout schema-driven transient. Use source=schema apenas quando o backend schema for a fonte canonica do agrupamento; use detailSummary para seleção de campos e densidade responsiva do resumo read-only compacto sem FormConfig.sections locais. Quando o resumo precisar vencer x-ui.width publicado para outras surfaces, use detailSummary.widthPrecedence=summary. Em groupedCommand, orphanFieldExpansion governa linhas com um unico campo; contextFields identifica campos do request hidratados pela surface que permanecem no payload sem criar controles redundantes."
           },
           {
             "name": "fieldIconPolicy",
@@ -8820,9 +8827,9 @@
         {
           "chunkIndex": 10,
           "chunkKind": "capabilities",
-          "content": "Schema Capability:\n  - Path: fieldMetadata[].transformDisplayValue\n    Category: transform\n    Kind: expression\n    Description: Transforma valor para exibição.\n\nSchema Capability:\n  - Path: fieldMetadata[].transformSaveValue\n    Category: transform\n    Kind: expression\n    Description: Transforma valor para salvar.\n\nSchema Capability:\n  - Path: fieldMetadata[].textTransformApply\n    Category: transform\n    Kind: enum\n    Description: Quando aplicar transformação de texto.\n\nSchema Capability:\n  - Path: fieldMetadata[].inlineEditing\n    Category: behavior\n    Kind: boolean\n    Description: Permite edição inline (tabelas).\n\nSchema Capability:\n  - Path: fieldMetadata[].unique\n    Category: validation\n    Kind: boolean\n    Description: Valida unicidade no backend.\n\nSchema Capability:\n  - Path: fieldMetadata[].readOnly\n    Category: behavior\n    Kind: boolean\n    Description: Campo somente leitura.\n\nSchema Capability:\n  - Path: fieldMetadata[].disabled\n    Category: behavior\n    Kind: boolean\n    Description: Campo desabilitado.\n\nSchema Capability:\n  - Path: fieldMetadata[].defaultValue\n    Category: data\n    Kind: object\n    Description: Valor inicial do campo.\n\nSchema Capability:\n  - Path: fieldMetadata[].ariaLabel\n    Category: accessibility\n    Kind: string\n    Description: Label para leitores de tela.\n\nSchema Capability:\n  - Path: fieldMetadata[].ariaDescribedBy\n    Category: accessibility\n    Kind: string\n    Description: IDs de descrição acessível.\n\nSchema Capability:\n  - Path: fieldMetadata[].tabIndex\n    Category: accessibility\n    Kind: number\n    Description: Ordem de tabulacao para teclado.\n\nSchema Capability:\n  - Path: fieldMetadata[].accessKey\n    Category: accessibility\n    Kind: string\n    Description: Atalho de teclado (accessKey).\n\nComponent Capability:\n  - Path: inputs.resourcePath\n    Category: inputs\n    Kind: string\n    Description: Caminho do recurso para carregar/salvar dados via CRUD.\n\nComponent Capability:\n  - Path: inputs.resourceId\n    Category: inputs\n    Kind: string\n    Description: ID do registro atual (string ou number).\n\nComponent Capability:\n  - Path: inputs.initialValue\n    Category: inputs\n    Kind: object\n    Description: Valores iniciais locais para campos host-authored ou complementares.\n\nComponent Capability:\n  - Path: inputs.mode\n    Category: inputs\n    Kind: enum\n    Description: Modo do formulario (create/edit/view).\n\nComponent Capability:\n  - Path: inputs.config\n    Category: inputs\n    Kind: object\n    Description: Configuracao completa do formulario (FormConfig).\n\nComponent Capability:\n  - Path: inputs.schemaSource\n    Category: inputs\n    Kind: enum\n    Description: Fonte de schema para construcao automatica (resource/filter).\n\nComponent Capability:\n  - Path: inputs.schemaUrl\n    Category: inputs\n    Kind: string\n    Description: Schema canonico explicito publicado pelo backend para hosts que seguem surfaces/actions/capabilities.\n\nComponent Capability:\n  - Path: inputs.readUrl\n    Category: inputs\n    Kind: string\n    Description: Endpoint canonico de leitura publicado por surface VIEW/READ_PROJECTION para hidratar a entidade exibida.\n\nComponent Capability:\n  - Path: inputs.apiEndpointKey\n    Category: inputs\n    Kind: string\n    Description: Endpoint canonico usado para resolver schemaUrl, readUrl e submitUrl relativos em hosts destacados.\n\nComponent Capability:\n  - Path: inputs.submitUrl\n    Category: inputs\n    Kind: string\n    Description: Endpoint canonico de submit publicado por surface/action.\n\nComponent Capability:\n  - Path: inputs.submitMethod\n    Category: inputs\n    Kind: enum\n    Description: Metodo HTTP canonico para o submit quando o backend publica operacao explicita.\n\nComponent Capability:\n  - Path: inputs.submitIdempotencyKey\n    Category: inputs\n    Kind: string\n    Description: Identidade estavel da tentativa de comando, materializada a partir da politica execution da action.\n\nComponent Capability:\n  - Path: inputs.submitCorrelationId\n    Category: inputs\n    Kind: string\n    Description: Identificador de correlacao governado para rastreabilidade ponta a ponta do comando.\n\nComponent Capability:\n  - Path: inputs.submitResourceVersion\n    Category: inputs\n    Kind: string\n    Description: Versao persistida esperada, transportada como If-Match quando exigida pela action.\n\nComponent Capability:\n  - Path: inputs.responseSchemaUrl\n    Category: inputs\n    Kind: string\n    Description: Schema de resposta publicado pelo backend para inspeção diagnostica/read-only do host.\n\nComponent Capability:\n  - Path: inputs.enableCustomization\n    Category: inputs\n    Kind: boolean\n    Description: Habilita a edicao de layout/configuracao no editor.\n\nComponent Capability:\n  - Path: inputs.showAiAssistant\n    Category: inputs\n    Kind: boolean\n    Description: Mostra os gatilhos do copiloto semantico Praxis para a instancia do formulario.\n\nComponent Capability:\n  - Path: inputs.formId\n    Category: inputs\n    Kind: string\n    Description: ID persistente para salvar configuracoes e preferencias.\n\nComponent Capability:\n  - Path: inputs.editorialContext\n    Category: inputs\n    Kind: object\n    Description: Override de contexto editorial fornecido pelo host para os blocos hospedados antes/depois do formulario.\n\nComponent Capability:\n  - Path: inputs.layout\n    Category: inputs\n    Kind: object\n    Description: Layout legado (FormLayout). Preferir inputs.config + sections.\n\nComponent Capability:\n  - Path: inputs.generatedLayoutPreset\n    Category: inputs\n    Kind: enum\n    Description: Preset usado somente na criacao inicial de FormConfig a partir de schema/metadata.\n\nComponent Capability:\n  - Path: inputs.configPersistenceStrategy\n    Category: inputs\n    Kind: enum\n    Description: Define se preferências locais persistidas ou o contrato explícito do host governam a materialização corrente.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy\n    Category: inputs\n    Kind: object\n    Description: Politica opt-in para materializar layout diretamente do schema atual sem depender de FormConfig.sections authoradas.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.source\n    Category: inputs\n    Kind: enum\n    Description: Define se o layout vem de configuracao authorada ou do schema.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.preset\n    Category: inputs\n    Kind: enum\n    Description: Preset de layout schema-driven. compactPresentation cobre detalhe read-only; groupedCommand cobre create/edit.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.intent\n    Category: inputs\n    Kind: enum\n    Description: Intencao da surface: detalhe/apresentacao ou comando/editavel.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.lifecycle\n    Category: inputs\n    Kind: enum\n    Description: Ciclo de materializacao do layout schema-driven.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.persistence\n    Category: inputs\n    Kind: enum\n    Description: Define se sections geradas sao transient ou podem virar layout authorado apos detach explicito.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.groupedCommand.orphanFieldExpansion\n    Category: inputs\n    Kind: enum\n    Description: Define como uma linha groupedCommand com um unico campo usa o espaco restante. O default medium-and-wide expande spans 6 ou 8 e preserva campos compactos.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.detailSummary\n    Category: inputs\n    Kind: object\n    Description: Politica declarativa para resumo read-only compacto em compactPresentation, sem FormConfig.sections locais.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.detailSummary.includeFields\n    Category: inputs\n    Kind: array\n    Description: Lista de campos canônicos do schema que devem entrar no resumo read-only compacto.",
+          "content": "Schema Capability:\n  - Path: fieldMetadata[].transformDisplayValue\n    Category: transform\n    Kind: expression\n    Description: Transforma valor para exibição.\n\nSchema Capability:\n  - Path: fieldMetadata[].transformSaveValue\n    Category: transform\n    Kind: expression\n    Description: Transforma valor para salvar.\n\nSchema Capability:\n  - Path: fieldMetadata[].textTransformApply\n    Category: transform\n    Kind: enum\n    Description: Quando aplicar transformação de texto.\n\nSchema Capability:\n  - Path: fieldMetadata[].inlineEditing\n    Category: behavior\n    Kind: boolean\n    Description: Permite edição inline (tabelas).\n\nSchema Capability:\n  - Path: fieldMetadata[].unique\n    Category: validation\n    Kind: boolean\n    Description: Valida unicidade no backend.\n\nSchema Capability:\n  - Path: fieldMetadata[].readOnly\n    Category: behavior\n    Kind: boolean\n    Description: Campo somente leitura.\n\nSchema Capability:\n  - Path: fieldMetadata[].disabled\n    Category: behavior\n    Kind: boolean\n    Description: Campo desabilitado.\n\nSchema Capability:\n  - Path: fieldMetadata[].defaultValue\n    Category: data\n    Kind: object\n    Description: Valor inicial do campo.\n\nSchema Capability:\n  - Path: fieldMetadata[].ariaLabel\n    Category: accessibility\n    Kind: string\n    Description: Label para leitores de tela.\n\nSchema Capability:\n  - Path: fieldMetadata[].ariaDescribedBy\n    Category: accessibility\n    Kind: string\n    Description: IDs de descrição acessível.\n\nSchema Capability:\n  - Path: fieldMetadata[].tabIndex\n    Category: accessibility\n    Kind: number\n    Description: Ordem de tabulacao para teclado.\n\nSchema Capability:\n  - Path: fieldMetadata[].accessKey\n    Category: accessibility\n    Kind: string\n    Description: Atalho de teclado (accessKey).\n\nComponent Capability:\n  - Path: inputs.resourcePath\n    Category: inputs\n    Kind: string\n    Description: Caminho do recurso para carregar/salvar dados via CRUD.\n\nComponent Capability:\n  - Path: inputs.resourceId\n    Category: inputs\n    Kind: string\n    Description: ID do registro atual (string ou number).\n\nComponent Capability:\n  - Path: inputs.initialValue\n    Category: inputs\n    Kind: object\n    Description: Valores iniciais locais para campos host-authored ou complementares.\n\nComponent Capability:\n  - Path: inputs.mode\n    Category: inputs\n    Kind: enum\n    Description: Modo do formulario (create/edit/view).\n\nComponent Capability:\n  - Path: inputs.config\n    Category: inputs\n    Kind: object\n    Description: Configuracao completa do formulario (FormConfig).\n\nComponent Capability:\n  - Path: inputs.schemaSource\n    Category: inputs\n    Kind: enum\n    Description: Fonte de schema para construcao automatica (resource/filter).\n\nComponent Capability:\n  - Path: inputs.schemaUrl\n    Category: inputs\n    Kind: string\n    Description: Schema canonico explicito publicado pelo backend para hosts que seguem surfaces/actions/capabilities.\n\nComponent Capability:\n  - Path: inputs.readUrl\n    Category: inputs\n    Kind: string\n    Description: Endpoint canonico de leitura publicado por surface VIEW/READ_PROJECTION para hidratar a entidade exibida.\n\nComponent Capability:\n  - Path: inputs.apiEndpointKey\n    Category: inputs\n    Kind: string\n    Description: Endpoint canonico usado para resolver schemaUrl, readUrl e submitUrl relativos em hosts destacados.\n\nComponent Capability:\n  - Path: inputs.submitUrl\n    Category: inputs\n    Kind: string\n    Description: Endpoint canonico de submit publicado por surface/action.\n\nComponent Capability:\n  - Path: inputs.submitMethod\n    Category: inputs\n    Kind: enum\n    Description: Metodo HTTP canonico para o submit quando o backend publica operacao explicita.\n\nComponent Capability:\n  - Path: inputs.submitIdempotencyKey\n    Category: inputs\n    Kind: string\n    Description: Identidade estavel da tentativa de comando, materializada a partir da politica execution da action.\n\nComponent Capability:\n  - Path: inputs.submitCorrelationId\n    Category: inputs\n    Kind: string\n    Description: Identificador de correlacao governado para rastreabilidade ponta a ponta do comando.\n\nComponent Capability:\n  - Path: inputs.submitResourceVersion\n    Category: inputs\n    Kind: string\n    Description: Versao persistida esperada, transportada como If-Match quando exigida pela action.\n\nComponent Capability:\n  - Path: inputs.responseSchemaUrl\n    Category: inputs\n    Kind: string\n    Description: Schema de resposta publicado pelo backend para inspeção diagnostica/read-only do host.\n\nComponent Capability:\n  - Path: inputs.enableCustomization\n    Category: inputs\n    Kind: boolean\n    Description: Habilita a edicao de layout/configuracao no editor.\n\nComponent Capability:\n  - Path: inputs.showAiAssistant\n    Category: inputs\n    Kind: boolean\n    Description: Mostra os gatilhos do copiloto semantico Praxis para a instancia do formulario.\n\nComponent Capability:\n  - Path: inputs.formId\n    Category: inputs\n    Kind: string\n    Description: ID persistente para salvar configuracoes e preferencias.\n\nComponent Capability:\n  - Path: inputs.editorialContext\n    Category: inputs\n    Kind: object\n    Description: Override de contexto editorial fornecido pelo host para os blocos hospedados antes/depois do formulario.\n\nComponent Capability:\n  - Path: inputs.layout\n    Category: inputs\n    Kind: object\n    Description: Layout legado (FormLayout). Preferir inputs.config + sections.\n\nComponent Capability:\n  - Path: inputs.generatedLayoutPreset\n    Category: inputs\n    Kind: enum\n    Description: Preset usado somente na criacao inicial de FormConfig a partir de schema/metadata.\n\nComponent Capability:\n  - Path: inputs.configPersistenceStrategy\n    Category: inputs\n    Kind: enum\n    Description: Define se preferências locais persistidas ou o contrato explícito do host governam a materialização corrente.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy\n    Category: inputs\n    Kind: object\n    Description: Politica opt-in para materializar layout diretamente do schema atual sem depender de FormConfig.sections authoradas.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.source\n    Category: inputs\n    Kind: enum\n    Description: Define se o layout vem de configuracao authorada ou do schema.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.preset\n    Category: inputs\n    Kind: enum\n    Description: Preset de layout schema-driven. compactPresentation cobre detalhe read-only; groupedCommand cobre create/edit.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.intent\n    Category: inputs\n    Kind: enum\n    Description: Intencao da surface: detalhe/apresentacao ou comando/editavel.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.lifecycle\n    Category: inputs\n    Kind: enum\n    Description: Ciclo de materializacao do layout schema-driven.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.persistence\n    Category: inputs\n    Kind: enum\n    Description: Define se sections geradas sao transient ou podem virar layout authorado apos detach explicito.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.groupedCommand.orphanFieldExpansion\n    Category: inputs\n    Kind: enum\n    Description: Define como uma linha groupedCommand com um unico campo usa o espaco restante. O default medium-and-wide expande spans 6 ou 8 e preserva campos compactos.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.groupedCommand.contextFields\n    Category: inputs\n    Kind: array\n    Description: Campos canônicos do request cujo valor vem do contexto da surface. Eles permanecem no FormGroup e no payload, sem renderizar controles redundantes.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.detailSummary\n    Category: inputs\n    Kind: object\n    Description: Politica declarativa para resumo read-only compacto em compactPresentation, sem FormConfig.sections locais.",
           "sourcePointer": "projects/praxis-dynamic-form/src/lib/ai/form-component-ai-capabilities.ts",
-          "contentHash": "bb295439e01a4a20747d806c34a704434451095f624a73bf00f2dd1b895e9296",
+          "contentHash": "c0a08ef89a122e2e5ec62606017281c689a4e7e35662112e4ea5c00dbd4e3055",
           "sourceKind": "component_definition",
           "sourceId": "praxis-dynamic-form",
           "corpusVersion": "1.0.0"
@@ -8830,9 +8837,9 @@
         {
           "chunkIndex": 11,
           "chunkKind": "capabilities",
-          "content": "Component Capability:\n  - Path: inputs.layoutPolicy.detailSummary.excludeFields\n    Category: inputs\n    Kind: array\n    Description: Lista de campos canônicos do schema que devem ficar fora do resumo read-only compacto.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.detailSummary.includeGroups\n    Category: inputs\n    Kind: array\n    Description: Lista de grupos do schema que devem entrar no resumo read-only compacto.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.detailSummary.excludeGroups\n    Category: inputs\n    Kind: array\n    Description: Lista de grupos do schema que devem ficar fora do resumo read-only compacto.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.detailSummary.includeRoles\n    Category: inputs\n    Kind: array\n    Description: Lista de papeis semanticos de campo que devem entrar no resumo read-only compacto.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.detailSummary.excludeRoles\n    Category: inputs\n    Kind: array\n    Description: Lista de papeis semanticos de campo que devem ficar fora do resumo read-only compacto.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.detailSummary.maxFields\n    Category: inputs\n    Kind: number\n    Description: Limite maximo de campos materializados no primeiro painel compacto.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.detailSummary.fieldPriority\n    Category: inputs\n    Kind: object\n    Description: Mapa campo -> prioridade para ordenar campos do resumo quando o schema publica candidatos suficientes.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.detailSummary.groupPriority\n    Category: inputs\n    Kind: object\n    Description: Mapa grupo -> prioridade para ordenar grupos do resumo quando o schema publica agrupamento semantico.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.detailSummary.columns\n    Category: inputs\n    Kind: number\n    Description: Quantidade base de colunas para distribuir campos de resumo schema-driven sem criar FormConfig.sections locais.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.detailSummary.responsiveColumns\n    Category: inputs\n    Kind: object\n    Description: Mapa de colunas por breakpoint xs/sm/md/lg/xl para detalhes read-only compactos em drawers, side sheets e desktop largo.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.detailSummary.widthPrecedence\n    Category: inputs\n    Kind: enum\n    Description: Define se larguras explicitas do schema ou a densidade do resumo controlam os spans no compactPresentation read-only.\n\nComponent Capability:\n  - Path: inputs.fieldIconPolicy\n    Category: inputs\n    Kind: enum\n    Description: Controla se icones prefix/suffix dos metadados aparecem em todos os modos, apenas apresentacao, ou nunca.\n\nComponent Capability:\n  - Path: inputs.backConfig\n    Category: inputs\n    Kind: object\n    Description: Configuracao de navegacao/retorno (BackConfig).\n\nComponent Capability:\n  - Path: inputs.backConfig.strategy\n    Category: inputs\n    Kind: enum\n    Description: Estrategia de retorno (auto/close/navigate).\n\nComponent Capability:\n  - Path: inputs.backConfig.returnTo\n    Category: inputs\n    Kind: string\n    Description: Rota para retornar quando strategy=navigate.\n\nComponent Capability:\n  - Path: inputs.backConfig.confirmOnDirty\n    Category: inputs\n    Kind: boolean\n    Description: Solicita confirmacao ao sair com mudancas nao salvas.\n\nComponent Capability:\n  - Path: inputs.hooks\n    Category: inputs\n    Kind: object\n    Description: Declaracoes de hooks fornecidas diretamente ao componente.\n\nComponent Capability:\n  - Path: inputs.hooks.beforeInit[]\n    Category: hooks\n    Kind: array\n    Description: Hooks executados antes da inicializacao.\n\nComponent Capability:\n  - Path: inputs.hooks.afterInit[]\n    Category: hooks\n    Kind: array\n    Description: Hooks executados apos a inicializacao.\n\nComponent Capability:\n  - Path: inputs.hooks.beforeValidate[]\n    Category: hooks\n    Kind: array\n    Description: Hooks executados antes da validacao.\n\nComponent Capability:\n  - Path: inputs.hooks.afterValidate[]\n    Category: hooks\n    Kind: array\n    Description: Hooks executados apos a validacao.\n\nComponent Capability:\n  - Path: inputs.hooks.beforeSubmit[]\n    Category: hooks\n    Kind: array\n    Description: Hooks executados antes do submit.\n\nComponent Capability:\n  - Path: inputs.hooks.afterSubmit[]\n    Category: hooks\n    Kind: array\n    Description: Hooks executados apos o submit.\n\nComponent Capability:\n  - Path: inputs.hooks.onError[]\n    Category: hooks\n    Kind: array\n    Description: Hooks executados em erros de submit/validacao.\n\nComponent Capability:\n  - Path: inputs.removeEmptyContainersOnSave\n    Category: inputs\n    Kind: boolean\n    Description: Remove containers vazios ao salvar configuracao.\n\nComponent Capability:\n  - Path: inputs.reactiveValidation\n    Category: inputs\n    Kind: boolean\n    Description: Ativa validacao reativa (afterValidate em valueChanges).\n\nComponent Capability:\n  - Path: inputs.reactiveValidationDebounceMs\n    Category: inputs\n    Kind: number\n    Description: Debounce em ms para validacao reativa.\n\nComponent Capability:\n  - Path: inputs.notifyIfOutdated\n    Category: inputs\n    Kind: enum\n    Description: Canal de notificacao para schema desatualizado.\n\nComponent Capability:\n  - Path: inputs.snoozeMs\n    Category: inputs\n    Kind: number\n    Description: Duracao do snooze para alertas de schema.\n\nComponent Capability:\n  - Path: inputs.autoOpenSettingsOnOutdated\n    Category: inputs\n    Kind: boolean\n    Description: Abre automaticamente o editor ao detectar schema desatualizado.\n\nComponent Capability:\n  - Path: inputs.readonlyModeGlobal\n    Category: inputs\n    Kind: boolean\n    Description: Forca modo somente leitura global.\n\nComponent Capability:\n  - Path: inputs.disabledModeGlobal\n    Category: inputs\n    Kind: boolean\n    Description: Forca modo desabilitado global.\n\nComponent Capability:\n  - Path: inputs.presentationModeGlobal\n    Category: inputs\n    Kind: boolean\n    Description: Ativa modo de apresentacao global (somente view).\n\nComponent Capability:\n  - Path: inputs.visibleGlobal\n    Category: inputs\n    Kind: boolean\n    Description: Forca visibilidade global dos campos.\n\nComponent Capability:\n  - Path: inputs.customEndpoints\n    Category: inputs\n    Kind: object\n    Description: Override de endpoints CRUD (EndpointConfig).\n\nComponent Capability:\n  - Path: inputs.customEndpoints.getAll\n    Category: inputs\n    Kind: string\n    Description: Endpoint customizado para listar registros.\n\nComponent Capability:\n  - Path: inputs.customEndpoints.getById\n    Category: inputs\n    Kind: string\n    Description: Endpoint customizado para obter registro por ID.\n\nComponent Capability:\n  - Path: inputs.customEndpoints.create\n    Category: inputs\n    Kind: string\n    Description: Endpoint customizado para criar registro.\n\nComponent Capability:\n  - Path: inputs.customEndpoints.update\n    Category: inputs\n    Kind: string\n    Description: Endpoint customizado para atualizar registro.\n\nComponent Capability:\n  - Path: inputs.customEndpoints.delete\n    Category: inputs\n    Kind: string\n    Description: Endpoint customizado para deletar registro.\n\nComponent Capability:\n  - Path: inputs.customEndpoints.filter\n    Category: inputs\n    Kind: string\n    Description: Endpoint customizado para filtro.\n\nComponent Capability:\n  - Path: inputs.customEndpoints.schema\n    Category: inputs\n    Kind: string\n    Description: Endpoint customizado para schemas.\n\nComponent Capability:\n  - Path: inputs.config.presentation\n    Category: appearance\n    Kind: object\n    Description: Preferencias visuais persistidas no config.\n\nComponent Capability:\n  - Path: inputs.config.presentation.labelFontSize\n    Category: appearance\n    Kind: number\n    Description: Tamanho da fonte do label (px).\n\nComponent Capability:\n  - Path: inputs.config.presentation.valueFontSize\n    Category: appearance\n    Kind: number\n    Description: Tamanho da fonte do valor (px).",
+          "content": "Component Capability:\n  - Path: inputs.layoutPolicy.detailSummary.includeFields\n    Category: inputs\n    Kind: array\n    Description: Lista de campos canônicos do schema que devem entrar no resumo read-only compacto.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.detailSummary.excludeFields\n    Category: inputs\n    Kind: array\n    Description: Lista de campos canônicos do schema que devem ficar fora do resumo read-only compacto.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.detailSummary.includeGroups\n    Category: inputs\n    Kind: array\n    Description: Lista de grupos do schema que devem entrar no resumo read-only compacto.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.detailSummary.excludeGroups\n    Category: inputs\n    Kind: array\n    Description: Lista de grupos do schema que devem ficar fora do resumo read-only compacto.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.detailSummary.includeRoles\n    Category: inputs\n    Kind: array\n    Description: Lista de papeis semanticos de campo que devem entrar no resumo read-only compacto.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.detailSummary.excludeRoles\n    Category: inputs\n    Kind: array\n    Description: Lista de papeis semanticos de campo que devem ficar fora do resumo read-only compacto.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.detailSummary.maxFields\n    Category: inputs\n    Kind: number\n    Description: Limite maximo de campos materializados no primeiro painel compacto.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.detailSummary.fieldPriority\n    Category: inputs\n    Kind: object\n    Description: Mapa campo -> prioridade para ordenar campos do resumo quando o schema publica candidatos suficientes.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.detailSummary.groupPriority\n    Category: inputs\n    Kind: object\n    Description: Mapa grupo -> prioridade para ordenar grupos do resumo quando o schema publica agrupamento semantico.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.detailSummary.columns\n    Category: inputs\n    Kind: number\n    Description: Quantidade base de colunas para distribuir campos de resumo schema-driven sem criar FormConfig.sections locais.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.detailSummary.responsiveColumns\n    Category: inputs\n    Kind: object\n    Description: Mapa de colunas por breakpoint xs/sm/md/lg/xl para detalhes read-only compactos em drawers, side sheets e desktop largo.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.detailSummary.widthPrecedence\n    Category: inputs\n    Kind: enum\n    Description: Define se larguras explicitas do schema ou a densidade do resumo controlam os spans no compactPresentation read-only.\n\nComponent Capability:\n  - Path: inputs.fieldIconPolicy\n    Category: inputs\n    Kind: enum\n    Description: Controla se icones prefix/suffix dos metadados aparecem em todos os modos, apenas apresentacao, ou nunca.\n\nComponent Capability:\n  - Path: inputs.backConfig\n    Category: inputs\n    Kind: object\n    Description: Configuracao de navegacao/retorno (BackConfig).\n\nComponent Capability:\n  - Path: inputs.backConfig.strategy\n    Category: inputs\n    Kind: enum\n    Description: Estrategia de retorno (auto/close/navigate).\n\nComponent Capability:\n  - Path: inputs.backConfig.returnTo\n    Category: inputs\n    Kind: string\n    Description: Rota para retornar quando strategy=navigate.\n\nComponent Capability:\n  - Path: inputs.backConfig.confirmOnDirty\n    Category: inputs\n    Kind: boolean\n    Description: Solicita confirmacao ao sair com mudancas nao salvas.\n\nComponent Capability:\n  - Path: inputs.hooks\n    Category: inputs\n    Kind: object\n    Description: Declaracoes de hooks fornecidas diretamente ao componente.\n\nComponent Capability:\n  - Path: inputs.hooks.beforeInit[]\n    Category: hooks\n    Kind: array\n    Description: Hooks executados antes da inicializacao.\n\nComponent Capability:\n  - Path: inputs.hooks.afterInit[]\n    Category: hooks\n    Kind: array\n    Description: Hooks executados apos a inicializacao.\n\nComponent Capability:\n  - Path: inputs.hooks.beforeValidate[]\n    Category: hooks\n    Kind: array\n    Description: Hooks executados antes da validacao.\n\nComponent Capability:\n  - Path: inputs.hooks.afterValidate[]\n    Category: hooks\n    Kind: array\n    Description: Hooks executados apos a validacao.\n\nComponent Capability:\n  - Path: inputs.hooks.beforeSubmit[]\n    Category: hooks\n    Kind: array\n    Description: Hooks executados antes do submit.\n\nComponent Capability:\n  - Path: inputs.hooks.afterSubmit[]\n    Category: hooks\n    Kind: array\n    Description: Hooks executados apos o submit.\n\nComponent Capability:\n  - Path: inputs.hooks.onError[]\n    Category: hooks\n    Kind: array\n    Description: Hooks executados em erros de submit/validacao.\n\nComponent Capability:\n  - Path: inputs.removeEmptyContainersOnSave\n    Category: inputs\n    Kind: boolean\n    Description: Remove containers vazios ao salvar configuracao.\n\nComponent Capability:\n  - Path: inputs.reactiveValidation\n    Category: inputs\n    Kind: boolean\n    Description: Ativa validacao reativa (afterValidate em valueChanges).\n\nComponent Capability:\n  - Path: inputs.reactiveValidationDebounceMs\n    Category: inputs\n    Kind: number\n    Description: Debounce em ms para validacao reativa.\n\nComponent Capability:\n  - Path: inputs.notifyIfOutdated\n    Category: inputs\n    Kind: enum\n    Description: Canal de notificacao para schema desatualizado.\n\nComponent Capability:\n  - Path: inputs.snoozeMs\n    Category: inputs\n    Kind: number\n    Description: Duracao do snooze para alertas de schema.\n\nComponent Capability:\n  - Path: inputs.autoOpenSettingsOnOutdated\n    Category: inputs\n    Kind: boolean\n    Description: Abre automaticamente o editor ao detectar schema desatualizado.\n\nComponent Capability:\n  - Path: inputs.readonlyModeGlobal\n    Category: inputs\n    Kind: boolean\n    Description: Forca modo somente leitura global.\n\nComponent Capability:\n  - Path: inputs.disabledModeGlobal\n    Category: inputs\n    Kind: boolean\n    Description: Forca modo desabilitado global.\n\nComponent Capability:\n  - Path: inputs.presentationModeGlobal\n    Category: inputs\n    Kind: boolean\n    Description: Ativa modo de apresentacao global (somente view).\n\nComponent Capability:\n  - Path: inputs.visibleGlobal\n    Category: inputs\n    Kind: boolean\n    Description: Forca visibilidade global dos campos.\n\nComponent Capability:\n  - Path: inputs.customEndpoints\n    Category: inputs\n    Kind: object\n    Description: Override de endpoints CRUD (EndpointConfig).\n\nComponent Capability:\n  - Path: inputs.customEndpoints.getAll\n    Category: inputs\n    Kind: string\n    Description: Endpoint customizado para listar registros.\n\nComponent Capability:\n  - Path: inputs.customEndpoints.getById\n    Category: inputs\n    Kind: string\n    Description: Endpoint customizado para obter registro por ID.\n\nComponent Capability:\n  - Path: inputs.customEndpoints.create\n    Category: inputs\n    Kind: string\n    Description: Endpoint customizado para criar registro.\n\nComponent Capability:\n  - Path: inputs.customEndpoints.update\n    Category: inputs\n    Kind: string\n    Description: Endpoint customizado para atualizar registro.\n\nComponent Capability:\n  - Path: inputs.customEndpoints.delete\n    Category: inputs\n    Kind: string\n    Description: Endpoint customizado para deletar registro.\n\nComponent Capability:\n  - Path: inputs.customEndpoints.filter\n    Category: inputs\n    Kind: string\n    Description: Endpoint customizado para filtro.\n\nComponent Capability:\n  - Path: inputs.customEndpoints.schema\n    Category: inputs\n    Kind: string\n    Description: Endpoint customizado para schemas.\n\nComponent Capability:\n  - Path: inputs.config.presentation\n    Category: appearance\n    Kind: object\n    Description: Preferencias visuais persistidas no config.",
           "sourcePointer": "projects/praxis-dynamic-form/src/lib/ai/form-component-ai-capabilities.ts",
-          "contentHash": "78a041a9cb19a1b4b862f0db355c8b86cd83968592ad3ed3d709fe3207c80690",
+          "contentHash": "e04d360e46c5cf6d9856c9b55a6f140cc7a2fa07a670575bfe1319fd5079b158",
           "sourceKind": "component_definition",
           "sourceId": "praxis-dynamic-form",
           "corpusVersion": "1.0.0"
@@ -8840,9 +8847,9 @@
         {
           "chunkIndex": 12,
           "chunkKind": "capabilities",
-          "content": "Component Capability:\n  - Path: inputs.config.presentation.labelPosition\n    Category: appearance\n    Kind: enum\n    Description: Posicionamento do label (above/left).\n\nComponent Capability:\n  - Path: inputs.config.presentation.compact\n    Category: appearance\n    Kind: boolean\n    Description: Modo compacto de apresentacao.\n\nComponent Capability:\n  - Path: inputs.config.presentation.density\n    Category: appearance\n    Kind: enum\n    Description: Densidade visual global.\n\nComponent Capability:\n  - Path: inputs.config.presentation.labelWidth\n    Category: appearance\n    Kind: number\n    Description: Largura do label (px).\n\nComponent Capability:\n  - Path: inputs.config.presentation.labelAlign\n    Category: appearance\n    Kind: enum\n    Description: Alinhamento do label.\n\nComponent Capability:\n  - Path: inputs.config.presentation.valueAlign\n    Category: appearance\n    Kind: enum\n    Description: Alinhamento do valor.\n\nComponent Capability:\n  - Path: outputs.formSubmit\n    Category: outputs\n    Kind: object\n    Description: Evento emitido no submit do formulario.\n\nComponent Capability:\n  - Path: outputs.formCancel\n    Category: outputs\n    Kind: object\n    Description: Evento emitido ao cancelar.\n\nComponent Capability:\n  - Path: outputs.formReset\n    Category: outputs\n    Kind: object\n    Description: Evento emitido ao resetar o formulario.\n\nComponent Capability:\n  - Path: outputs.configChange\n    Category: outputs\n    Kind: object\n    Description: Evento emitido quando a configuracao muda.\n\nComponent Capability:\n  - Path: outputs.formReady\n    Category: outputs\n    Kind: object\n    Description: Evento emitido quando o formulario esta pronto.\n\nComponent Capability:\n  - Path: outputs.valueChange\n    Category: outputs\n    Kind: object\n    Description: Evento emitido quando o valor do formulario muda.\n\nComponent Capability:\n  - Path: outputs.syncCompleted\n    Category: outputs\n    Kind: object\n    Description: Evento emitido ao completar sincronizacao com schema.\n\nComponent Capability:\n  - Path: outputs.initializationError\n    Category: outputs\n    Kind: object\n    Description: Evento emitido quando ocorre erro na inicializacao.\n\nComponent Capability:\n  - Path: outputs.enableCustomizationChange\n    Category: outputs\n    Kind: object\n    Description: Evento emitido quando o modo de customizacao muda.\n\nComponent Capability:\n  - Path: outputs.customAction\n    Category: outputs\n    Kind: object\n    Description: Evento emitido ao disparar acao customizada.\n\nComponent Capability:\n  - Path: outputs.actionConfirmation\n    Category: outputs\n    Kind: object\n    Description: Evento emitido quando acao requer confirmacao.\n\nComponent Capability:\n  - Path: outputs.schemaStatusChange\n    Category: outputs\n    Kind: object\n    Description: Evento emitido quando o status do schema muda.\n\nCapability Note:\n  - Este catalogo descreve inputs e outputs do componente.\n\nCapability Note:\n  - O objeto inputs.config segue o schema de FormConfig (veja form-ai-capabilities).\n\nCapability Note:\n  - inputs.config.presentation e uma extensao de runtime aplicada pelo componente.\n\nCapability Note:\n  - Preferir FormConfig (sections/fieldMetadata) em vez do layout legado (fieldsets).\n\nCapability Note:\n  - Use inputs.editorialContext apenas para override de contexto editorial do host; a precedencia final e runtime < config.editorialContext < host.\n\nCapability Note:\n  - rich content editorial hospedado pelo form pode ser renderizado em tres slots semanticos: before, beforeActions e after.",
+          "content": "Component Capability:\n  - Path: inputs.config.presentation.labelFontSize\n    Category: appearance\n    Kind: number\n    Description: Tamanho da fonte do label (px).\n\nComponent Capability:\n  - Path: inputs.config.presentation.valueFontSize\n    Category: appearance\n    Kind: number\n    Description: Tamanho da fonte do valor (px).\n\nComponent Capability:\n  - Path: inputs.config.presentation.labelPosition\n    Category: appearance\n    Kind: enum\n    Description: Posicionamento do label (above/left).\n\nComponent Capability:\n  - Path: inputs.config.presentation.compact\n    Category: appearance\n    Kind: boolean\n    Description: Modo compacto de apresentacao.\n\nComponent Capability:\n  - Path: inputs.config.presentation.density\n    Category: appearance\n    Kind: enum\n    Description: Densidade visual global.\n\nComponent Capability:\n  - Path: inputs.config.presentation.labelWidth\n    Category: appearance\n    Kind: number\n    Description: Largura do label (px).\n\nComponent Capability:\n  - Path: inputs.config.presentation.labelAlign\n    Category: appearance\n    Kind: enum\n    Description: Alinhamento do label.\n\nComponent Capability:\n  - Path: inputs.config.presentation.valueAlign\n    Category: appearance\n    Kind: enum\n    Description: Alinhamento do valor.\n\nComponent Capability:\n  - Path: outputs.formSubmit\n    Category: outputs\n    Kind: object\n    Description: Evento emitido no submit do formulario.\n\nComponent Capability:\n  - Path: outputs.formCancel\n    Category: outputs\n    Kind: object\n    Description: Evento emitido ao cancelar.\n\nComponent Capability:\n  - Path: outputs.formReset\n    Category: outputs\n    Kind: object\n    Description: Evento emitido ao resetar o formulario.\n\nComponent Capability:\n  - Path: outputs.configChange\n    Category: outputs\n    Kind: object\n    Description: Evento emitido quando a configuracao muda.\n\nComponent Capability:\n  - Path: outputs.formReady\n    Category: outputs\n    Kind: object\n    Description: Evento emitido quando o formulario esta pronto.\n\nComponent Capability:\n  - Path: outputs.valueChange\n    Category: outputs\n    Kind: object\n    Description: Evento emitido quando o valor do formulario muda.\n\nComponent Capability:\n  - Path: outputs.syncCompleted\n    Category: outputs\n    Kind: object\n    Description: Evento emitido ao completar sincronizacao com schema.\n\nComponent Capability:\n  - Path: outputs.initializationError\n    Category: outputs\n    Kind: object\n    Description: Evento emitido quando ocorre erro na inicializacao.\n\nComponent Capability:\n  - Path: outputs.enableCustomizationChange\n    Category: outputs\n    Kind: object\n    Description: Evento emitido quando o modo de customizacao muda.\n\nComponent Capability:\n  - Path: outputs.customAction\n    Category: outputs\n    Kind: object\n    Description: Evento emitido ao disparar acao customizada.\n\nComponent Capability:\n  - Path: outputs.actionConfirmation\n    Category: outputs\n    Kind: object\n    Description: Evento emitido quando acao requer confirmacao.\n\nComponent Capability:\n  - Path: outputs.schemaStatusChange\n    Category: outputs\n    Kind: object\n    Description: Evento emitido quando o status do schema muda.\n\nCapability Note:\n  - Este catalogo descreve inputs e outputs do componente.\n\nCapability Note:\n  - O objeto inputs.config segue o schema de FormConfig (veja form-ai-capabilities).\n\nCapability Note:\n  - inputs.config.presentation e uma extensao de runtime aplicada pelo componente.\n\nCapability Note:\n  - Preferir FormConfig (sections/fieldMetadata) em vez do layout legado (fieldsets).\n\nCapability Note:\n  - Use inputs.editorialContext apenas para override de contexto editorial do host; a precedencia final e runtime < config.editorialContext < host.\n\nCapability Note:\n  - rich content editorial hospedado pelo form pode ser renderizado em tres slots semanticos: before, beforeActions e after.",
           "sourcePointer": "projects/praxis-dynamic-form/src/lib/ai/form-component-ai-capabilities.ts",
-          "contentHash": "64e6c04239b6f490007be4f04318d66f2e918861b1474d2fe4f32380444efa2d",
+          "contentHash": "beda7b0e56767eb05d2104f64b078e5d582354da389421f4cc5db0853bf87a2a",
           "sourceKind": "component_definition",
           "sourceId": "praxis-dynamic-form",
           "corpusVersion": "1.0.0"
@@ -9140,9 +9147,9 @@
         {
           "chunkIndex": 42,
           "chunkKind": "authoring_manifest",
-          "content": "{\"schemaVersion\":\"1.0.0\",\"manifestVersion\":\"1.5.1\",\"componentId\":\"praxis-dynamic-form\",\"ownerPackage\":\"@praxisui/dynamic-form\",\"configSchemaId\":\"FormConfig\",\"chunkSection\":\"runtimeInputs\",\"runtimeInputs\":[{\"name\":\"showAiAssistant\",\"type\":\"boolean\",\"description\":\"Mostra os gatilhos do copiloto semantico Praxis\"},{\"name\":\"config\",\"type\":\"FormConfig\",\"description\":\"Configuração do formulário; sections é opcional em forms schema-driven e não deve ser criado como array vazio apenas para satisfazer TypeScript.\"},{\"name\":\"resourcePath\",\"type\":\"string\",\"description\":\"Caminho do recurso (API)\"},{\"name\":\"readUrl\",\"type\":\"string\",\"description\":\"Endpoint canonico de leitura para surfaces VIEW/READ_PROJECTION\"},{\"name\":\"mode\",\"type\":\"string\",\"allowedValues\":[\"create\",\"edit\",\"view\"],\"description\":\"Modo de operação\"},{\"name\":\"configPersistenceStrategy\",\"type\":\"string\",\"allowedValues\":[\"local-first\",\"input-first\"],\"description\":\"Precedência entre configuração persistida e contrato explícito do host. Use input-first em dialogs e surfaces transitórias governadas por schema para preservar mode e estados operacionais publicados pelo servidor.\"},{\"name\":\"generatedLayoutPreset\",\"type\":\"string\",\"allowedValues\":[\"default\",\"compactPresentation\"],\"description\":\"Preset usado apenas ao gerar a configuracao inicial a partir de metadata/schema; nao reprocessa layouts persistidos ou autorados.\"},{\"name\":\"layoutPolicy\",\"type\":\"DynamicFormLayoutPolicy\",\"description\":\"Politica opt-in para layout schema-driven transient. Use source=schema apenas quando o backend schema for a fonte canonica do agrupamento; use detailSummary para seleção de campos e densidade responsiva do resumo read-only compacto sem FormConfig.sections locais. Quando o resumo precisar vencer x-ui.width publicado para outras surfaces, use detailSummary.widthPrecedence=summary. Em groupedCommand, orphanFieldExpansion governa linhas com um unico campo; medium-and-wide e o default corporativo.\"},{\"name\":\"fieldIconPolicy\",\"type\":\"string\",\"allowedValues\":[\"all\",\"presentation-only\",\"none\"],\"description\":\"Politica visual do host para icones prefix/suffix de campos vindos da metadata. Use presentation-only para manter icones decorativos em apresentacao e ocultar em controles tradicionais.\"},{\"name\":\"enableCustomization\",\"type\":\"boolean\",\"description\":\"Habilita edição visual\"}]}",
+          "content": "{\"schemaVersion\":\"1.0.0\",\"manifestVersion\":\"1.5.1\",\"componentId\":\"praxis-dynamic-form\",\"ownerPackage\":\"@praxisui/dynamic-form\",\"configSchemaId\":\"FormConfig\",\"chunkSection\":\"runtimeInputs\",\"runtimeInputs\":[{\"name\":\"showAiAssistant\",\"type\":\"boolean\",\"description\":\"Mostra os gatilhos do copiloto semantico Praxis\"},{\"name\":\"config\",\"type\":\"FormConfig\",\"description\":\"Configuração do formulário; sections é opcional em forms schema-driven e não deve ser criado como array vazio apenas para satisfazer TypeScript.\"},{\"name\":\"resourcePath\",\"type\":\"string\",\"description\":\"Caminho do recurso (API)\"},{\"name\":\"readUrl\",\"type\":\"string\",\"description\":\"Endpoint canonico de leitura para surfaces VIEW/READ_PROJECTION\"},{\"name\":\"mode\",\"type\":\"string\",\"allowedValues\":[\"create\",\"edit\",\"view\"],\"description\":\"Modo de operação\"},{\"name\":\"configPersistenceStrategy\",\"type\":\"string\",\"allowedValues\":[\"local-first\",\"input-first\"],\"description\":\"Precedência entre configuração persistida e contrato explícito do host. Use input-first em dialogs e surfaces transitórias governadas por schema para preservar mode e estados operacionais publicados pelo servidor.\"},{\"name\":\"generatedLayoutPreset\",\"type\":\"string\",\"allowedValues\":[\"default\",\"compactPresentation\"],\"description\":\"Preset usado apenas ao gerar a configuracao inicial a partir de metadata/schema; nao reprocessa layouts persistidos ou autorados.\"},{\"name\":\"layoutPolicy\",\"type\":\"DynamicFormLayoutPolicy\",\"description\":\"Politica opt-in para layout schema-driven transient. Use source=schema apenas quando o backend schema for a fonte canonica do agrupamento; use detailSummary para seleção de campos e densidade responsiva do resumo read-only compacto sem FormConfig.sections locais. Quando o resumo precisar vencer x-ui.width publicado para outras surfaces, use detailSummary.widthPrecedence=summary. Em groupedCommand, orphanFieldExpansion governa linhas com um unico campo; contextFields identifica campos do request hidratados pela surface que permanecem no payload sem criar controles redundantes.\"},{\"name\":\"fieldIconPolicy\",\"type\":\"string\",\"allowedValues\":[\"all\",\"presentation-only\",\"none\"],\"description\":\"Politica visual do host para icones prefix/suffix de campos vindos da metadata. Use presentation-only para manter icones decorativos em apresentacao e ocultar em controles tradicionais.\"},{\"name\":\"enableCustomization\",\"type\":\"boolean\",\"description\":\"Habilita edição visual\"}]}",
           "sourcePointer": "projects/praxis-dynamic-form/src/lib/ai/praxis-dynamic-form-authoring-manifest.ts",
-          "contentHash": "e21b7fed0eaad0561819d0cbde2e8dfa9014055b76b69408145cf6a7756c2fd4",
+          "contentHash": "4a45e150cfc13e1e71c8e0d59c4ffb1201a6a4e8e72cb3ded66ab2ace7cb1069",
           "sourceKind": "component_definition",
           "sourceId": "praxis-dynamic-form",
           "corpusVersion": "1.0.0"
@@ -13664,6 +13671,13 @@
           "description": "Define como uma linha groupedCommand com um unico campo usa o espaco restante. O default medium-and-wide expande spans 6 ou 8 e preserva campos compactos.",
           "safetyNotes": "Use preserve quando o espaco vazio for intencional; use all apenas quando ate campos xs/sm devam ocupar a linha completa."
         },
+        {
+          "path": "inputs.layoutPolicy.groupedCommand.contextFields",
+          "category": "inputs",
+          "valueKind": "array",
+          "description": "Campos canônicos do request cujo valor vem do contexto da surface. Eles permanecem no FormGroup e no payload, sem renderizar controles redundantes.",
+          "safetyNotes": "Use somente para campos realmente hidratados por initialValue ou leitura da entidade; nunca use para esconder dados que a pessoa ainda precisa informar."
+        },
         {
           "path": "inputs.layoutPolicy.detailSummary",
           "category": "inputs",
@@ -15651,9 +15665,9 @@
         {
           "chunkIndex": 10,
           "chunkKind": "capabilities",
-          "content": "Schema Capability:\n  - Path: fieldMetadata[].transformDisplayValue\n    Category: transform\n    Kind: expression\n    Description: Transforma valor para exibição.\n\nSchema Capability:\n  - Path: fieldMetadata[].transformSaveValue\n    Category: transform\n    Kind: expression\n    Description: Transforma valor para salvar.\n\nSchema Capability:\n  - Path: fieldMetadata[].textTransformApply\n    Category: transform\n    Kind: enum\n    Description: Quando aplicar transformação de texto.\n\nSchema Capability:\n  - Path: fieldMetadata[].inlineEditing\n    Category: behavior\n    Kind: boolean\n    Description: Permite edição inline (tabelas).\n\nSchema Capability:\n  - Path: fieldMetadata[].unique\n    Category: validation\n    Kind: boolean\n    Description: Valida unicidade no backend.\n\nSchema Capability:\n  - Path: fieldMetadata[].readOnly\n    Category: behavior\n    Kind: boolean\n    Description: Campo somente leitura.\n\nSchema Capability:\n  - Path: fieldMetadata[].disabled\n    Category: behavior\n    Kind: boolean\n    Description: Campo desabilitado.\n\nSchema Capability:\n  - Path: fieldMetadata[].defaultValue\n    Category: data\n    Kind: object\n    Description: Valor inicial do campo.\n\nSchema Capability:\n  - Path: fieldMetadata[].ariaLabel\n    Category: accessibility\n    Kind: string\n    Description: Label para leitores de tela.\n\nSchema Capability:\n  - Path: fieldMetadata[].ariaDescribedBy\n    Category: accessibility\n    Kind: string\n    Description: IDs de descrição acessível.\n\nSchema Capability:\n  - Path: fieldMetadata[].tabIndex\n    Category: accessibility\n    Kind: number\n    Description: Ordem de tabulacao para teclado.\n\nSchema Capability:\n  - Path: fieldMetadata[].accessKey\n    Category: accessibility\n    Kind: string\n    Description: Atalho de teclado (accessKey).\n\nComponent Capability:\n  - Path: inputs.resourcePath\n    Category: inputs\n    Kind: string\n    Description: Caminho do recurso para carregar/salvar dados via CRUD.\n\nComponent Capability:\n  - Path: inputs.resourceId\n    Category: inputs\n    Kind: string\n    Description: ID do registro atual (string ou number).\n\nComponent Capability:\n  - Path: inputs.initialValue\n    Category: inputs\n    Kind: object\n    Description: Valores iniciais locais para campos host-authored ou complementares.\n\nComponent Capability:\n  - Path: inputs.mode\n    Category: inputs\n    Kind: enum\n    Description: Modo do formulario (create/edit/view).\n\nComponent Capability:\n  - Path: inputs.config\n    Category: inputs\n    Kind: object\n    Description: Configuracao completa do formulario (FormConfig).\n\nComponent Capability:\n  - Path: inputs.schemaSource\n    Category: inputs\n    Kind: enum\n    Description: Fonte de schema para construcao automatica (resource/filter).\n\nComponent Capability:\n  - Path: inputs.schemaUrl\n    Category: inputs\n    Kind: string\n    Description: Schema canonico explicito publicado pelo backend para hosts que seguem surfaces/actions/capabilities.\n\nComponent Capability:\n  - Path: inputs.readUrl\n    Category: inputs\n    Kind: string\n    Description: Endpoint canonico de leitura publicado por surface VIEW/READ_PROJECTION para hidratar a entidade exibida.\n\nComponent Capability:\n  - Path: inputs.apiEndpointKey\n    Category: inputs\n    Kind: string\n    Description: Endpoint canonico usado para resolver schemaUrl, readUrl e submitUrl relativos em hosts destacados.\n\nComponent Capability:\n  - Path: inputs.submitUrl\n    Category: inputs\n    Kind: string\n    Description: Endpoint canonico de submit publicado por surface/action.\n\nComponent Capability:\n  - Path: inputs.submitMethod\n    Category: inputs\n    Kind: enum\n    Description: Metodo HTTP canonico para o submit quando o backend publica operacao explicita.\n\nComponent Capability:\n  - Path: inputs.submitIdempotencyKey\n    Category: inputs\n    Kind: string\n    Description: Identidade estavel da tentativa de comando, materializada a partir da politica execution da action.\n\nComponent Capability:\n  - Path: inputs.submitCorrelationId\n    Category: inputs\n    Kind: string\n    Description: Identificador de correlacao governado para rastreabilidade ponta a ponta do comando.\n\nComponent Capability:\n  - Path: inputs.submitResourceVersion\n    Category: inputs\n    Kind: string\n    Description: Versao persistida esperada, transportada como If-Match quando exigida pela action.\n\nComponent Capability:\n  - Path: inputs.responseSchemaUrl\n    Category: inputs\n    Kind: string\n    Description: Schema de resposta publicado pelo backend para inspeção diagnostica/read-only do host.\n\nComponent Capability:\n  - Path: inputs.enableCustomization\n    Category: inputs\n    Kind: boolean\n    Description: Habilita a edicao de layout/configuracao no editor.\n\nComponent Capability:\n  - Path: inputs.showAiAssistant\n    Category: inputs\n    Kind: boolean\n    Description: Mostra os gatilhos do copiloto semantico Praxis para a instancia do formulario.\n\nComponent Capability:\n  - Path: inputs.formId\n    Category: inputs\n    Kind: string\n    Description: ID persistente para salvar configuracoes e preferencias.\n\nComponent Capability:\n  - Path: inputs.editorialContext\n    Category: inputs\n    Kind: object\n    Description: Override de contexto editorial fornecido pelo host para os blocos hospedados antes/depois do formulario.\n\nComponent Capability:\n  - Path: inputs.layout\n    Category: inputs\n    Kind: object\n    Description: Layout legado (FormLayout). Preferir inputs.config + sections.\n\nComponent Capability:\n  - Path: inputs.generatedLayoutPreset\n    Category: inputs\n    Kind: enum\n    Description: Preset usado somente na criacao inicial de FormConfig a partir de schema/metadata.\n\nComponent Capability:\n  - Path: inputs.configPersistenceStrategy\n    Category: inputs\n    Kind: enum\n    Description: Define se preferências locais persistidas ou o contrato explícito do host governam a materialização corrente.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy\n    Category: inputs\n    Kind: object\n    Description: Politica opt-in para materializar layout diretamente do schema atual sem depender de FormConfig.sections authoradas.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.source\n    Category: inputs\n    Kind: enum\n    Description: Define se o layout vem de configuracao authorada ou do schema.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.preset\n    Category: inputs\n    Kind: enum\n    Description: Preset de layout schema-driven. compactPresentation cobre detalhe read-only; groupedCommand cobre create/edit.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.intent\n    Category: inputs\n    Kind: enum\n    Description: Intencao da surface: detalhe/apresentacao ou comando/editavel.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.lifecycle\n    Category: inputs\n    Kind: enum\n    Description: Ciclo de materializacao do layout schema-driven.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.persistence\n    Category: inputs\n    Kind: enum\n    Description: Define se sections geradas sao transient ou podem virar layout authorado apos detach explicito.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.groupedCommand.orphanFieldExpansion\n    Category: inputs\n    Kind: enum\n    Description: Define como uma linha groupedCommand com um unico campo usa o espaco restante. O default medium-and-wide expande spans 6 ou 8 e preserva campos compactos.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.detailSummary\n    Category: inputs\n    Kind: object\n    Description: Politica declarativa para resumo read-only compacto em compactPresentation, sem FormConfig.sections locais.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.detailSummary.includeFields\n    Category: inputs\n    Kind: array\n    Description: Lista de campos canônicos do schema que devem entrar no resumo read-only compacto.",
+          "content": "Schema Capability:\n  - Path: fieldMetadata[].transformDisplayValue\n    Category: transform\n    Kind: expression\n    Description: Transforma valor para exibição.\n\nSchema Capability:\n  - Path: fieldMetadata[].transformSaveValue\n    Category: transform\n    Kind: expression\n    Description: Transforma valor para salvar.\n\nSchema Capability:\n  - Path: fieldMetadata[].textTransformApply\n    Category: transform\n    Kind: enum\n    Description: Quando aplicar transformação de texto.\n\nSchema Capability:\n  - Path: fieldMetadata[].inlineEditing\n    Category: behavior\n    Kind: boolean\n    Description: Permite edição inline (tabelas).\n\nSchema Capability:\n  - Path: fieldMetadata[].unique\n    Category: validation\n    Kind: boolean\n    Description: Valida unicidade no backend.\n\nSchema Capability:\n  - Path: fieldMetadata[].readOnly\n    Category: behavior\n    Kind: boolean\n    Description: Campo somente leitura.\n\nSchema Capability:\n  - Path: fieldMetadata[].disabled\n    Category: behavior\n    Kind: boolean\n    Description: Campo desabilitado.\n\nSchema Capability:\n  - Path: fieldMetadata[].defaultValue\n    Category: data\n    Kind: object\n    Description: Valor inicial do campo.\n\nSchema Capability:\n  - Path: fieldMetadata[].ariaLabel\n    Category: accessibility\n    Kind: string\n    Description: Label para leitores de tela.\n\nSchema Capability:\n  - Path: fieldMetadata[].ariaDescribedBy\n    Category: accessibility\n    Kind: string\n    Description: IDs de descrição acessível.\n\nSchema Capability:\n  - Path: fieldMetadata[].tabIndex\n    Category: accessibility\n    Kind: number\n    Description: Ordem de tabulacao para teclado.\n\nSchema Capability:\n  - Path: fieldMetadata[].accessKey\n    Category: accessibility\n    Kind: string\n    Description: Atalho de teclado (accessKey).\n\nComponent Capability:\n  - Path: inputs.resourcePath\n    Category: inputs\n    Kind: string\n    Description: Caminho do recurso para carregar/salvar dados via CRUD.\n\nComponent Capability:\n  - Path: inputs.resourceId\n    Category: inputs\n    Kind: string\n    Description: ID do registro atual (string ou number).\n\nComponent Capability:\n  - Path: inputs.initialValue\n    Category: inputs\n    Kind: object\n    Description: Valores iniciais locais para campos host-authored ou complementares.\n\nComponent Capability:\n  - Path: inputs.mode\n    Category: inputs\n    Kind: enum\n    Description: Modo do formulario (create/edit/view).\n\nComponent Capability:\n  - Path: inputs.config\n    Category: inputs\n    Kind: object\n    Description: Configuracao completa do formulario (FormConfig).\n\nComponent Capability:\n  - Path: inputs.schemaSource\n    Category: inputs\n    Kind: enum\n    Description: Fonte de schema para construcao automatica (resource/filter).\n\nComponent Capability:\n  - Path: inputs.schemaUrl\n    Category: inputs\n    Kind: string\n    Description: Schema canonico explicito publicado pelo backend para hosts que seguem surfaces/actions/capabilities.\n\nComponent Capability:\n  - Path: inputs.readUrl\n    Category: inputs\n    Kind: string\n    Description: Endpoint canonico de leitura publicado por surface VIEW/READ_PROJECTION para hidratar a entidade exibida.\n\nComponent Capability:\n  - Path: inputs.apiEndpointKey\n    Category: inputs\n    Kind: string\n    Description: Endpoint canonico usado para resolver schemaUrl, readUrl e submitUrl relativos em hosts destacados.\n\nComponent Capability:\n  - Path: inputs.submitUrl\n    Category: inputs\n    Kind: string\n    Description: Endpoint canonico de submit publicado por surface/action.\n\nComponent Capability:\n  - Path: inputs.submitMethod\n    Category: inputs\n    Kind: enum\n    Description: Metodo HTTP canonico para o submit quando o backend publica operacao explicita.\n\nComponent Capability:\n  - Path: inputs.submitIdempotencyKey\n    Category: inputs\n    Kind: string\n    Description: Identidade estavel da tentativa de comando, materializada a partir da politica execution da action.\n\nComponent Capability:\n  - Path: inputs.submitCorrelationId\n    Category: inputs\n    Kind: string\n    Description: Identificador de correlacao governado para rastreabilidade ponta a ponta do comando.\n\nComponent Capability:\n  - Path: inputs.submitResourceVersion\n    Category: inputs\n    Kind: string\n    Description: Versao persistida esperada, transportada como If-Match quando exigida pela action.\n\nComponent Capability:\n  - Path: inputs.responseSchemaUrl\n    Category: inputs\n    Kind: string\n    Description: Schema de resposta publicado pelo backend para inspeção diagnostica/read-only do host.\n\nComponent Capability:\n  - Path: inputs.enableCustomization\n    Category: inputs\n    Kind: boolean\n    Description: Habilita a edicao de layout/configuracao no editor.\n\nComponent Capability:\n  - Path: inputs.showAiAssistant\n    Category: inputs\n    Kind: boolean\n    Description: Mostra os gatilhos do copiloto semantico Praxis para a instancia do formulario.\n\nComponent Capability:\n  - Path: inputs.formId\n    Category: inputs\n    Kind: string\n    Description: ID persistente para salvar configuracoes e preferencias.\n\nComponent Capability:\n  - Path: inputs.editorialContext\n    Category: inputs\n    Kind: object\n    Description: Override de contexto editorial fornecido pelo host para os blocos hospedados antes/depois do formulario.\n\nComponent Capability:\n  - Path: inputs.layout\n    Category: inputs\n    Kind: object\n    Description: Layout legado (FormLayout). Preferir inputs.config + sections.\n\nComponent Capability:\n  - Path: inputs.generatedLayoutPreset\n    Category: inputs\n    Kind: enum\n    Description: Preset usado somente na criacao inicial de FormConfig a partir de schema/metadata.\n\nComponent Capability:\n  - Path: inputs.configPersistenceStrategy\n    Category: inputs\n    Kind: enum\n    Description: Define se preferências locais persistidas ou o contrato explícito do host governam a materialização corrente.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy\n    Category: inputs\n    Kind: object\n    Description: Politica opt-in para materializar layout diretamente do schema atual sem depender de FormConfig.sections authoradas.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.source\n    Category: inputs\n    Kind: enum\n    Description: Define se o layout vem de configuracao authorada ou do schema.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.preset\n    Category: inputs\n    Kind: enum\n    Description: Preset de layout schema-driven. compactPresentation cobre detalhe read-only; groupedCommand cobre create/edit.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.intent\n    Category: inputs\n    Kind: enum\n    Description: Intencao da surface: detalhe/apresentacao ou comando/editavel.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.lifecycle\n    Category: inputs\n    Kind: enum\n    Description: Ciclo de materializacao do layout schema-driven.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.persistence\n    Category: inputs\n    Kind: enum\n    Description: Define se sections geradas sao transient ou podem virar layout authorado apos detach explicito.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.groupedCommand.orphanFieldExpansion\n    Category: inputs\n    Kind: enum\n    Description: Define como uma linha groupedCommand com um unico campo usa o espaco restante. O default medium-and-wide expande spans 6 ou 8 e preserva campos compactos.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.groupedCommand.contextFields\n    Category: inputs\n    Kind: array\n    Description: Campos canônicos do request cujo valor vem do contexto da surface. Eles permanecem no FormGroup e no payload, sem renderizar controles redundantes.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.detailSummary\n    Category: inputs\n    Kind: object\n    Description: Politica declarativa para resumo read-only compacto em compactPresentation, sem FormConfig.sections locais.",
           "sourcePointer": "projects/praxis-dynamic-form/src/lib/ai/form-ai-capabilities.ts",
-          "contentHash": "bb295439e01a4a20747d806c34a704434451095f624a73bf00f2dd1b895e9296",
+          "contentHash": "c0a08ef89a122e2e5ec62606017281c689a4e7e35662112e4ea5c00dbd4e3055",
           "sourceKind": "component_definition",
           "sourceId": "praxis-filter-form",
           "corpusVersion": "1.0.0"
@@ -15661,9 +15675,9 @@
         {
           "chunkIndex": 11,
           "chunkKind": "capabilities",
-          "content": "Component Capability:\n  - Path: inputs.layoutPolicy.detailSummary.excludeFields\n    Category: inputs\n    Kind: array\n    Description: Lista de campos canônicos do schema que devem ficar fora do resumo read-only compacto.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.detailSummary.includeGroups\n    Category: inputs\n    Kind: array\n    Description: Lista de grupos do schema que devem entrar no resumo read-only compacto.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.detailSummary.excludeGroups\n    Category: inputs\n    Kind: array\n    Description: Lista de grupos do schema que devem ficar fora do resumo read-only compacto.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.detailSummary.includeRoles\n    Category: inputs\n    Kind: array\n    Description: Lista de papeis semanticos de campo que devem entrar no resumo read-only compacto.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.detailSummary.excludeRoles\n    Category: inputs\n    Kind: array\n    Description: Lista de papeis semanticos de campo que devem ficar fora do resumo read-only compacto.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.detailSummary.maxFields\n    Category: inputs\n    Kind: number\n    Description: Limite maximo de campos materializados no primeiro painel compacto.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.detailSummary.fieldPriority\n    Category: inputs\n    Kind: object\n    Description: Mapa campo -> prioridade para ordenar campos do resumo quando o schema publica candidatos suficientes.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.detailSummary.groupPriority\n    Category: inputs\n    Kind: object\n    Description: Mapa grupo -> prioridade para ordenar grupos do resumo quando o schema publica agrupamento semantico.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.detailSummary.columns\n    Category: inputs\n    Kind: number\n    Description: Quantidade base de colunas para distribuir campos de resumo schema-driven sem criar FormConfig.sections locais.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.detailSummary.responsiveColumns\n    Category: inputs\n    Kind: object\n    Description: Mapa de colunas por breakpoint xs/sm/md/lg/xl para detalhes read-only compactos em drawers, side sheets e desktop largo.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.detailSummary.widthPrecedence\n    Category: inputs\n    Kind: enum\n    Description: Define se larguras explicitas do schema ou a densidade do resumo controlam os spans no compactPresentation read-only.\n\nComponent Capability:\n  - Path: inputs.fieldIconPolicy\n    Category: inputs\n    Kind: enum\n    Description: Controla se icones prefix/suffix dos metadados aparecem em todos os modos, apenas apresentacao, ou nunca.\n\nComponent Capability:\n  - Path: inputs.backConfig\n    Category: inputs\n    Kind: object\n    Description: Configuracao de navegacao/retorno (BackConfig).\n\nComponent Capability:\n  - Path: inputs.backConfig.strategy\n    Category: inputs\n    Kind: enum\n    Description: Estrategia de retorno (auto/close/navigate).\n\nComponent Capability:\n  - Path: inputs.backConfig.returnTo\n    Category: inputs\n    Kind: string\n    Description: Rota para retornar quando strategy=navigate.\n\nComponent Capability:\n  - Path: inputs.backConfig.confirmOnDirty\n    Category: inputs\n    Kind: boolean\n    Description: Solicita confirmacao ao sair com mudancas nao salvas.\n\nComponent Capability:\n  - Path: inputs.hooks\n    Category: inputs\n    Kind: object\n    Description: Declaracoes de hooks fornecidas diretamente ao componente.\n\nComponent Capability:\n  - Path: inputs.hooks.beforeInit[]\n    Category: hooks\n    Kind: array\n    Description: Hooks executados antes da inicializacao.\n\nComponent Capability:\n  - Path: inputs.hooks.afterInit[]\n    Category: hooks\n    Kind: array\n    Description: Hooks executados apos a inicializacao.\n\nComponent Capability:\n  - Path: inputs.hooks.beforeValidate[]\n    Category: hooks\n    Kind: array\n    Description: Hooks executados antes da validacao.\n\nComponent Capability:\n  - Path: inputs.hooks.afterValidate[]\n    Category: hooks\n    Kind: array\n    Description: Hooks executados apos a validacao.\n\nComponent Capability:\n  - Path: inputs.hooks.beforeSubmit[]\n    Category: hooks\n    Kind: array\n    Description: Hooks executados antes do submit.\n\nComponent Capability:\n  - Path: inputs.hooks.afterSubmit[]\n    Category: hooks\n    Kind: array\n    Description: Hooks executados apos o submit.\n\nComponent Capability:\n  - Path: inputs.hooks.onError[]\n    Category: hooks\n    Kind: array\n    Description: Hooks executados em erros de submit/validacao.\n\nComponent Capability:\n  - Path: inputs.removeEmptyContainersOnSave\n    Category: inputs\n    Kind: boolean\n    Description: Remove containers vazios ao salvar configuracao.\n\nComponent Capability:\n  - Path: inputs.reactiveValidation\n    Category: inputs\n    Kind: boolean\n    Description: Ativa validacao reativa (afterValidate em valueChanges).\n\nComponent Capability:\n  - Path: inputs.reactiveValidationDebounceMs\n    Category: inputs\n    Kind: number\n    Description: Debounce em ms para validacao reativa.\n\nComponent Capability:\n  - Path: inputs.notifyIfOutdated\n    Category: inputs\n    Kind: enum\n    Description: Canal de notificacao para schema desatualizado.\n\nComponent Capability:\n  - Path: inputs.snoozeMs\n    Category: inputs\n    Kind: number\n    Description: Duracao do snooze para alertas de schema.\n\nComponent Capability:\n  - Path: inputs.autoOpenSettingsOnOutdated\n    Category: inputs\n    Kind: boolean\n    Description: Abre automaticamente o editor ao detectar schema desatualizado.\n\nComponent Capability:\n  - Path: inputs.readonlyModeGlobal\n    Category: inputs\n    Kind: boolean\n    Description: Forca modo somente leitura global.\n\nComponent Capability:\n  - Path: inputs.disabledModeGlobal\n    Category: inputs\n    Kind: boolean\n    Description: Forca modo desabilitado global.\n\nComponent Capability:\n  - Path: inputs.presentationModeGlobal\n    Category: inputs\n    Kind: boolean\n    Description: Ativa modo de apresentacao global (somente view).\n\nComponent Capability:\n  - Path: inputs.visibleGlobal\n    Category: inputs\n    Kind: boolean\n    Description: Forca visibilidade global dos campos.\n\nComponent Capability:\n  - Path: inputs.customEndpoints\n    Category: inputs\n    Kind: object\n    Description: Override de endpoints CRUD (EndpointConfig).\n\nComponent Capability:\n  - Path: inputs.customEndpoints.getAll\n    Category: inputs\n    Kind: string\n    Description: Endpoint customizado para listar registros.\n\nComponent Capability:\n  - Path: inputs.customEndpoints.getById\n    Category: inputs\n    Kind: string\n    Description: Endpoint customizado para obter registro por ID.\n\nComponent Capability:\n  - Path: inputs.customEndpoints.create\n    Category: inputs\n    Kind: string\n    Description: Endpoint customizado para criar registro.\n\nComponent Capability:\n  - Path: inputs.customEndpoints.update\n    Category: inputs\n    Kind: string\n    Description: Endpoint customizado para atualizar registro.\n\nComponent Capability:\n  - Path: inputs.customEndpoints.delete\n    Category: inputs\n    Kind: string\n    Description: Endpoint customizado para deletar registro.\n\nComponent Capability:\n  - Path: inputs.customEndpoints.filter\n    Category: inputs\n    Kind: string\n    Description: Endpoint customizado para filtro.\n\nComponent Capability:\n  - Path: inputs.customEndpoints.schema\n    Category: inputs\n    Kind: string\n    Description: Endpoint customizado para schemas.\n\nComponent Capability:\n  - Path: inputs.config.presentation\n    Category: appearance\n    Kind: object\n    Description: Preferencias visuais persistidas no config.\n\nComponent Capability:\n  - Path: inputs.config.presentation.labelFontSize\n    Category: appearance\n    Kind: number\n    Description: Tamanho da fonte do label (px).\n\nComponent Capability:\n  - Path: inputs.config.presentation.valueFontSize\n    Category: appearance\n    Kind: number\n    Description: Tamanho da fonte do valor (px).",
+          "content": "Component Capability:\n  - Path: inputs.layoutPolicy.detailSummary.includeFields\n    Category: inputs\n    Kind: array\n    Description: Lista de campos canônicos do schema que devem entrar no resumo read-only compacto.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.detailSummary.excludeFields\n    Category: inputs\n    Kind: array\n    Description: Lista de campos canônicos do schema que devem ficar fora do resumo read-only compacto.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.detailSummary.includeGroups\n    Category: inputs\n    Kind: array\n    Description: Lista de grupos do schema que devem entrar no resumo read-only compacto.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.detailSummary.excludeGroups\n    Category: inputs\n    Kind: array\n    Description: Lista de grupos do schema que devem ficar fora do resumo read-only compacto.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.detailSummary.includeRoles\n    Category: inputs\n    Kind: array\n    Description: Lista de papeis semanticos de campo que devem entrar no resumo read-only compacto.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.detailSummary.excludeRoles\n    Category: inputs\n    Kind: array\n    Description: Lista de papeis semanticos de campo que devem ficar fora do resumo read-only compacto.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.detailSummary.maxFields\n    Category: inputs\n    Kind: number\n    Description: Limite maximo de campos materializados no primeiro painel compacto.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.detailSummary.fieldPriority\n    Category: inputs\n    Kind: object\n    Description: Mapa campo -> prioridade para ordenar campos do resumo quando o schema publica candidatos suficientes.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.detailSummary.groupPriority\n    Category: inputs\n    Kind: object\n    Description: Mapa grupo -> prioridade para ordenar grupos do resumo quando o schema publica agrupamento semantico.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.detailSummary.columns\n    Category: inputs\n    Kind: number\n    Description: Quantidade base de colunas para distribuir campos de resumo schema-driven sem criar FormConfig.sections locais.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.detailSummary.responsiveColumns\n    Category: inputs\n    Kind: object\n    Description: Mapa de colunas por breakpoint xs/sm/md/lg/xl para detalhes read-only compactos em drawers, side sheets e desktop largo.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.detailSummary.widthPrecedence\n    Category: inputs\n    Kind: enum\n    Description: Define se larguras explicitas do schema ou a densidade do resumo controlam os spans no compactPresentation read-only.\n\nComponent Capability:\n  - Path: inputs.fieldIconPolicy\n    Category: inputs\n    Kind: enum\n    Description: Controla se icones prefix/suffix dos metadados aparecem em todos os modos, apenas apresentacao, ou nunca.\n\nComponent Capability:\n  - Path: inputs.backConfig\n    Category: inputs\n    Kind: object\n    Description: Configuracao de navegacao/retorno (BackConfig).\n\nComponent Capability:\n  - Path: inputs.backConfig.strategy\n    Category: inputs\n    Kind: enum\n    Description: Estrategia de retorno (auto/close/navigate).\n\nComponent Capability:\n  - Path: inputs.backConfig.returnTo\n    Category: inputs\n    Kind: string\n    Description: Rota para retornar quando strategy=navigate.\n\nComponent Capability:\n  - Path: inputs.backConfig.confirmOnDirty\n    Category: inputs\n    Kind: boolean\n    Description: Solicita confirmacao ao sair com mudancas nao salvas.\n\nComponent Capability:\n  - Path: inputs.hooks\n    Category: inputs\n    Kind: object\n    Description: Declaracoes de hooks fornecidas diretamente ao componente.\n\nComponent Capability:\n  - Path: inputs.hooks.beforeInit[]\n    Category: hooks\n    Kind: array\n    Description: Hooks executados antes da inicializacao.\n\nComponent Capability:\n  - Path: inputs.hooks.afterInit[]\n    Category: hooks\n    Kind: array\n    Description: Hooks executados apos a inicializacao.\n\nComponent Capability:\n  - Path: inputs.hooks.beforeValidate[]\n    Category: hooks\n    Kind: array\n    Description: Hooks executados antes da validacao.\n\nComponent Capability:\n  - Path: inputs.hooks.afterValidate[]\n    Category: hooks\n    Kind: array\n    Description: Hooks executados apos a validacao.\n\nComponent Capability:\n  - Path: inputs.hooks.beforeSubmit[]\n    Category: hooks\n    Kind: array\n    Description: Hooks executados antes do submit.\n\nComponent Capability:\n  - Path: inputs.hooks.afterSubmit[]\n    Category: hooks\n    Kind: array\n    Description: Hooks executados apos o submit.\n\nComponent Capability:\n  - Path: inputs.hooks.onError[]\n    Category: hooks\n    Kind: array\n    Description: Hooks executados em erros de submit/validacao.\n\nComponent Capability:\n  - Path: inputs.removeEmptyContainersOnSave\n    Category: inputs\n    Kind: boolean\n    Description: Remove containers vazios ao salvar configuracao.\n\nComponent Capability:\n  - Path: inputs.reactiveValidation\n    Category: inputs\n    Kind: boolean\n    Description: Ativa validacao reativa (afterValidate em valueChanges).\n\nComponent Capability:\n  - Path: inputs.reactiveValidationDebounceMs\n    Category: inputs\n    Kind: number\n    Description: Debounce em ms para validacao reativa.\n\nComponent Capability:\n  - Path: inputs.notifyIfOutdated\n    Category: inputs\n    Kind: enum\n    Description: Canal de notificacao para schema desatualizado.\n\nComponent Capability:\n  - Path: inputs.snoozeMs\n    Category: inputs\n    Kind: number\n    Description: Duracao do snooze para alertas de schema.\n\nComponent Capability:\n  - Path: inputs.autoOpenSettingsOnOutdated\n    Category: inputs\n    Kind: boolean\n    Description: Abre automaticamente o editor ao detectar schema desatualizado.\n\nComponent Capability:\n  - Path: inputs.readonlyModeGlobal\n    Category: inputs\n    Kind: boolean\n    Description: Forca modo somente leitura global.\n\nComponent Capability:\n  - Path: inputs.disabledModeGlobal\n    Category: inputs\n    Kind: boolean\n    Description: Forca modo desabilitado global.\n\nComponent Capability:\n  - Path: inputs.presentationModeGlobal\n    Category: inputs\n    Kind: boolean\n    Description: Ativa modo de apresentacao global (somente view).\n\nComponent Capability:\n  - Path: inputs.visibleGlobal\n    Category: inputs\n    Kind: boolean\n    Description: Forca visibilidade global dos campos.\n\nComponent Capability:\n  - Path: inputs.customEndpoints\n    Category: inputs\n    Kind: object\n    Description: Override de endpoints CRUD (EndpointConfig).\n\nComponent Capability:\n  - Path: inputs.customEndpoints.getAll\n    Category: inputs\n    Kind: string\n    Description: Endpoint customizado para listar registros.\n\nComponent Capability:\n  - Path: inputs.customEndpoints.getById\n    Category: inputs\n    Kind: string\n    Description: Endpoint customizado para obter registro por ID.\n\nComponent Capability:\n  - Path: inputs.customEndpoints.create\n    Category: inputs\n    Kind: string\n    Description: Endpoint customizado para criar registro.\n\nComponent Capability:\n  - Path: inputs.customEndpoints.update\n    Category: inputs\n    Kind: string\n    Description: Endpoint customizado para atualizar registro.\n\nComponent Capability:\n  - Path: inputs.customEndpoints.delete\n    Category: inputs\n    Kind: string\n    Description: Endpoint customizado para deletar registro.\n\nComponent Capability:\n  - Path: inputs.customEndpoints.filter\n    Category: inputs\n    Kind: string\n    Description: Endpoint customizado para filtro.\n\nComponent Capability:\n  - Path: inputs.customEndpoints.schema\n    Category: inputs\n    Kind: string\n    Description: Endpoint customizado para schemas.\n\nComponent Capability:\n  - Path: inputs.config.presentation\n    Category: appearance\n    Kind: object\n    Description: Preferencias visuais persistidas no config.",
           "sourcePointer": "projects/praxis-dynamic-form/src/lib/ai/form-ai-capabilities.ts",
-          "contentHash": "78a041a9cb19a1b4b862f0db355c8b86cd83968592ad3ed3d709fe3207c80690",
+          "contentHash": "e04d360e46c5cf6d9856c9b55a6f140cc7a2fa07a670575bfe1319fd5079b158",
           "sourceKind": "component_definition",
           "sourceId": "praxis-filter-form",
           "corpusVersion": "1.0.0"
@@ -15671,9 +15685,9 @@
         {
           "chunkIndex": 12,
           "chunkKind": "capabilities",
-          "content": "Component Capability:\n  - Path: inputs.config.presentation.labelPosition\n    Category: appearance\n    Kind: enum\n    Description: Posicionamento do label (above/left).\n\nComponent Capability:\n  - Path: inputs.config.presentation.compact\n    Category: appearance\n    Kind: boolean\n    Description: Modo compacto de apresentacao.\n\nComponent Capability:\n  - Path: inputs.config.presentation.density\n    Category: appearance\n    Kind: enum\n    Description: Densidade visual global.\n\nComponent Capability:\n  - Path: inputs.config.presentation.labelWidth\n    Category: appearance\n    Kind: number\n    Description: Largura do label (px).\n\nComponent Capability:\n  - Path: inputs.config.presentation.labelAlign\n    Category: appearance\n    Kind: enum\n    Description: Alinhamento do label.\n\nComponent Capability:\n  - Path: inputs.config.presentation.valueAlign\n    Category: appearance\n    Kind: enum\n    Description: Alinhamento do valor.\n\nComponent Capability:\n  - Path: outputs.formSubmit\n    Category: outputs\n    Kind: object\n    Description: Evento emitido no submit do formulario.\n\nComponent Capability:\n  - Path: outputs.formCancel\n    Category: outputs\n    Kind: object\n    Description: Evento emitido ao cancelar.\n\nComponent Capability:\n  - Path: outputs.formReset\n    Category: outputs\n    Kind: object\n    Description: Evento emitido ao resetar o formulario.\n\nComponent Capability:\n  - Path: outputs.configChange\n    Category: outputs\n    Kind: object\n    Description: Evento emitido quando a configuracao muda.\n\nComponent Capability:\n  - Path: outputs.formReady\n    Category: outputs\n    Kind: object\n    Description: Evento emitido quando o formulario esta pronto.\n\nComponent Capability:\n  - Path: outputs.valueChange\n    Category: outputs\n    Kind: object\n    Description: Evento emitido quando o valor do formulario muda.\n\nComponent Capability:\n  - Path: outputs.syncCompleted\n    Category: outputs\n    Kind: object\n    Description: Evento emitido ao completar sincronizacao com schema.\n\nComponent Capability:\n  - Path: outputs.initializationError\n    Category: outputs\n    Kind: object\n    Description: Evento emitido quando ocorre erro na inicializacao.\n\nComponent Capability:\n  - Path: outputs.enableCustomizationChange\n    Category: outputs\n    Kind: object\n    Description: Evento emitido quando o modo de customizacao muda.\n\nComponent Capability:\n  - Path: outputs.customAction\n    Category: outputs\n    Kind: object\n    Description: Evento emitido ao disparar acao customizada.\n\nComponent Capability:\n  - Path: outputs.actionConfirmation\n    Category: outputs\n    Kind: object\n    Description: Evento emitido quando acao requer confirmacao.\n\nComponent Capability:\n  - Path: outputs.schemaStatusChange\n    Category: outputs\n    Kind: object\n    Description: Evento emitido quando o status do schema muda.\n\nCapability Note:\n  - Este catalogo descreve inputs e outputs do componente.\n\nCapability Note:\n  - O objeto inputs.config segue o schema de FormConfig (veja form-ai-capabilities).\n\nCapability Note:\n  - inputs.config.presentation e uma extensao de runtime aplicada pelo componente.\n\nCapability Note:\n  - Preferir FormConfig (sections/fieldMetadata) em vez do layout legado (fieldsets).\n\nCapability Note:\n  - Use inputs.editorialContext apenas para override de contexto editorial do host; a precedencia final e runtime < config.editorialContext < host.\n\nCapability Note:\n  - rich content editorial hospedado pelo form pode ser renderizado em tres slots semanticos: before, beforeActions e after.",
+          "content": "Component Capability:\n  - Path: inputs.config.presentation.labelFontSize\n    Category: appearance\n    Kind: number\n    Description: Tamanho da fonte do label (px).\n\nComponent Capability:\n  - Path: inputs.config.presentation.valueFontSize\n    Category: appearance\n    Kind: number\n    Description: Tamanho da fonte do valor (px).\n\nComponent Capability:\n  - Path: inputs.config.presentation.labelPosition\n    Category: appearance\n    Kind: enum\n    Description: Posicionamento do label (above/left).\n\nComponent Capability:\n  - Path: inputs.config.presentation.compact\n    Category: appearance\n    Kind: boolean\n    Description: Modo compacto de apresentacao.\n\nComponent Capability:\n  - Path: inputs.config.presentation.density\n    Category: appearance\n    Kind: enum\n    Description: Densidade visual global.\n\nComponent Capability:\n  - Path: inputs.config.presentation.labelWidth\n    Category: appearance\n    Kind: number\n    Description: Largura do label (px).\n\nComponent Capability:\n  - Path: inputs.config.presentation.labelAlign\n    Category: appearance\n    Kind: enum\n    Description: Alinhamento do label.\n\nComponent Capability:\n  - Path: inputs.config.presentation.valueAlign\n    Category: appearance\n    Kind: enum\n    Description: Alinhamento do valor.\n\nComponent Capability:\n  - Path: outputs.formSubmit\n    Category: outputs\n    Kind: object\n    Description: Evento emitido no submit do formulario.\n\nComponent Capability:\n  - Path: outputs.formCancel\n    Category: outputs\n    Kind: object\n    Description: Evento emitido ao cancelar.\n\nComponent Capability:\n  - Path: outputs.formReset\n    Category: outputs\n    Kind: object\n    Description: Evento emitido ao resetar o formulario.\n\nComponent Capability:\n  - Path: outputs.configChange\n    Category: outputs\n    Kind: object\n    Description: Evento emitido quando a configuracao muda.\n\nComponent Capability:\n  - Path: outputs.formReady\n    Category: outputs\n    Kind: object\n    Description: Evento emitido quando o formulario esta pronto.\n\nComponent Capability:\n  - Path: outputs.valueChange\n    Category: outputs\n    Kind: object\n    Description: Evento emitido quando o valor do formulario muda.\n\nComponent Capability:\n  - Path: outputs.syncCompleted\n    Category: outputs\n    Kind: object\n    Description: Evento emitido ao completar sincronizacao com schema.\n\nComponent Capability:\n  - Path: outputs.initializationError\n    Category: outputs\n    Kind: object\n    Description: Evento emitido quando ocorre erro na inicializacao.\n\nComponent Capability:\n  - Path: outputs.enableCustomizationChange\n    Category: outputs\n    Kind: object\n    Description: Evento emitido quando o modo de customizacao muda.\n\nComponent Capability:\n  - Path: outputs.customAction\n    Category: outputs\n    Kind: object\n    Description: Evento emitido ao disparar acao customizada.\n\nComponent Capability:\n  - Path: outputs.actionConfirmation\n    Category: outputs\n    Kind: object\n    Description: Evento emitido quando acao requer confirmacao.\n\nComponent Capability:\n  - Path: outputs.schemaStatusChange\n    Category: outputs\n    Kind: object\n    Description: Evento emitido quando o status do schema muda.\n\nCapability Note:\n  - Este catalogo descreve inputs e outputs do componente.\n\nCapability Note:\n  - O objeto inputs.config segue o schema de FormConfig (veja form-ai-capabilities).\n\nCapability Note:\n  - inputs.config.presentation e uma extensao de runtime aplicada pelo componente.\n\nCapability Note:\n  - Preferir FormConfig (sections/fieldMetadata) em vez do layout legado (fieldsets).\n\nCapability Note:\n  - Use inputs.editorialContext apenas para override de contexto editorial do host; a precedencia final e runtime < config.editorialContext < host.\n\nCapability Note:\n  - rich content editorial hospedado pelo form pode ser renderizado em tres slots semanticos: before, beforeActions e after.",
           "sourcePointer": "projects/praxis-dynamic-form/src/lib/ai/form-ai-capabilities.ts",
-          "contentHash": "64e6c04239b6f490007be4f04318d66f2e918861b1474d2fe4f32380444efa2d",
+          "contentHash": "beda7b0e56767eb05d2104f64b078e5d582354da389421f4cc5db0853bf87a2a",
           "sourceKind": "component_definition",
           "sourceId": "praxis-filter-form",
           "corpusVersion": "1.0.0"

package/docs/schema-driven-layout-materialization-rfc.md

@@ -4,7 +4,7 @@ doc_type: "rfc"
 component: "praxis-dynamic-form"
 status: "implemented-partial"
 owner: "praxis-ui"
-last_updated: "2026-06-29"
+last_updated: "2026-08-03"
 classification: "contrato-publico, arquitetural"
 ---
 
@@ -116,6 +116,16 @@ export interface DynamicFormDetailSummaryPolicy {
   widthPrecedence?: 'schema' | 'summary';
 }
 
+export interface DynamicFormGroupedCommandPolicy {
+  orphanFieldExpansion?: 'preserve' | 'medium-and-wide' | 'all';
+  /**
+   * Schema field names whose values are supplied by the surrounding business
+   * context. They remain in the FormGroup and submit payload, but are omitted
+   * from the interactive command layout.
+   */
+  contextFields?: readonly string[];
+}
+
 export interface DynamicFormLayoutPolicy {
   source: DynamicFormLayoutSource;
   preset?: DynamicFormSchemaLayoutPreset;
@@ -126,6 +136,7 @@ export interface DynamicFormLayoutPolicy {
   schemaOperation?: 'detail' | 'create' | 'update' | 'view';
   schemaType?: 'request' | 'response';
   detailSummary?: DynamicFormDetailSummaryPolicy;
+  groupedCommand?: DynamicFormGroupedCommandPolicy;
 }
 ```
 
@@ -215,6 +226,7 @@ Expected behavior:
 - Use full-width rows for long text, descriptions, multiline controls and high-density option controls when needed.
 - Use compact clusters for booleans, short enums and small numeric fields.
 - Expand an otherwise orphan medium/wide field to the full row by default, while preserving compact `xs`/`sm` fields. Use `groupedCommand.orphanFieldExpansion = "preserve"` when the empty space is intentional, or `"all"` when compact orphan fields must also fill the row.
+- Omit fields listed in `groupedCommand.contextFields` from the interactive layout while retaining their schema metadata, runtime control and submit value. Use this only when the surrounding surface already establishes the value, such as a selected employee opening a related-resource command; it is not a substitute for authorization, validation or backend ownership.
 - Keep validation feedback near the field that caused it.
 - Prefer editable controls over presentation roles.
 - Keep command actions visually stable and accessible.

package/fesm2022/praxisui-dynamic-form.mjs

@@ -6032,7 +6032,7 @@ const PRAXIS_DYNAMIC_FORM_AUTHORING_MANIFEST = {
         { name: 'mode', type: 'string', allowedValues: ['create', 'edit', 'view'], description: 'Modo de operação' },
         { name: 'configPersistenceStrategy', type: 'string', allowedValues: ['local-first', 'input-first'], description: 'Precedência entre configuração persistida e contrato explícito do host. Use input-first em dialogs e surfaces transitórias governadas por schema para preservar mode e estados operacionais publicados pelo servidor.' },
         { name: 'generatedLayoutPreset', type: 'string', allowedValues: ['default', 'compactPresentation'], description: 'Preset usado apenas ao gerar a configuracao inicial a partir de metadata/schema; nao reprocessa layouts persistidos ou autorados.' },
-        { name: 'layoutPolicy', type: 'DynamicFormLayoutPolicy', description: 'Politica opt-in para layout schema-driven transient. Use source=schema apenas quando o backend schema for a fonte canonica do agrupamento; use detailSummary para seleção de campos e densidade responsiva do resumo read-only compacto sem FormConfig.sections locais. Quando o resumo precisar vencer x-ui.width publicado para outras surfaces, use detailSummary.widthPrecedence=summary. Em groupedCommand, orphanFieldExpansion governa linhas com um unico campo; medium-and-wide e o default corporativo.' },
+        { name: 'layoutPolicy', type: 'DynamicFormLayoutPolicy', description: 'Politica opt-in para layout schema-driven transient. Use source=schema apenas quando o backend schema for a fonte canonica do agrupamento; use detailSummary para seleção de campos e densidade responsiva do resumo read-only compacto sem FormConfig.sections locais. Quando o resumo precisar vencer x-ui.width publicado para outras surfaces, use detailSummary.widthPrecedence=summary. Em groupedCommand, orphanFieldExpansion governa linhas com um unico campo; contextFields identifica campos do request hidratados pela surface que permanecem no payload sem criar controles redundantes.' },
         { name: 'fieldIconPolicy', type: 'string', allowedValues: ['all', 'presentation-only', 'none'], description: 'Politica visual do host para icones prefix/suffix de campos vindos da metadata. Use presentation-only para manter icones decorativos em apresentacao e ocultar em controles tradicionais.' },
         { name: 'enableCustomization', type: 'boolean', description: 'Habilita edição visual' }
     ],
@@ -35253,6 +35253,13 @@ const FORM_COMPONENT_AI_CAPABILITIES = {
             description: 'Define como uma linha groupedCommand com um unico campo usa o espaco restante. O default medium-and-wide expande spans 6 ou 8 e preserva campos compactos.',
             safetyNotes: 'Use preserve quando o espaco vazio for intencional; use all apenas quando ate campos xs/sm devam ocupar a linha completa.',
         },
+        {
+            path: 'inputs.layoutPolicy.groupedCommand.contextFields',
+            category: 'inputs',
+            valueKind: 'array',
+            description: 'Campos canônicos do request cujo valor vem do contexto da surface. Eles permanecem no FormGroup e no payload, sem renderizar controles redundantes.',
+            safetyNotes: 'Use somente para campos realmente hidratados por initialValue ou leitura da entidade; nunca use para esconder dados que a pessoa ainda precisa informar.',
+        },
         {
             path: 'inputs.layoutPolicy.detailSummary',
             category: 'inputs',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@praxisui/dynamic-form",
-  "version": "9.0.4-rc.18",
+  "version": "9.0.4-rc.19",
   "description": "Angular dynamic form engine for Praxis UI: metadata-driven forms, hooks, and services integrating @praxisui/* packages.",
   "peerDependencies": {
     "@angular/common": "^21.0.0",
@@ -9,13 +9,13 @@
     "@angular/forms": "^21.0.0",
     "@angular/material": "^21.0.0",
     "@angular/router": "^21.0.0",
-    "@praxisui/ai": "^9.0.4-rc.18",
-    "@praxisui/dynamic-fields": "^9.0.4-rc.18",
-    "@praxisui/metadata-editor": "^9.0.4-rc.18",
-    "@praxisui/rich-content": "^9.0.4-rc.18",
-    "@praxisui/settings-panel": "^9.0.4-rc.18",
-    "@praxisui/visual-builder": "^9.0.4-rc.18",
-    "@praxisui/core": "^9.0.4-rc.18",
+    "@praxisui/ai": "^9.0.4-rc.19",
+    "@praxisui/dynamic-fields": "^9.0.4-rc.19",
+    "@praxisui/metadata-editor": "^9.0.4-rc.19",
+    "@praxisui/rich-content": "^9.0.4-rc.19",
+    "@praxisui/settings-panel": "^9.0.4-rc.19",
+    "@praxisui/visual-builder": "^9.0.4-rc.19",
+    "@praxisui/core": "^9.0.4-rc.19",
     "rxjs": "^7.8.0"
   },
   "dependencies": {

package/src/lib/praxis-dynamic-form.json-api.md

@@ -591,7 +591,7 @@ No ecossistema Praxis, ele funciona tanto como runtime final quanto como superfi
 | `configPersistenceStrategy` | `'local-first' \| 'input-first'` | `'local-first'` | Active | Em `input-first`, os inputs fornecidos pelo host, inclusive `mode`, permanecem autoritativos sobre preferencias persistidas da mesma instancia. Combine com `layoutPolicy.persistence='transient'` em commands efemeros para nao carregar nem gravar layout local. |
 | `layout` | `FormLayout \| undefined` | `undefined` | Partial | Funciona como override estrutural em parte dos fluxos de layout/editor. |
 | `generatedLayoutPreset` | `'default' \| 'compactPresentation'` | `'default'` | Active | Usado apenas ao criar a configuracao inicial a partir de schema/metadata; nao reprocessa layouts persistidos ou authorados. |
-| `layoutPolicy` | `DynamicFormLayoutPolicy \| null` | `null` | Active | Politica opt-in para materializar layout a partir do schema atual. Use `source: 'schema'` com `persistence: 'transient'` para detalhe/read-only e command forms schema-driven sem persistir `sections` geradas nem reabrir configuracao local salva; politicas de host em `config`, como `helpPresentation`, continuam sendo aplicadas ao layout materializado. Em `mode='view'`, `intent: 'detail'` ou `preset: 'compactPresentation'` ativa apresentacao quando `presentationModeGlobal` nao foi informado; use `[presentationModeGlobal]=false` para controles read-only tradicionais. No preset `compactPresentation`, `x-ui.width` explicito empacota campos em linhas de 12 colunas e tem precedencia sobre `detailSummary.columns` por default; campos sem width permanecem full-width, a menos que `detailSummary.columns`/`responsiveColumns` declare a densidade do resumo. Use `detailSummary.widthPrecedence='summary'` quando a densidade do resumo read-only deve sobrescrever `x-ui.width` apenas nessa surface compacta. No preset `groupedCommand`, `groupedCommand.orphanFieldExpansion` controla linhas com um unico campo: `medium-and-wide` (default) expande spans 6/8, `preserve` mantem o width publicado e `all` tambem expande campos compactos. Use `responsiveColumns`, por exemplo `{ lg: 3, md: 2, sm: 1 }`, para drawers, side sheets e painéis corporativos estreitos sem copiar `FormConfig.sections` locais. `schemaType` e `schemaOperation` sao validados contra `schemaUrl` quando a URL declara esses parametros. |
+| `layoutPolicy` | `DynamicFormLayoutPolicy \| null` | `null` | Active | Politica opt-in para materializar layout a partir do schema atual. Use `source: 'schema'` com `persistence: 'transient'` para detalhe/read-only e command forms schema-driven sem persistir `sections` geradas nem reabrir configuracao local salva; politicas de host em `config`, como `helpPresentation`, continuam sendo aplicadas ao layout materializado. Em `mode='view'`, `intent: 'detail'` ou `preset: 'compactPresentation'` ativa apresentacao quando `presentationModeGlobal` nao foi informado; use `[presentationModeGlobal]=false` para controles read-only tradicionais. No preset `compactPresentation`, `x-ui.width` explicito empacota campos em linhas de 12 colunas e tem precedencia sobre `detailSummary.columns` por default; campos sem width permanecem full-width, a menos que `detailSummary.columns`/`responsiveColumns` declare a densidade do resumo. Use `detailSummary.widthPrecedence='summary'` quando a densidade do resumo read-only deve sobrescrever `x-ui.width` apenas nessa surface compacta. No preset `groupedCommand`, `groupedCommand.orphanFieldExpansion` controla linhas com um unico campo: `medium-and-wide` (default) expande spans 6/8, `preserve` mantem o width publicado e `all` tambem expande campos compactos. `groupedCommand.contextFields` identifica campos schema-backed já hidratados pela surface: eles permanecem no `FormGroup` e no payload, mas não renderizam controles redundantes. Use `responsiveColumns`, por exemplo `{ lg: 3, md: 2, sm: 1 }`, para drawers, side sheets e painéis corporativos estreitos sem copiar `FormConfig.sections` locais. `schemaType` e `schemaOperation` sao validados contra `schemaUrl` quando a URL declara esses parametros. |
 | `backConfig` | `BackConfig \| undefined` | `undefined` | Active | Integra retorno/navegacao no painel de configuracao; `confirmOnDirty` tem precedencia sobre `behavior.confirmOnUnsavedChanges` no cancel. |
 | `hooks` | `FormHooksLayout \| undefined` | `undefined` | Active | Override direto de hooks sobre `config.hooks`. |
 | `customEndpoints` | `EndpointConfig` | `{}` | Active | Override de endpoints no CRUD service interno. |