@praxisui/dynamic-form 9.0.0-beta.88 → 9.0.0-beta.90

package/README.md

@@ -207,6 +207,7 @@ Recommended defaults:
 
 - detail/read-only: `layoutPolicy.source = "schema"`, `intent = "detail"`, `preset = "compactPresentation"`, `persistence = "transient"` and a response schema;
 - create/edit: `layoutPolicy.source = "schema"`, `intent = "command"`, `preset = "groupedCommand"`, `persistence = "transient"` and a request schema;
+- `groupedCommand` expands a single orphan `md`/`lg` field to the full row by default. Set `layoutPolicy.groupedCommand.orphanFieldExpansion = "preserve"` for intentionally compact rows, or `"all"` to expand orphan `xs`/`sm` fields too;
 - dense command drawers: `helpPresentation.display = "auto"` with popover preference for select, checkbox, toggle, date and numeric controls;
 - operational input-heavy forms: `fieldIconPolicy = "presentation-only"` unless the icon is part of the actual affordance.
 
@@ -264,6 +265,16 @@ Common outputs:
 
 `formSubmit` exposes both persistence data and full UI state:
 
+`schemaUrl`/the request schema is the only source of editable controls and the
+command payload. `responseSchemaUrl` is diagnostic response evidence; hosts must
+not use it to merge response-only properties into edit controls. Record identity
+belongs in an external read-only context component and never in `formData`.
+
+During hydration, properties absent from request-schema `fieldMetadata` do not
+create Angular form controls, so they are absent from both `rawFormData` and the
+prepared PUT/PATCH payload. Nested collection identity remains governed by its
+own item-schema submit contract.
+
 - `formData`: filtered backend payload after submit policies are applied
 - `rawFormData`: complete form value bag, including UI-only values
 

package/ai/component-registry.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": "1.0.0",
-  "generatedAt": "2026-07-23T02:50:28.389Z",
+  "generatedAt": "2026-07-24T12:32:39.440Z",
   "packageName": "@praxisui/dynamic-form",
-  "packageVersion": "9.0.0-beta.88",
+  "packageVersion": "9.0.0-beta.90",
   "sourceRegistry": "praxis-component-registry-ingestion",
   "sourceRegistryVersion": "1.0.0",
   "componentCount": 2,
@@ -102,7 +102,7 @@
           "name": "responseSchemaUrl",
           "type": "string | null",
           "required": false,
-          "description": "Schema de resposta publicado pelo backend para inspecao diagnostica e follow-up de runtime"
+          "description": "Schema de resposta publicado pelo backend apenas para diagnostico e follow-up; nao compoe campos editaveis nem o payload do comando"
         },
         {
           "name": "enableCustomization",
@@ -4205,6 +4205,18 @@
           ],
           "description": "Define se sections geradas sao transient ou podem virar layout authorado apos detach explicito."
         },
+        {
+          "path": "inputs.layoutPolicy.groupedCommand.orphanFieldExpansion",
+          "category": "inputs",
+          "valueKind": "enum",
+          "allowedValues": [
+            "preserve",
+            "medium-and-wide",
+            "all"
+          ],
+          "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.detailSummary",
           "category": "inputs",
@@ -6137,7 +6149,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."
+            "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",
@@ -8752,9 +8764,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.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.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.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.\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.",
+          "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.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.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.\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.",
           "sourcePointer": "projects/praxis-dynamic-form/src/lib/ai/form-component-ai-capabilities.ts",
-          "contentHash": "418dd77e4d37bcf80ba1fe9c405b691cfc53416dc9364ce400449da2b4749731",
+          "contentHash": "e89e40f565c3d190defcdd4bb253f57ddde076effae96d6b2a0c9d85aa2cc82f",
           "sourceKind": "component_definition",
           "sourceId": "praxis-dynamic-form",
           "corpusVersion": "1.0.0"
@@ -8762,9 +8774,9 @@
         {
           "chunkIndex": 11,
           "chunkKind": "capabilities",
-          "content": "Component 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).\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.",
+          "content": "Component 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).\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.",
           "sourcePointer": "projects/praxis-dynamic-form/src/lib/ai/form-component-ai-capabilities.ts",
-          "contentHash": "a8b570c3523646026b9ed80c42c25ab891a056b77ece8f13aff58dd5469bae1e",
+          "contentHash": "3201790d3d1d9216e42135caea0bdbc3ff94f7c46bbeb54a48bb5d700c53d8ff",
           "sourceKind": "component_definition",
           "sourceId": "praxis-dynamic-form",
           "corpusVersion": "1.0.0"
@@ -8772,9 +8784,9 @@
         {
           "chunkIndex": 12,
           "chunkKind": "capabilities",
-          "content": "Component 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.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": "f170eb134e370e2fe148ce677d5ff969edeb7db977c11b298cbefd6c393b4a27",
+          "contentHash": "0e9fb6b721474a0c25bacf19e9b00e48e90c790f721745ed2438da208ad4a9a0",
           "sourceKind": "component_definition",
           "sourceId": "praxis-dynamic-form",
           "corpusVersion": "1.0.0"
@@ -9072,9 +9084,9 @@
         {
           "chunkIndex": 42,
           "chunkKind": "authoring_manifest",
-          "content": "{\"schemaVersion\":\"1.0.0\",\"manifestVersion\":\"1.5.0\",\"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\":\"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.\"},{\"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.0\",\"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\":\"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\"}]}",
           "sourcePointer": "projects/praxis-dynamic-form/src/lib/ai/praxis-dynamic-form-authoring-manifest.ts",
-          "contentHash": "3a3c68111c47dbf379c8b6fef3d3d2fd5a951ca17d2dd6095d04b7451dc7789b",
+          "contentHash": "deda977596334922324e92095855ac5ec03b6e3cb069e7e4c6770f6b258dec1c",
           "sourceKind": "component_definition",
           "sourceId": "praxis-dynamic-form",
           "corpusVersion": "1.0.0"
@@ -13555,6 +13567,18 @@
           ],
           "description": "Define se sections geradas sao transient ou podem virar layout authorado apos detach explicito."
         },
+        {
+          "path": "inputs.layoutPolicy.groupedCommand.orphanFieldExpansion",
+          "category": "inputs",
+          "valueKind": "enum",
+          "allowedValues": [
+            "preserve",
+            "medium-and-wide",
+            "all"
+          ],
+          "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.detailSummary",
           "category": "inputs",
@@ -15542,9 +15566,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.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.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.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.\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.",
+          "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.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.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.\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.",
           "sourcePointer": "projects/praxis-dynamic-form/src/lib/ai/form-ai-capabilities.ts",
-          "contentHash": "418dd77e4d37bcf80ba1fe9c405b691cfc53416dc9364ce400449da2b4749731",
+          "contentHash": "e89e40f565c3d190defcdd4bb253f57ddde076effae96d6b2a0c9d85aa2cc82f",
           "sourceKind": "component_definition",
           "sourceId": "praxis-filter-form",
           "corpusVersion": "1.0.0"
@@ -15552,9 +15576,9 @@
         {
           "chunkIndex": 11,
           "chunkKind": "capabilities",
-          "content": "Component 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).\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.",
+          "content": "Component 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).\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.",
           "sourcePointer": "projects/praxis-dynamic-form/src/lib/ai/form-ai-capabilities.ts",
-          "contentHash": "a8b570c3523646026b9ed80c42c25ab891a056b77ece8f13aff58dd5469bae1e",
+          "contentHash": "3201790d3d1d9216e42135caea0bdbc3ff94f7c46bbeb54a48bb5d700c53d8ff",
           "sourceKind": "component_definition",
           "sourceId": "praxis-filter-form",
           "corpusVersion": "1.0.0"
@@ -15562,9 +15586,9 @@
         {
           "chunkIndex": 12,
           "chunkKind": "capabilities",
-          "content": "Component 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.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": "f170eb134e370e2fe148ce677d5ff969edeb7db977c11b298cbefd6c393b4a27",
+          "contentHash": "0e9fb6b721474a0c25bacf19e9b00e48e90c790f721745ed2438da208ad4a9a0",
           "sourceKind": "component_definition",
           "sourceId": "praxis-filter-form",
           "corpusVersion": "1.0.0"

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

@@ -214,6 +214,7 @@ Expected behavior:
 - Use `width` metadata plus field archetype rules to create predictable grid spans.
 - 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.
 - 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

@@ -6029,7 +6029,7 @@ const PRAXIS_DYNAMIC_FORM_AUTHORING_MANIFEST = {
         { 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: '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.' },
+        { 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' }
     ],
@@ -30891,7 +30891,7 @@ const PRAXIS_DYNAMIC_FORM_COMPONENT_METADATA = {
         { name: 'apiUrlEntry', type: 'ApiUrlEntry | null', description: 'Entrada de API ja resolvida para hosts destacados que nao herdam o provider de API_URL da rota atual' },
         { name: 'submitUrl', type: 'string | null', description: 'URL canonica de submit publicada pelo backend para forms orientados a surface' },
         { name: 'submitMethod', type: "'post' | 'put' | 'patch' | null", description: 'Metodo HTTP canonico do submit quando a surface publica operacao explicita' },
-        { name: 'responseSchemaUrl', type: 'string | null', description: 'Schema de resposta publicado pelo backend para inspecao diagnostica e follow-up de runtime' },
+        { name: 'responseSchemaUrl', type: 'string | null', description: 'Schema de resposta publicado pelo backend apenas para diagnostico e follow-up; nao compoe campos editaveis nem o payload do comando' },
         { name: 'enableCustomization', type: 'boolean', default: false, description: 'Habilita modo de customizacao do layout (canvas)' },
         { name: 'showAiAssistant', type: 'boolean', default: true, description: 'Mostra os gatilhos do copiloto semantico Praxis para esta instancia do formulario' },
         { name: 'formId', type: 'string', description: 'Chave para persistencia local da configuracao' },
@@ -34933,6 +34933,11 @@ const ENUMS = {
     layoutPolicyLifecycle: ['initial', 'live'],
     layoutPolicyPersistence: ['transient', 'authorable'],
     layoutPolicyWidthPrecedence: ['schema', 'summary'],
+    layoutPolicyOrphanFieldExpansion: [
+        'preserve',
+        'medium-and-wide',
+        'all',
+    ],
     fieldIconPolicy: ['all', 'presentation-only', 'none'],
     notifyIfOutdated: ['inline', 'snackbar', 'both', 'none'],
     labelPosition: ['above', 'left'],
@@ -35121,6 +35126,14 @@ const FORM_COMPONENT_AI_CAPABILITIES = {
             allowedValues: ENUMS.layoutPolicyPersistence,
             description: 'Define se sections geradas sao transient ou podem virar layout authorado apos detach explicito.',
         },
+        {
+            path: 'inputs.layoutPolicy.groupedCommand.orphanFieldExpansion',
+            category: 'inputs',
+            valueKind: 'enum',
+            allowedValues: ENUMS.layoutPolicyOrphanFieldExpansion,
+            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.detailSummary',
             category: 'inputs',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@praxisui/dynamic-form",
-  "version": "9.0.0-beta.88",
+  "version": "9.0.0-beta.90",
   "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.0-beta.88",
-    "@praxisui/dynamic-fields": "^9.0.0-beta.88",
-    "@praxisui/metadata-editor": "^9.0.0-beta.88",
-    "@praxisui/rich-content": "^9.0.0-beta.88",
-    "@praxisui/settings-panel": "^9.0.0-beta.88",
-    "@praxisui/visual-builder": "^9.0.0-beta.88",
-    "@praxisui/core": "^9.0.0-beta.88",
+    "@praxisui/ai": "^9.0.0-beta.90",
+    "@praxisui/dynamic-fields": "^9.0.0-beta.90",
+    "@praxisui/metadata-editor": "^9.0.0-beta.90",
+    "@praxisui/rich-content": "^9.0.0-beta.90",
+    "@praxisui/settings-panel": "^9.0.0-beta.90",
+    "@praxisui/visual-builder": "^9.0.0-beta.90",
+    "@praxisui/core": "^9.0.0-beta.90",
     "rxjs": "^7.8.0"
   },
   "dependencies": {

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

@@ -246,7 +246,7 @@ the canonical remote entity loaded through `resourcePath` and `resourceId`.
 | `readUrl` | `string \| null \| undefined` | No | component-input | resolved via API origin and `{id}` placeholders | URL concreta de leitura publicada por surface `VIEW`/`READ_PROJECTION`; quando presente, substitui `crud.getById` na hidratação da entidade. |
 | `submitUrl` | `string \| null \| undefined` | Conditional | component-input | resolved via API origin | URL concreta de submit publicada por surface/action; exige `submitMethod` quando usada para envio HTTP. |
 | `submitMethod` | `'post' \| 'put' \| 'patch' \| null \| undefined` | Conditional | component-input | normalized lowercase | Método HTTP concreto de submit publicado por surface/action; exige `submitUrl` quando usado para envio HTTP. |
-| `responseSchemaUrl` | `string \| null \| undefined` | No | component-input | diagnostic only | Schema de resposta para diagnóstico e follow-up de runtime. |
+| `responseSchemaUrl` | `string \| null \| undefined` | No | component-input | diagnostic only | Schema de resposta para diagnóstico e follow-up; não compõe campos editáveis nem o payload do comando. |
 | `enableCustomization` | `boolean` | No | component-input | boolean coercion | Alterna UX de edição visual/configuração. |
 | `formId` | `string \| undefined` | Yes (corporate flow) | component-input | component key scoping | Obrigatório para ciclo corporativo com persistência e sync. |
 | `componentInstanceId` | `string \| undefined` | No | component-input | component key scoping | Isola persistência por instância. |
@@ -576,13 +576,13 @@ No ecossistema Praxis, ele funciona tanto como runtime final quanto como superfi
 | `domainRules` | `PraxisDynamicFormDomainRulesOptions \| boolean \| null` | `null` | Active | Opt-in para carregar materializacoes de regras compartilhadas em `/api/praxis/config/domain-rules/materializations` e combina-las com `config.formRules`. |
 | `submitUrl` | `string \| undefined` | `undefined` | Active | Executa submit canonico publicado por `surface` ou `action`, sem inferencia local de CRUD. |
 | `submitMethod` | `'post' \| 'put' \| 'patch' \| undefined` | `undefined` | Active | Metodo HTTP do submit canonico; deve acompanhar `submitUrl`. |
-| `responseSchemaUrl` | `string \| undefined` | `undefined` | Active | Porta diagnóstica/read-only para hosts que precisem inspecionar o contrato de resposta do backend. |
+| `responseSchemaUrl` | `string \| undefined` | `undefined` | Active | Porta diagnóstica/read-only; não deve ser usada para mesclar propriedades do schema de resposta no formulário de comando. |
 | `enableCustomization` | `boolean` | `false` | Active | Habilita UX de customizacao do layout. |
 | `formId` | `string \| undefined` | `undefined` | Active | Chave de persistencia e identidade logica. |
 | `componentInstanceId` | `string \| undefined` | `undefined` | Active | Isola instancias com mesmo `formId`. |
 | `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. 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. 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. |