@praxisui/dynamic-form 9.0.5-rc.2 → 9.0.5-rc.4

package/README.md

@@ -139,12 +139,13 @@ included in the submit payload, but are omitted from the interactive layout. The
 them through `initialValue` on create or through the entity read on edit; this policy must not hide
 values that the user is expected to choose.
 
-For generated command rows with two or more fields, the default
+For generated command groups, the default
 `layoutPolicy.groupedCommand.partialRowStrategy = "preserve"` keeps published spans unchanged.
 Use `"fill-compatible"` when eligible controls should absorb the remaining 12-column space at
-each container breakpoint (for example, `4 + 4` projects to `6 + 6`). This is a transient runtime
-projection: schema `x-ui.width`, generated `sections` and authoring documents are not rewritten.
-Compact boolean/action controls, uploads and unknown control types remain at their canonical span.
+each visual row after responsive visibility, CSS `order` and wrapping are resolved (for example, `4 + 4` projects to `6 + 6`, while
+`6 + 6 + 6` projects to visual rows `6 + 6` and `12`). This is a transient runtime projection:
+schema `x-ui.width`, generated `sections` and authoring documents are not rewritten. Compact
+boolean/action controls, uploads and unknown control types remain at their canonical span.
 
 When `mode="view"` and the host does not provide `presentationModeGlobal`, a schema policy with
 `intent: "detail"` or `preset: "compactPresentation"` also enables presentation rendering. Hosts
@@ -222,7 +223,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;
-- `layoutPolicy.groupedCommand.partialRowStrategy = "fill-compatible"` projects eligible partial rows to the canonical 12-column grid per container breakpoint, while the default `"preserve"` retains intentional whitespace;
+- `layoutPolicy.groupedCommand.partialRowStrategy = "fill-compatible"` projects every eligible visual row, including rows created by responsive visibility, CSS `order` and wrapping, to the canonical 12-column grid per container breakpoint, while the default `"preserve"` retains intentional whitespace;
 - 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.
 

package/ai/component-registry.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": "1.0.0",
-  "generatedAt": "2026-08-11T20:12:18.507Z",
+  "generatedAt": "2026-08-12T04:55:54.550Z",
   "packageName": "@praxisui/dynamic-form",
-  "packageVersion": "9.0.5-rc.2",
+  "packageVersion": "9.0.5-rc.4",
   "sourceRegistry": "praxis-component-registry-ingestion",
   "sourceRegistryVersion": "1.0.0",
   "componentCount": 2,
@@ -4279,7 +4279,7 @@
             "preserve",
             "fill-compatible"
           ],
-          "description": "Define se linhas parciais com dois campos ou mais preservam os spans canônicos ou redistribuem apenas campos compatíveis para completar 12 colunas no breakpoint atual.",
+          "description": "Define se cada linha visual parcial, depois de resolver visibilidade responsiva, CSS order e wrap, preserva os spans canônicos ou redistribui apenas campos compatíveis para completar 12 colunas no breakpoint atual.",
           "safetyNotes": "fill-compatible é uma projeção transitória do runtime: não altera x-ui.width nem persiste sections. Controles compactos, uploads e tipos desconhecidos preservam a largura canônica."
         },
         {
@@ -6223,7 +6223,7 @@
           {
             "name": "layoutPolicy",
             "type": "DynamicFormLayoutPolicy",
-            "description": "Politica opt-in para layout schema-driven transient. Use source=schema apenas quando o backend schema for a fonte canonica do agrupamento; use detailSummary para seleção de campos e densidade responsiva do resumo read-only compacto sem FormConfig.sections locais. Quando o resumo precisar vencer x-ui.width publicado para outras surfaces, use detailSummary.widthPrecedence=summary. Em groupedCommand, orphanFieldExpansion governa linhas com um unico campo; partialRowStrategy=fill-compatible projeta spans compatíveis para completar a linha no breakpoint atual sem alterar x-ui.width ou persistir sections; contextFields identifica campos do request hidratados pela surface que permanecem no payload sem criar controles redundantes."
+            "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 lógicas com um unico campo; partialRowStrategy=fill-compatible projeta spans compatíveis depois de resolver visibilidade responsiva, CSS order e wrap, sem alterar x-ui.width ou persistir sections; contextFields identifica campos do request hidratados pela surface que permanecem no payload sem criar controles redundantes."
           },
           {
             "name": "fieldIconPolicy",
@@ -8838,9 +8838,9 @@
         {
           "chunkIndex": 10,
           "chunkKind": "capabilities",
-          "content": "Schema Capability:\n  - Path: fieldMetadata[].transformDisplayValue\n    Category: transform\n    Kind: expression\n    Description: Transforma valor para exibição.\n\nSchema Capability:\n  - Path: fieldMetadata[].transformSaveValue\n    Category: transform\n    Kind: expression\n    Description: Transforma valor para salvar.\n\nSchema Capability:\n  - Path: fieldMetadata[].textTransformApply\n    Category: transform\n    Kind: enum\n    Description: Quando aplicar transformação de texto.\n\nSchema Capability:\n  - Path: fieldMetadata[].inlineEditing\n    Category: behavior\n    Kind: boolean\n    Description: Permite edição inline (tabelas).\n\nSchema Capability:\n  - Path: fieldMetadata[].unique\n    Category: validation\n    Kind: boolean\n    Description: Valida unicidade no backend.\n\nSchema Capability:\n  - Path: fieldMetadata[].readOnly\n    Category: behavior\n    Kind: boolean\n    Description: Campo somente leitura.\n\nSchema Capability:\n  - Path: fieldMetadata[].disabled\n    Category: behavior\n    Kind: boolean\n    Description: Campo desabilitado.\n\nSchema Capability:\n  - Path: fieldMetadata[].defaultValue\n    Category: data\n    Kind: object\n    Description: Valor inicial do campo.\n\nSchema Capability:\n  - Path: fieldMetadata[].ariaLabel\n    Category: accessibility\n    Kind: string\n    Description: Label para leitores de tela.\n\nSchema Capability:\n  - Path: fieldMetadata[].ariaDescribedBy\n    Category: accessibility\n    Kind: string\n    Description: IDs de descrição acessível.\n\nSchema Capability:\n  - Path: fieldMetadata[].tabIndex\n    Category: accessibility\n    Kind: number\n    Description: Ordem de tabulacao para teclado.\n\nSchema Capability:\n  - Path: fieldMetadata[].accessKey\n    Category: accessibility\n    Kind: string\n    Description: Atalho de teclado (accessKey).\n\nComponent Capability:\n  - Path: inputs.resourcePath\n    Category: inputs\n    Kind: string\n    Description: Caminho do recurso para carregar/salvar dados via CRUD.\n\nComponent Capability:\n  - Path: inputs.resourceId\n    Category: inputs\n    Kind: string\n    Description: ID do registro atual (string ou number).\n\nComponent Capability:\n  - Path: inputs.initialValue\n    Category: inputs\n    Kind: object\n    Description: Valores iniciais locais para campos host-authored ou complementares.\n\nComponent Capability:\n  - Path: inputs.mode\n    Category: inputs\n    Kind: enum\n    Description: Modo do formulario (create/edit/view).\n\nComponent Capability:\n  - Path: inputs.config\n    Category: inputs\n    Kind: object\n    Description: Configuracao completa do formulario (FormConfig).\n\nComponent Capability:\n  - Path: inputs.schemaSource\n    Category: inputs\n    Kind: enum\n    Description: Fonte de schema para construcao automatica (resource/filter).\n\nComponent Capability:\n  - Path: inputs.schemaUrl\n    Category: inputs\n    Kind: string\n    Description: Schema canonico explicito publicado pelo backend para hosts que seguem surfaces/actions/capabilities.\n\nComponent Capability:\n  - Path: inputs.readUrl\n    Category: inputs\n    Kind: string\n    Description: Endpoint canonico de leitura publicado por surface VIEW/READ_PROJECTION para hidratar a entidade exibida.\n\nComponent Capability:\n  - Path: inputs.apiEndpointKey\n    Category: inputs\n    Kind: string\n    Description: Endpoint canonico usado para resolver schemaUrl, readUrl e submitUrl relativos em hosts destacados.\n\nComponent Capability:\n  - Path: inputs.submitUrl\n    Category: inputs\n    Kind: string\n    Description: Endpoint canonico de submit publicado por surface/action.\n\nComponent Capability:\n  - Path: inputs.submitMethod\n    Category: inputs\n    Kind: enum\n    Description: Metodo HTTP canonico para o submit quando o backend publica operacao explicita.\n\nComponent Capability:\n  - Path: inputs.submitIdempotencyKey\n    Category: inputs\n    Kind: string\n    Description: Identidade estavel da tentativa de comando, materializada a partir da politica execution da action.\n\nComponent Capability:\n  - Path: inputs.submitCorrelationId\n    Category: inputs\n    Kind: string\n    Description: Identificador de correlacao governado para rastreabilidade ponta a ponta do comando.\n\nComponent Capability:\n  - Path: inputs.submitResourceVersion\n    Category: inputs\n    Kind: string\n    Description: Versao persistida esperada, transportada como If-Match quando exigida pela action.\n\nComponent Capability:\n  - Path: inputs.responseSchemaUrl\n    Category: inputs\n    Kind: string\n    Description: Schema de resposta publicado pelo backend para inspeção diagnostica/read-only do host.\n\nComponent Capability:\n  - Path: inputs.enableCustomization\n    Category: inputs\n    Kind: boolean\n    Description: Habilita a edicao de layout/configuracao no editor.\n\nComponent Capability:\n  - Path: inputs.showAiAssistant\n    Category: inputs\n    Kind: boolean\n    Description: Mostra os gatilhos do copiloto semantico Praxis para a instancia do formulario.\n\nComponent Capability:\n  - Path: inputs.formId\n    Category: inputs\n    Kind: string\n    Description: ID persistente para salvar configuracoes e preferencias.\n\nComponent Capability:\n  - Path: inputs.editorialContext\n    Category: inputs\n    Kind: object\n    Description: Override de contexto editorial fornecido pelo host para os blocos hospedados antes/depois do formulario.\n\nComponent Capability:\n  - Path: inputs.layout\n    Category: inputs\n    Kind: object\n    Description: Layout legado (FormLayout). Preferir inputs.config + sections.\n\nComponent Capability:\n  - Path: inputs.generatedLayoutPreset\n    Category: inputs\n    Kind: enum\n    Description: Preset usado somente na criacao inicial de FormConfig a partir de schema/metadata.\n\nComponent Capability:\n  - Path: inputs.configPersistenceStrategy\n    Category: inputs\n    Kind: enum\n    Description: Define se preferências locais persistidas ou o contrato explícito do host governam a materialização corrente.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy\n    Category: inputs\n    Kind: object\n    Description: Politica opt-in para materializar layout diretamente do schema atual sem depender de FormConfig.sections authoradas.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.source\n    Category: inputs\n    Kind: enum\n    Description: Define se o layout vem de configuracao authorada ou do schema.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.preset\n    Category: inputs\n    Kind: enum\n    Description: Preset de layout schema-driven. compactPresentation cobre detalhe read-only; groupedCommand cobre create/edit.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.intent\n    Category: inputs\n    Kind: enum\n    Description: Intencao da surface: detalhe/apresentacao ou comando/editavel.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.lifecycle\n    Category: inputs\n    Kind: enum\n    Description: Ciclo de materializacao do layout schema-driven.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.persistence\n    Category: inputs\n    Kind: enum\n    Description: Define se sections geradas sao transient ou podem virar layout authorado apos detach explicito.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.groupedCommand.orphanFieldExpansion\n    Category: inputs\n    Kind: enum\n    Description: Define como uma linha groupedCommand com um unico campo usa o espaco restante. O default medium-and-wide expande spans 6 ou 8 e preserva campos compactos.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.groupedCommand.contextFields\n    Category: inputs\n    Kind: array\n    Description: Campos canônicos do request cujo valor vem do contexto da surface. Eles permanecem no FormGroup e no payload, sem renderizar controles redundantes.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.groupedCommand.partialRowStrategy\n    Category: inputs\n    Kind: enum\n    Description: Define se linhas parciais com dois campos ou mais preservam os spans canônicos ou redistribuem apenas campos compatíveis para completar 12 colunas no breakpoint atual.",
+          "content": "Schema Capability:\n  - Path: fieldMetadata[].transformDisplayValue\n    Category: transform\n    Kind: expression\n    Description: Transforma valor para exibição.\n\nSchema Capability:\n  - Path: fieldMetadata[].transformSaveValue\n    Category: transform\n    Kind: expression\n    Description: Transforma valor para salvar.\n\nSchema Capability:\n  - Path: fieldMetadata[].textTransformApply\n    Category: transform\n    Kind: enum\n    Description: Quando aplicar transformação de texto.\n\nSchema Capability:\n  - Path: fieldMetadata[].inlineEditing\n    Category: behavior\n    Kind: boolean\n    Description: Permite edição inline (tabelas).\n\nSchema Capability:\n  - Path: fieldMetadata[].unique\n    Category: validation\n    Kind: boolean\n    Description: Valida unicidade no backend.\n\nSchema Capability:\n  - Path: fieldMetadata[].readOnly\n    Category: behavior\n    Kind: boolean\n    Description: Campo somente leitura.\n\nSchema Capability:\n  - Path: fieldMetadata[].disabled\n    Category: behavior\n    Kind: boolean\n    Description: Campo desabilitado.\n\nSchema Capability:\n  - Path: fieldMetadata[].defaultValue\n    Category: data\n    Kind: object\n    Description: Valor inicial do campo.\n\nSchema Capability:\n  - Path: fieldMetadata[].ariaLabel\n    Category: accessibility\n    Kind: string\n    Description: Label para leitores de tela.\n\nSchema Capability:\n  - Path: fieldMetadata[].ariaDescribedBy\n    Category: accessibility\n    Kind: string\n    Description: IDs de descrição acessível.\n\nSchema Capability:\n  - Path: fieldMetadata[].tabIndex\n    Category: accessibility\n    Kind: number\n    Description: Ordem de tabulacao para teclado.\n\nSchema Capability:\n  - Path: fieldMetadata[].accessKey\n    Category: accessibility\n    Kind: string\n    Description: Atalho de teclado (accessKey).\n\nComponent Capability:\n  - Path: inputs.resourcePath\n    Category: inputs\n    Kind: string\n    Description: Caminho do recurso para carregar/salvar dados via CRUD.\n\nComponent Capability:\n  - Path: inputs.resourceId\n    Category: inputs\n    Kind: string\n    Description: ID do registro atual (string ou number).\n\nComponent Capability:\n  - Path: inputs.initialValue\n    Category: inputs\n    Kind: object\n    Description: Valores iniciais locais para campos host-authored ou complementares.\n\nComponent Capability:\n  - Path: inputs.mode\n    Category: inputs\n    Kind: enum\n    Description: Modo do formulario (create/edit/view).\n\nComponent Capability:\n  - Path: inputs.config\n    Category: inputs\n    Kind: object\n    Description: Configuracao completa do formulario (FormConfig).\n\nComponent Capability:\n  - Path: inputs.schemaSource\n    Category: inputs\n    Kind: enum\n    Description: Fonte de schema para construcao automatica (resource/filter).\n\nComponent Capability:\n  - Path: inputs.schemaUrl\n    Category: inputs\n    Kind: string\n    Description: Schema canonico explicito publicado pelo backend para hosts que seguem surfaces/actions/capabilities.\n\nComponent Capability:\n  - Path: inputs.readUrl\n    Category: inputs\n    Kind: string\n    Description: Endpoint canonico de leitura publicado por surface VIEW/READ_PROJECTION para hidratar a entidade exibida.\n\nComponent Capability:\n  - Path: inputs.apiEndpointKey\n    Category: inputs\n    Kind: string\n    Description: Endpoint canonico usado para resolver schemaUrl, readUrl e submitUrl relativos em hosts destacados.\n\nComponent Capability:\n  - Path: inputs.submitUrl\n    Category: inputs\n    Kind: string\n    Description: Endpoint canonico de submit publicado por surface/action.\n\nComponent Capability:\n  - Path: inputs.submitMethod\n    Category: inputs\n    Kind: enum\n    Description: Metodo HTTP canonico para o submit quando o backend publica operacao explicita.\n\nComponent Capability:\n  - Path: inputs.submitIdempotencyKey\n    Category: inputs\n    Kind: string\n    Description: Identidade estavel da tentativa de comando, materializada a partir da politica execution da action.\n\nComponent Capability:\n  - Path: inputs.submitCorrelationId\n    Category: inputs\n    Kind: string\n    Description: Identificador de correlacao governado para rastreabilidade ponta a ponta do comando.\n\nComponent Capability:\n  - Path: inputs.submitResourceVersion\n    Category: inputs\n    Kind: string\n    Description: Versao persistida esperada, transportada como If-Match quando exigida pela action.\n\nComponent Capability:\n  - Path: inputs.responseSchemaUrl\n    Category: inputs\n    Kind: string\n    Description: Schema de resposta publicado pelo backend para inspeção diagnostica/read-only do host.\n\nComponent Capability:\n  - Path: inputs.enableCustomization\n    Category: inputs\n    Kind: boolean\n    Description: Habilita a edicao de layout/configuracao no editor.\n\nComponent Capability:\n  - Path: inputs.showAiAssistant\n    Category: inputs\n    Kind: boolean\n    Description: Mostra os gatilhos do copiloto semantico Praxis para a instancia do formulario.\n\nComponent Capability:\n  - Path: inputs.formId\n    Category: inputs\n    Kind: string\n    Description: ID persistente para salvar configuracoes e preferencias.\n\nComponent Capability:\n  - Path: inputs.editorialContext\n    Category: inputs\n    Kind: object\n    Description: Override de contexto editorial fornecido pelo host para os blocos hospedados antes/depois do formulario.\n\nComponent Capability:\n  - Path: inputs.layout\n    Category: inputs\n    Kind: object\n    Description: Layout legado (FormLayout). Preferir inputs.config + sections.\n\nComponent Capability:\n  - Path: inputs.generatedLayoutPreset\n    Category: inputs\n    Kind: enum\n    Description: Preset usado somente na criacao inicial de FormConfig a partir de schema/metadata.\n\nComponent Capability:\n  - Path: inputs.configPersistenceStrategy\n    Category: inputs\n    Kind: enum\n    Description: Define se preferências locais persistidas ou o contrato explícito do host governam a materialização corrente.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy\n    Category: inputs\n    Kind: object\n    Description: Politica opt-in para materializar layout diretamente do schema atual sem depender de FormConfig.sections authoradas.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.source\n    Category: inputs\n    Kind: enum\n    Description: Define se o layout vem de configuracao authorada ou do schema.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.preset\n    Category: inputs\n    Kind: enum\n    Description: Preset de layout schema-driven. compactPresentation cobre detalhe read-only; groupedCommand cobre create/edit.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.intent\n    Category: inputs\n    Kind: enum\n    Description: Intencao da surface: detalhe/apresentacao ou comando/editavel.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.lifecycle\n    Category: inputs\n    Kind: enum\n    Description: Ciclo de materializacao do layout schema-driven.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.persistence\n    Category: inputs\n    Kind: enum\n    Description: Define se sections geradas sao transient ou podem virar layout authorado apos detach explicito.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.groupedCommand.orphanFieldExpansion\n    Category: inputs\n    Kind: enum\n    Description: Define como uma linha groupedCommand com um unico campo usa o espaco restante. O default medium-and-wide expande spans 6 ou 8 e preserva campos compactos.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.groupedCommand.contextFields\n    Category: inputs\n    Kind: array\n    Description: Campos canônicos do request cujo valor vem do contexto da surface. Eles permanecem no FormGroup e no payload, sem renderizar controles redundantes.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.groupedCommand.partialRowStrategy\n    Category: inputs\n    Kind: enum\n    Description: Define se cada linha visual parcial, depois de resolver visibilidade responsiva, CSS order e wrap, preserva os spans canônicos ou redistribui apenas campos compatíveis para completar 12 colunas no breakpoint atual.",
           "sourcePointer": "projects/praxis-dynamic-form/src/lib/ai/form-component-ai-capabilities.ts",
-          "contentHash": "d8ba06c1f0006e7d3189b75d8329245c840d75d84d753c6dfccc480a4880d347",
+          "contentHash": "a05a482e5873ff1de353543220891daaa3867cea957150def37ea50539a20c21",
           "sourceKind": "component_definition",
           "sourceId": "praxis-dynamic-form",
           "corpusVersion": "1.0.0"
@@ -9158,9 +9158,9 @@
         {
           "chunkIndex": 42,
           "chunkKind": "authoring_manifest",
-          "content": "{\"schemaVersion\":\"1.0.0\",\"manifestVersion\":\"1.5.2\",\"componentId\":\"praxis-dynamic-form\",\"ownerPackage\":\"@praxisui/dynamic-form\",\"configSchemaId\":\"FormConfig\",\"chunkSection\":\"runtimeInputs\",\"runtimeInputs\":[{\"name\":\"showAiAssistant\",\"type\":\"boolean\",\"description\":\"Mostra os gatilhos do copiloto semantico Praxis\"},{\"name\":\"config\",\"type\":\"FormConfig\",\"description\":\"Configuração do formulário; sections é opcional em forms schema-driven e não deve ser criado como array vazio apenas para satisfazer TypeScript.\"},{\"name\":\"resourcePath\",\"type\":\"string\",\"description\":\"Caminho do recurso (API)\"},{\"name\":\"readUrl\",\"type\":\"string\",\"description\":\"Endpoint canonico de leitura para surfaces VIEW/READ_PROJECTION\"},{\"name\":\"mode\",\"type\":\"string\",\"allowedValues\":[\"create\",\"edit\",\"view\"],\"description\":\"Modo de operação\"},{\"name\":\"configPersistenceStrategy\",\"type\":\"string\",\"allowedValues\":[\"local-first\",\"input-first\"],\"description\":\"Precedência entre configuração persistida e contrato explícito do host. Use input-first em dialogs e surfaces transitórias governadas por schema para preservar mode e estados operacionais publicados pelo servidor.\"},{\"name\":\"generatedLayoutPreset\",\"type\":\"string\",\"allowedValues\":[\"default\",\"compactPresentation\"],\"description\":\"Preset usado apenas ao gerar a configuracao inicial a partir de metadata/schema; nao reprocessa layouts persistidos ou autorados.\"},{\"name\":\"layoutPolicy\",\"type\":\"DynamicFormLayoutPolicy\",\"description\":\"Politica opt-in para layout schema-driven transient. Use source=schema apenas quando o backend schema for a fonte canonica do agrupamento; use detailSummary para seleção de campos e densidade responsiva do resumo read-only compacto sem FormConfig.sections locais. Quando o resumo precisar vencer x-ui.width publicado para outras surfaces, use detailSummary.widthPrecedence=summary. Em groupedCommand, orphanFieldExpansion governa linhas com um unico campo; partialRowStrategy=fill-compatible projeta spans compatíveis para completar a linha no breakpoint atual sem alterar x-ui.width ou persistir sections; contextFields identifica campos do request hidratados pela surface que permanecem no payload sem criar controles redundantes.\"},{\"name\":\"fieldIconPolicy\",\"type\":\"string\",\"allowedValues\":[\"all\",\"presentation-only\",\"none\"],\"description\":\"Politica visual do host para icones prefix/suffix de campos vindos da metadata. Use presentation-only para manter icones decorativos em apresentacao e ocultar em controles tradicionais.\"},{\"name\":\"enableCustomization\",\"type\":\"boolean\",\"description\":\"Habilita edição visual\"}]}",
+          "content": "{\"schemaVersion\":\"1.0.0\",\"manifestVersion\":\"1.5.2\",\"componentId\":\"praxis-dynamic-form\",\"ownerPackage\":\"@praxisui/dynamic-form\",\"configSchemaId\":\"FormConfig\",\"chunkSection\":\"runtimeInputs\",\"runtimeInputs\":[{\"name\":\"showAiAssistant\",\"type\":\"boolean\",\"description\":\"Mostra os gatilhos do copiloto semantico Praxis\"},{\"name\":\"config\",\"type\":\"FormConfig\",\"description\":\"Configuração do formulário; sections é opcional em forms schema-driven e não deve ser criado como array vazio apenas para satisfazer TypeScript.\"},{\"name\":\"resourcePath\",\"type\":\"string\",\"description\":\"Caminho do recurso (API)\"},{\"name\":\"readUrl\",\"type\":\"string\",\"description\":\"Endpoint canonico de leitura para surfaces VIEW/READ_PROJECTION\"},{\"name\":\"mode\",\"type\":\"string\",\"allowedValues\":[\"create\",\"edit\",\"view\"],\"description\":\"Modo de operação\"},{\"name\":\"configPersistenceStrategy\",\"type\":\"string\",\"allowedValues\":[\"local-first\",\"input-first\"],\"description\":\"Precedência entre configuração persistida e contrato explícito do host. Use input-first em dialogs e surfaces transitórias governadas por schema para preservar mode e estados operacionais publicados pelo servidor.\"},{\"name\":\"generatedLayoutPreset\",\"type\":\"string\",\"allowedValues\":[\"default\",\"compactPresentation\"],\"description\":\"Preset usado apenas ao gerar a configuracao inicial a partir de metadata/schema; nao reprocessa layouts persistidos ou autorados.\"},{\"name\":\"layoutPolicy\",\"type\":\"DynamicFormLayoutPolicy\",\"description\":\"Politica opt-in para layout schema-driven transient. Use source=schema apenas quando o backend schema for a fonte canonica do agrupamento; use detailSummary para seleção de campos e densidade responsiva do resumo read-only compacto sem FormConfig.sections locais. Quando o resumo precisar vencer x-ui.width publicado para outras surfaces, use detailSummary.widthPrecedence=summary. Em groupedCommand, orphanFieldExpansion governa linhas lógicas com um unico campo; partialRowStrategy=fill-compatible projeta spans compatíveis depois de resolver visibilidade responsiva, CSS order e wrap, sem alterar x-ui.width ou persistir sections; contextFields identifica campos do request hidratados pela surface que permanecem no payload sem criar controles redundantes.\"},{\"name\":\"fieldIconPolicy\",\"type\":\"string\",\"allowedValues\":[\"all\",\"presentation-only\",\"none\"],\"description\":\"Politica visual do host para icones prefix/suffix de campos vindos da metadata. Use presentation-only para manter icones decorativos em apresentacao e ocultar em controles tradicionais.\"},{\"name\":\"enableCustomization\",\"type\":\"boolean\",\"description\":\"Habilita edição visual\"}]}",
           "sourcePointer": "projects/praxis-dynamic-form/src/lib/ai/praxis-dynamic-form-authoring-manifest.ts",
-          "contentHash": "e93fea57af79dd4c3555659189c928b88f2e847c23e33fef63f17d412bc7aeca",
+          "contentHash": "d65e2e7470159c7bfff6a2080b230f50f45ae48b8da585e163ce78fa9f4fd605",
           "sourceKind": "component_definition",
           "sourceId": "praxis-dynamic-form",
           "corpusVersion": "1.0.0"
@@ -13697,7 +13697,7 @@
             "preserve",
             "fill-compatible"
           ],
-          "description": "Define se linhas parciais com dois campos ou mais preservam os spans canônicos ou redistribuem apenas campos compatíveis para completar 12 colunas no breakpoint atual.",
+          "description": "Define se cada linha visual parcial, depois de resolver visibilidade responsiva, CSS order e wrap, preserva os spans canônicos ou redistribui apenas campos compatíveis para completar 12 colunas no breakpoint atual.",
           "safetyNotes": "fill-compatible é uma projeção transitória do runtime: não altera x-ui.width nem persiste sections. Controles compactos, uploads e tipos desconhecidos preservam a largura canônica."
         },
         {
@@ -15687,9 +15687,9 @@
         {
           "chunkIndex": 10,
           "chunkKind": "capabilities",
-          "content": "Schema Capability:\n  - Path: fieldMetadata[].transformDisplayValue\n    Category: transform\n    Kind: expression\n    Description: Transforma valor para exibição.\n\nSchema Capability:\n  - Path: fieldMetadata[].transformSaveValue\n    Category: transform\n    Kind: expression\n    Description: Transforma valor para salvar.\n\nSchema Capability:\n  - Path: fieldMetadata[].textTransformApply\n    Category: transform\n    Kind: enum\n    Description: Quando aplicar transformação de texto.\n\nSchema Capability:\n  - Path: fieldMetadata[].inlineEditing\n    Category: behavior\n    Kind: boolean\n    Description: Permite edição inline (tabelas).\n\nSchema Capability:\n  - Path: fieldMetadata[].unique\n    Category: validation\n    Kind: boolean\n    Description: Valida unicidade no backend.\n\nSchema Capability:\n  - Path: fieldMetadata[].readOnly\n    Category: behavior\n    Kind: boolean\n    Description: Campo somente leitura.\n\nSchema Capability:\n  - Path: fieldMetadata[].disabled\n    Category: behavior\n    Kind: boolean\n    Description: Campo desabilitado.\n\nSchema Capability:\n  - Path: fieldMetadata[].defaultValue\n    Category: data\n    Kind: object\n    Description: Valor inicial do campo.\n\nSchema Capability:\n  - Path: fieldMetadata[].ariaLabel\n    Category: accessibility\n    Kind: string\n    Description: Label para leitores de tela.\n\nSchema Capability:\n  - Path: fieldMetadata[].ariaDescribedBy\n    Category: accessibility\n    Kind: string\n    Description: IDs de descrição acessível.\n\nSchema Capability:\n  - Path: fieldMetadata[].tabIndex\n    Category: accessibility\n    Kind: number\n    Description: Ordem de tabulacao para teclado.\n\nSchema Capability:\n  - Path: fieldMetadata[].accessKey\n    Category: accessibility\n    Kind: string\n    Description: Atalho de teclado (accessKey).\n\nComponent Capability:\n  - Path: inputs.resourcePath\n    Category: inputs\n    Kind: string\n    Description: Caminho do recurso para carregar/salvar dados via CRUD.\n\nComponent Capability:\n  - Path: inputs.resourceId\n    Category: inputs\n    Kind: string\n    Description: ID do registro atual (string ou number).\n\nComponent Capability:\n  - Path: inputs.initialValue\n    Category: inputs\n    Kind: object\n    Description: Valores iniciais locais para campos host-authored ou complementares.\n\nComponent Capability:\n  - Path: inputs.mode\n    Category: inputs\n    Kind: enum\n    Description: Modo do formulario (create/edit/view).\n\nComponent Capability:\n  - Path: inputs.config\n    Category: inputs\n    Kind: object\n    Description: Configuracao completa do formulario (FormConfig).\n\nComponent Capability:\n  - Path: inputs.schemaSource\n    Category: inputs\n    Kind: enum\n    Description: Fonte de schema para construcao automatica (resource/filter).\n\nComponent Capability:\n  - Path: inputs.schemaUrl\n    Category: inputs\n    Kind: string\n    Description: Schema canonico explicito publicado pelo backend para hosts que seguem surfaces/actions/capabilities.\n\nComponent Capability:\n  - Path: inputs.readUrl\n    Category: inputs\n    Kind: string\n    Description: Endpoint canonico de leitura publicado por surface VIEW/READ_PROJECTION para hidratar a entidade exibida.\n\nComponent Capability:\n  - Path: inputs.apiEndpointKey\n    Category: inputs\n    Kind: string\n    Description: Endpoint canonico usado para resolver schemaUrl, readUrl e submitUrl relativos em hosts destacados.\n\nComponent Capability:\n  - Path: inputs.submitUrl\n    Category: inputs\n    Kind: string\n    Description: Endpoint canonico de submit publicado por surface/action.\n\nComponent Capability:\n  - Path: inputs.submitMethod\n    Category: inputs\n    Kind: enum\n    Description: Metodo HTTP canonico para o submit quando o backend publica operacao explicita.\n\nComponent Capability:\n  - Path: inputs.submitIdempotencyKey\n    Category: inputs\n    Kind: string\n    Description: Identidade estavel da tentativa de comando, materializada a partir da politica execution da action.\n\nComponent Capability:\n  - Path: inputs.submitCorrelationId\n    Category: inputs\n    Kind: string\n    Description: Identificador de correlacao governado para rastreabilidade ponta a ponta do comando.\n\nComponent Capability:\n  - Path: inputs.submitResourceVersion\n    Category: inputs\n    Kind: string\n    Description: Versao persistida esperada, transportada como If-Match quando exigida pela action.\n\nComponent Capability:\n  - Path: inputs.responseSchemaUrl\n    Category: inputs\n    Kind: string\n    Description: Schema de resposta publicado pelo backend para inspeção diagnostica/read-only do host.\n\nComponent Capability:\n  - Path: inputs.enableCustomization\n    Category: inputs\n    Kind: boolean\n    Description: Habilita a edicao de layout/configuracao no editor.\n\nComponent Capability:\n  - Path: inputs.showAiAssistant\n    Category: inputs\n    Kind: boolean\n    Description: Mostra os gatilhos do copiloto semantico Praxis para a instancia do formulario.\n\nComponent Capability:\n  - Path: inputs.formId\n    Category: inputs\n    Kind: string\n    Description: ID persistente para salvar configuracoes e preferencias.\n\nComponent Capability:\n  - Path: inputs.editorialContext\n    Category: inputs\n    Kind: object\n    Description: Override de contexto editorial fornecido pelo host para os blocos hospedados antes/depois do formulario.\n\nComponent Capability:\n  - Path: inputs.layout\n    Category: inputs\n    Kind: object\n    Description: Layout legado (FormLayout). Preferir inputs.config + sections.\n\nComponent Capability:\n  - Path: inputs.generatedLayoutPreset\n    Category: inputs\n    Kind: enum\n    Description: Preset usado somente na criacao inicial de FormConfig a partir de schema/metadata.\n\nComponent Capability:\n  - Path: inputs.configPersistenceStrategy\n    Category: inputs\n    Kind: enum\n    Description: Define se preferências locais persistidas ou o contrato explícito do host governam a materialização corrente.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy\n    Category: inputs\n    Kind: object\n    Description: Politica opt-in para materializar layout diretamente do schema atual sem depender de FormConfig.sections authoradas.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.source\n    Category: inputs\n    Kind: enum\n    Description: Define se o layout vem de configuracao authorada ou do schema.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.preset\n    Category: inputs\n    Kind: enum\n    Description: Preset de layout schema-driven. compactPresentation cobre detalhe read-only; groupedCommand cobre create/edit.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.intent\n    Category: inputs\n    Kind: enum\n    Description: Intencao da surface: detalhe/apresentacao ou comando/editavel.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.lifecycle\n    Category: inputs\n    Kind: enum\n    Description: Ciclo de materializacao do layout schema-driven.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.persistence\n    Category: inputs\n    Kind: enum\n    Description: Define se sections geradas sao transient ou podem virar layout authorado apos detach explicito.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.groupedCommand.orphanFieldExpansion\n    Category: inputs\n    Kind: enum\n    Description: Define como uma linha groupedCommand com um unico campo usa o espaco restante. O default medium-and-wide expande spans 6 ou 8 e preserva campos compactos.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.groupedCommand.contextFields\n    Category: inputs\n    Kind: array\n    Description: Campos canônicos do request cujo valor vem do contexto da surface. Eles permanecem no FormGroup e no payload, sem renderizar controles redundantes.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.groupedCommand.partialRowStrategy\n    Category: inputs\n    Kind: enum\n    Description: Define se linhas parciais com dois campos ou mais preservam os spans canônicos ou redistribuem apenas campos compatíveis para completar 12 colunas no breakpoint atual.",
+          "content": "Schema Capability:\n  - Path: fieldMetadata[].transformDisplayValue\n    Category: transform\n    Kind: expression\n    Description: Transforma valor para exibição.\n\nSchema Capability:\n  - Path: fieldMetadata[].transformSaveValue\n    Category: transform\n    Kind: expression\n    Description: Transforma valor para salvar.\n\nSchema Capability:\n  - Path: fieldMetadata[].textTransformApply\n    Category: transform\n    Kind: enum\n    Description: Quando aplicar transformação de texto.\n\nSchema Capability:\n  - Path: fieldMetadata[].inlineEditing\n    Category: behavior\n    Kind: boolean\n    Description: Permite edição inline (tabelas).\n\nSchema Capability:\n  - Path: fieldMetadata[].unique\n    Category: validation\n    Kind: boolean\n    Description: Valida unicidade no backend.\n\nSchema Capability:\n  - Path: fieldMetadata[].readOnly\n    Category: behavior\n    Kind: boolean\n    Description: Campo somente leitura.\n\nSchema Capability:\n  - Path: fieldMetadata[].disabled\n    Category: behavior\n    Kind: boolean\n    Description: Campo desabilitado.\n\nSchema Capability:\n  - Path: fieldMetadata[].defaultValue\n    Category: data\n    Kind: object\n    Description: Valor inicial do campo.\n\nSchema Capability:\n  - Path: fieldMetadata[].ariaLabel\n    Category: accessibility\n    Kind: string\n    Description: Label para leitores de tela.\n\nSchema Capability:\n  - Path: fieldMetadata[].ariaDescribedBy\n    Category: accessibility\n    Kind: string\n    Description: IDs de descrição acessível.\n\nSchema Capability:\n  - Path: fieldMetadata[].tabIndex\n    Category: accessibility\n    Kind: number\n    Description: Ordem de tabulacao para teclado.\n\nSchema Capability:\n  - Path: fieldMetadata[].accessKey\n    Category: accessibility\n    Kind: string\n    Description: Atalho de teclado (accessKey).\n\nComponent Capability:\n  - Path: inputs.resourcePath\n    Category: inputs\n    Kind: string\n    Description: Caminho do recurso para carregar/salvar dados via CRUD.\n\nComponent Capability:\n  - Path: inputs.resourceId\n    Category: inputs\n    Kind: string\n    Description: ID do registro atual (string ou number).\n\nComponent Capability:\n  - Path: inputs.initialValue\n    Category: inputs\n    Kind: object\n    Description: Valores iniciais locais para campos host-authored ou complementares.\n\nComponent Capability:\n  - Path: inputs.mode\n    Category: inputs\n    Kind: enum\n    Description: Modo do formulario (create/edit/view).\n\nComponent Capability:\n  - Path: inputs.config\n    Category: inputs\n    Kind: object\n    Description: Configuracao completa do formulario (FormConfig).\n\nComponent Capability:\n  - Path: inputs.schemaSource\n    Category: inputs\n    Kind: enum\n    Description: Fonte de schema para construcao automatica (resource/filter).\n\nComponent Capability:\n  - Path: inputs.schemaUrl\n    Category: inputs\n    Kind: string\n    Description: Schema canonico explicito publicado pelo backend para hosts que seguem surfaces/actions/capabilities.\n\nComponent Capability:\n  - Path: inputs.readUrl\n    Category: inputs\n    Kind: string\n    Description: Endpoint canonico de leitura publicado por surface VIEW/READ_PROJECTION para hidratar a entidade exibida.\n\nComponent Capability:\n  - Path: inputs.apiEndpointKey\n    Category: inputs\n    Kind: string\n    Description: Endpoint canonico usado para resolver schemaUrl, readUrl e submitUrl relativos em hosts destacados.\n\nComponent Capability:\n  - Path: inputs.submitUrl\n    Category: inputs\n    Kind: string\n    Description: Endpoint canonico de submit publicado por surface/action.\n\nComponent Capability:\n  - Path: inputs.submitMethod\n    Category: inputs\n    Kind: enum\n    Description: Metodo HTTP canonico para o submit quando o backend publica operacao explicita.\n\nComponent Capability:\n  - Path: inputs.submitIdempotencyKey\n    Category: inputs\n    Kind: string\n    Description: Identidade estavel da tentativa de comando, materializada a partir da politica execution da action.\n\nComponent Capability:\n  - Path: inputs.submitCorrelationId\n    Category: inputs\n    Kind: string\n    Description: Identificador de correlacao governado para rastreabilidade ponta a ponta do comando.\n\nComponent Capability:\n  - Path: inputs.submitResourceVersion\n    Category: inputs\n    Kind: string\n    Description: Versao persistida esperada, transportada como If-Match quando exigida pela action.\n\nComponent Capability:\n  - Path: inputs.responseSchemaUrl\n    Category: inputs\n    Kind: string\n    Description: Schema de resposta publicado pelo backend para inspeção diagnostica/read-only do host.\n\nComponent Capability:\n  - Path: inputs.enableCustomization\n    Category: inputs\n    Kind: boolean\n    Description: Habilita a edicao de layout/configuracao no editor.\n\nComponent Capability:\n  - Path: inputs.showAiAssistant\n    Category: inputs\n    Kind: boolean\n    Description: Mostra os gatilhos do copiloto semantico Praxis para a instancia do formulario.\n\nComponent Capability:\n  - Path: inputs.formId\n    Category: inputs\n    Kind: string\n    Description: ID persistente para salvar configuracoes e preferencias.\n\nComponent Capability:\n  - Path: inputs.editorialContext\n    Category: inputs\n    Kind: object\n    Description: Override de contexto editorial fornecido pelo host para os blocos hospedados antes/depois do formulario.\n\nComponent Capability:\n  - Path: inputs.layout\n    Category: inputs\n    Kind: object\n    Description: Layout legado (FormLayout). Preferir inputs.config + sections.\n\nComponent Capability:\n  - Path: inputs.generatedLayoutPreset\n    Category: inputs\n    Kind: enum\n    Description: Preset usado somente na criacao inicial de FormConfig a partir de schema/metadata.\n\nComponent Capability:\n  - Path: inputs.configPersistenceStrategy\n    Category: inputs\n    Kind: enum\n    Description: Define se preferências locais persistidas ou o contrato explícito do host governam a materialização corrente.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy\n    Category: inputs\n    Kind: object\n    Description: Politica opt-in para materializar layout diretamente do schema atual sem depender de FormConfig.sections authoradas.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.source\n    Category: inputs\n    Kind: enum\n    Description: Define se o layout vem de configuracao authorada ou do schema.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.preset\n    Category: inputs\n    Kind: enum\n    Description: Preset de layout schema-driven. compactPresentation cobre detalhe read-only; groupedCommand cobre create/edit.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.intent\n    Category: inputs\n    Kind: enum\n    Description: Intencao da surface: detalhe/apresentacao ou comando/editavel.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.lifecycle\n    Category: inputs\n    Kind: enum\n    Description: Ciclo de materializacao do layout schema-driven.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.persistence\n    Category: inputs\n    Kind: enum\n    Description: Define se sections geradas sao transient ou podem virar layout authorado apos detach explicito.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.groupedCommand.orphanFieldExpansion\n    Category: inputs\n    Kind: enum\n    Description: Define como uma linha groupedCommand com um unico campo usa o espaco restante. O default medium-and-wide expande spans 6 ou 8 e preserva campos compactos.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.groupedCommand.contextFields\n    Category: inputs\n    Kind: array\n    Description: Campos canônicos do request cujo valor vem do contexto da surface. Eles permanecem no FormGroup e no payload, sem renderizar controles redundantes.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.groupedCommand.partialRowStrategy\n    Category: inputs\n    Kind: enum\n    Description: Define se cada linha visual parcial, depois de resolver visibilidade responsiva, CSS order e wrap, preserva os spans canônicos ou redistribui apenas campos compatíveis para completar 12 colunas no breakpoint atual.",
           "sourcePointer": "projects/praxis-dynamic-form/src/lib/ai/form-ai-capabilities.ts",
-          "contentHash": "d8ba06c1f0006e7d3189b75d8329245c840d75d84d753c6dfccc480a4880d347",
+          "contentHash": "a05a482e5873ff1de353543220891daaa3867cea957150def37ea50539a20c21",
           "sourceKind": "component_definition",
           "sourceId": "praxis-filter-form",
           "corpusVersion": "1.0.0"

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

@@ -118,6 +118,7 @@ export interface DynamicFormDetailSummaryPolicy {
 
 export interface DynamicFormGroupedCommandPolicy {
   orphanFieldExpansion?: 'preserve' | 'medium-and-wide' | 'all';
+  partialRowStrategy?: 'preserve' | 'fill-compatible';
   /**
    * Schema field names whose values are supplied by the surrounding business
    * context. They remain in the FormGroup and submit payload, but are omitted
@@ -226,7 +227,7 @@ Expected behavior:
 - Use full-width rows for long text, descriptions, multiline controls and high-density option controls when needed.
 - Use compact clusters for booleans, short enums and small numeric fields.
 - Expand an otherwise orphan medium/wide field to the full row by default, while preserving compact `xs`/`sm` fields. Use `groupedCommand.orphanFieldExpansion = "preserve"` when the empty space is intentional, or `"all"` when compact orphan fields must also fill the row.
-- Preserve multi-field partial rows by default. `groupedCommand.partialRowStrategy = "fill-compatible"` distributes the remainder deterministically through canonical spans (`3`, `4`, `6`, `8`, `12`) at each container breakpoint. It does not mutate schema widths or authoring documents; compact boolean/action controls, uploads and unknown control types are ineligible.
+- Preserve partial rows by default. `groupedCommand.partialRowStrategy = "fill-compatible"` partitions the group into the visual rows produced at each container breakpoint, after responsive visibility and CSS `order` are resolved, and distributes each row remainder deterministically through canonical spans (`3`, `4`, `6`, `8`, `12`). Projected spans are mapped back to authored columns only for rendering. An eligible singleton created by responsive wrapping can fill its visual row; a logical single-field row continues to follow `orphanFieldExpansion`. The projection does not mutate schema widths or authoring documents; compact boolean/action controls, uploads and unknown control types are ineligible.
 - Omit fields listed in `groupedCommand.contextFields` from the interactive layout while retaining their schema metadata, runtime control and submit value. Use this only when the surrounding surface already establishes the value, such as a selected employee opening a related-resource command; it is not a substitute for authorization, validation or backend ownership.
 - Keep validation feedback near the field that caused it.
 - Prefer editable controls over presentation roles.

package/fesm2022/praxisui-dynamic-form.mjs

@@ -23,7 +23,7 @@ import { MatBadgeModule } from '@angular/material/badge';
 import { map, firstValueFrom, BehaviorSubject, Subject, throwError, Subscription, combineLatest, debounceTime as debounceTime$1, takeUntil as takeUntil$1 } from 'rxjs';
 import { map as map$1, takeUntil, skip, take, timeout, tap, debounceTime, startWith, finalize } from 'rxjs/operators';
 import * as i1 from '@praxisui/core';
-import { serializeEntityLookupValueForPayload, PraxisI18nService, PraxisIconButtonComponent, PraxisIconDirective, providePraxisI18nConfig, RULE_PROPERTY_SCHEMA, FIELD_METADATA_CAPABILITIES, migrateFormLayoutRule, PraxisJsonLogicService, normalizeFormLayoutItems, deepMerge, createDefaultFormConfig, normalizeFormConfig as normalizeFormConfig$1, ensureIds, createEmptyRichContentDocument, resolveSpan, resolveGroupedCommandPartialRowSpans, isPraxisRuntimeGlobalActionEffect, ASYNC_CONFIG_STORAGE, withFormConfigSections, createFieldLayoutItem, getFormLayoutFieldNames, LoggerService, createCorporateLoggerConfig, ConsoleLoggerSink, GlobalActionService, ResourceQuickConnectComponent, composeHeadersWithVersion, buildApiUrl, mapFieldDefinitionsToMetadata, reconcileFormConfig, materializeFormLayoutFromMetadata, syncWithServerMetadata, PRAXIS_LOADING_CTX, evaluateFieldAccess, normalizeControlTypeKey, normalizePraxisEffectPolicy, buildPraxisEffectDistinctKey, getFormColumnFieldNames, resolveHidden, resolveOffset, resolveOrder, buildSchemaIdStorageKeySegment, buildSchemaId, fetchWithETag, resolveControlTypeAlias, getTextTransformer, MemoryCacheAdapter, LocalStorageCacheAdapter, SchemaMetadataClient, CONNECTION_STORAGE, API_URL, PRAXIS_LOADING_RENDERER, FORM_HOOKS_PRESETS, EmptyStateCardComponent, isValidFormConfig, ComponentMetadataRegistry, FieldControlType, isRequiredGlobalActionPayloadMissing, GLOBAL_ACTION_CATALOG, PRAXIS_GLOBAL_ACTION_CATALOG, getGlobalActionCatalog, SURFACE_OPEN_I18N_NAMESPACE, getGlobalActionUiSchema, getRequiredGlobalActionPayloadKeys, hasMeaningfulGlobalActionPayloadValue, SurfaceOpenActionEditorComponent, SURFACE_OPEN_I18N_CONFIG, validateGlobalActionRefs, normalizeFormMetadata } from '@praxisui/core';
+import { serializeEntityLookupValueForPayload, PraxisI18nService, PraxisIconButtonComponent, PraxisIconDirective, providePraxisI18nConfig, RULE_PROPERTY_SCHEMA, FIELD_METADATA_CAPABILITIES, migrateFormLayoutRule, PraxisJsonLogicService, normalizeFormLayoutItems, deepMerge, createDefaultFormConfig, normalizeFormConfig as normalizeFormConfig$1, ensureIds, createEmptyRichContentDocument, resolveHidden, resolveOrder, resolveSpan, projectGroupedCommandPartialRows, isPraxisRuntimeGlobalActionEffect, ASYNC_CONFIG_STORAGE, withFormConfigSections, createFieldLayoutItem, getFormLayoutFieldNames, LoggerService, createCorporateLoggerConfig, ConsoleLoggerSink, GlobalActionService, ResourceQuickConnectComponent, composeHeadersWithVersion, buildApiUrl, mapFieldDefinitionsToMetadata, reconcileFormConfig, materializeFormLayoutFromMetadata, syncWithServerMetadata, PRAXIS_LOADING_CTX, evaluateFieldAccess, normalizeControlTypeKey, normalizePraxisEffectPolicy, buildPraxisEffectDistinctKey, getFormColumnFieldNames, resolveGroupedCommandPartialRowSpans, resolveOffset, buildSchemaIdStorageKeySegment, buildSchemaId, fetchWithETag, resolveControlTypeAlias, getTextTransformer, MemoryCacheAdapter, LocalStorageCacheAdapter, SchemaMetadataClient, CONNECTION_STORAGE, API_URL, PRAXIS_LOADING_RENDERER, FORM_HOOKS_PRESETS, EmptyStateCardComponent, isValidFormConfig, ComponentMetadataRegistry, FieldControlType, isRequiredGlobalActionPayloadMissing, GLOBAL_ACTION_CATALOG, PRAXIS_GLOBAL_ACTION_CATALOG, getGlobalActionCatalog, SURFACE_OPEN_I18N_NAMESPACE, getGlobalActionUiSchema, getRequiredGlobalActionPayloadKeys, hasMeaningfulGlobalActionPayloadValue, SurfaceOpenActionEditorComponent, SURFACE_OPEN_I18N_CONFIG, validateGlobalActionRefs, normalizeFormMetadata } from '@praxisui/core';
 import * as i1$1 from '@praxisui/dynamic-fields';
 import { getControlTypeCatalog, ConfirmDialogComponent, DynamicFieldLoaderDirective } from '@praxisui/dynamic-fields';
 import { BaseAiAdapter, AgenticAuthoringTurnClientService, PraxisAssistantSessionRegistryService, PraxisAssistantTurnOrchestratorService, createPraxisAssistantViewportLayout, PraxisAiAssistantShellComponent } from '@praxisui/ai';
@@ -6032,7 +6032,7 @@ const PRAXIS_DYNAMIC_FORM_AUTHORING_MANIFEST = {
         { name: 'mode', type: 'string', allowedValues: ['create', 'edit', 'view'], description: 'Modo de operação' },
         { name: 'configPersistenceStrategy', type: 'string', allowedValues: ['local-first', 'input-first'], description: 'Precedência entre configuração persistida e contrato explícito do host. Use input-first em dialogs e surfaces transitórias governadas por schema para preservar mode e estados operacionais publicados pelo servidor.' },
         { name: 'generatedLayoutPreset', type: 'string', allowedValues: ['default', 'compactPresentation'], description: 'Preset usado apenas ao gerar a configuracao inicial a partir de metadata/schema; nao reprocessa layouts persistidos ou autorados.' },
-        { name: 'layoutPolicy', type: 'DynamicFormLayoutPolicy', description: 'Politica opt-in para layout schema-driven transient. Use source=schema apenas quando o backend schema for a fonte canonica do agrupamento; use detailSummary para seleção de campos e densidade responsiva do resumo read-only compacto sem FormConfig.sections locais. Quando o resumo precisar vencer x-ui.width publicado para outras surfaces, use detailSummary.widthPrecedence=summary. Em groupedCommand, orphanFieldExpansion governa linhas com um unico campo; partialRowStrategy=fill-compatible projeta spans compatíveis para completar a linha no breakpoint atual sem alterar x-ui.width ou persistir sections; contextFields identifica campos do request hidratados pela surface que permanecem no payload sem criar controles redundantes.' },
+        { 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 lógicas com um unico campo; partialRowStrategy=fill-compatible projeta spans compatíveis depois de resolver visibilidade responsiva, CSS order e wrap, sem alterar x-ui.width ou persistir sections; contextFields identifica campos do request hidratados pela surface que permanecem no payload sem criar controles redundantes.' },
         { name: 'fieldIconPolicy', type: 'string', allowedValues: ['all', 'presentation-only', 'none'], description: 'Politica visual do host para icones prefix/suffix de campos vindos da metadata. Use presentation-only para manter icones decorativos em apresentacao e ocultar em controles tradicionais.' },
         { name: 'enableCustomization', type: 'boolean', description: 'Habilita edição visual' }
     ],
@@ -8223,18 +8223,28 @@ function diagnoseIncompleteGroupedCommandRows(config, diagnostics) {
                 return;
             const incomplete = ['md', 'lg', 'xl']
                 .map((breakpoint) => {
-                const candidates = row.columns.map((column) => ({
+                const candidates = row.columns
+                    .filter((column) => !resolveHidden(column?.hidden)[breakpoint])
+                    .map((column) => ({
                     span: resolveSpan(column?.span)[breakpoint],
+                    order: resolveOrder(column?.order)[breakpoint],
                     controlType: metadataByName.get(column.fields?.[0] || '')?.controlType,
                 }));
-                const resolved = resolveGroupedCommandPartialRowSpans(candidates, strategy);
+                const projection = projectGroupedCommandPartialRows(candidates, strategy);
+                const partialRow = projection.visualRows.find((visualRow) => {
+                    const occupied = visualRow.canonicalSpans.reduce((total, span) => total + span, 0);
+                    const effective = visualRow.projectedSpans.reduce((total, span) => total + span, 0);
+                    return occupied < 12 && effective < 12;
+                });
+                if (!partialRow)
+                    return null;
                 return {
                     breakpoint,
-                    occupied: candidates.reduce((total, candidate) => total + candidate.span, 0),
-                    effective: resolved.reduce((total, span) => total + span, 0),
+                    occupied: partialRow.canonicalSpans.reduce((total, span) => total + span, 0),
+                    effective: partialRow.projectedSpans.reduce((total, span) => total + span, 0),
                 };
             })
-                .find((result) => result.occupied < 12 && result.effective < 12);
+                .find((result) => result != null);
             if (!incomplete)
                 return;
             diagnostics.push(warnDiagnostic('dynamicForm.config.layout.groupedCommand.row.incomplete', strategy === 'fill-compatible'
@@ -14555,6 +14565,7 @@ class PraxisDynamicForm {
                 return {
                     span: candidateSpan[breakpoint],
                     controlType: this.getColumnControlType(candidate),
+                    order: resolveOrder(this.getEffectiveColumn(candidate).order)[breakpoint],
                 };
             }), strategy);
             projected[breakpoint] = resolved[targetIndex];
@@ -35317,7 +35328,7 @@ const FORM_COMPONENT_AI_CAPABILITIES = {
             category: 'inputs',
             valueKind: 'enum',
             allowedValues: ENUMS.layoutPolicyPartialRowStrategy,
-            description: 'Define se linhas parciais com dois campos ou mais preservam os spans canônicos ou redistribuem apenas campos compatíveis para completar 12 colunas no breakpoint atual.',
+            description: 'Define se cada linha visual parcial, depois de resolver visibilidade responsiva, CSS order e wrap, preserva os spans canônicos ou redistribui apenas campos compatíveis para completar 12 colunas no breakpoint atual.',
             safetyNotes: 'fill-compatible é uma projeção transitória do runtime: não altera x-ui.width nem persiste sections. Controles compactos, uploads e tipos desconhecidos preservam a largura canônica.',
         },
         {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@praxisui/dynamic-form",
-  "version": "9.0.5-rc.2",
+  "version": "9.0.5-rc.4",
   "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.5-rc.2",
-    "@praxisui/dynamic-fields": "^9.0.5-rc.2",
-    "@praxisui/metadata-editor": "^9.0.5-rc.2",
-    "@praxisui/rich-content": "^9.0.5-rc.2",
-    "@praxisui/settings-panel": "^9.0.5-rc.2",
-    "@praxisui/visual-builder": "^9.0.5-rc.2",
-    "@praxisui/core": "^9.0.5-rc.2",
+    "@praxisui/ai": "^9.0.5-rc.4",
+    "@praxisui/dynamic-fields": "^9.0.5-rc.4",
+    "@praxisui/metadata-editor": "^9.0.5-rc.4",
+    "@praxisui/rich-content": "^9.0.5-rc.4",
+    "@praxisui/settings-panel": "^9.0.5-rc.4",
+    "@praxisui/visual-builder": "^9.0.5-rc.4",
+    "@praxisui/core": "^9.0.5-rc.4",
     "rxjs": "^7.8.0"
   },
   "dependencies": {

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

@@ -591,7 +591,7 @@ No ecossistema Praxis, ele funciona tanto como runtime final quanto como superfi
 | `configPersistenceStrategy` | `'local-first' \| 'input-first'` | `'local-first'` | Active | Em `input-first`, os inputs fornecidos pelo host, inclusive `mode`, permanecem autoritativos sobre preferencias persistidas da mesma instancia. Combine com `layoutPolicy.persistence='transient'` em commands efemeros para nao carregar nem gravar layout local. |
 | `layout` | `FormLayout \| undefined` | `undefined` | Partial | Funciona como override estrutural em parte dos fluxos de layout/editor. |
 | `generatedLayoutPreset` | `'default' \| 'compactPresentation'` | `'default'` | Active | Usado apenas ao criar a configuracao inicial a partir de schema/metadata; nao reprocessa layouts persistidos ou authorados. |
-| `layoutPolicy` | `DynamicFormLayoutPolicy \| null` | `null` | Active | Politica opt-in para materializar layout a partir do schema atual. Use `source: 'schema'` com `persistence: 'transient'` para detalhe/read-only e command forms schema-driven sem persistir `sections` geradas nem reabrir configuracao local salva; politicas de host em `config`, como `helpPresentation`, continuam sendo aplicadas ao layout materializado. Em `mode='view'`, `intent: 'detail'` ou `preset: 'compactPresentation'` ativa apresentacao quando `presentationModeGlobal` nao foi informado; use `[presentationModeGlobal]=false` para controles read-only tradicionais. No preset `compactPresentation`, `x-ui.width` explicito empacota campos em linhas de 12 colunas e tem precedencia sobre `detailSummary.columns` por default; campos sem width permanecem full-width, a menos que `detailSummary.columns`/`responsiveColumns` declare a densidade do resumo. Use `detailSummary.widthPrecedence='summary'` quando a densidade do resumo read-only deve sobrescrever `x-ui.width` apenas nessa surface compacta. No preset `groupedCommand`, `groupedCommand.orphanFieldExpansion` controla linhas com um unico campo: `medium-and-wide` (default) expande spans 6/8, `preserve` mantem o width publicado e `all` tambem expande campos compactos. `groupedCommand.partialRowStrategy` usa `preserve` por default; `fill-compatible` projeta linhas parciais elegiveis em spans canônicos que completam 12 colunas por breakpoint/container, sem alterar `x-ui.width`, `sections` ou o documento de authoring. Controles compactos, uploads e tipos desconhecidos preservam seus spans. `groupedCommand.contextFields` identifica campos schema-backed já hidratados pela surface: eles permanecem no `FormGroup` e no payload, mas não renderizam controles redundantes. Use `responsiveColumns`, por exemplo `{ lg: 3, md: 2, sm: 1 }`, para drawers, side sheets e painéis corporativos estreitos sem copiar `FormConfig.sections` locais. `schemaType` e `schemaOperation` sao validados contra `schemaUrl` quando a URL declara esses parametros. |
+| `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 logicas com um unico campo: `medium-and-wide` (default) expande spans 6/8, `preserve` mantem o width publicado e `all` tambem expande campos compactos. `groupedCommand.partialRowStrategy` usa `preserve` por default; `fill-compatible` particiona o grupo nas linhas visuais depois de resolver visibilidade responsiva, CSS `order` e wrap em cada breakpoint/container, projeta cada linha parcial elegivel em spans canônicos que completam 12 colunas e mapeia o resultado de volta as colunas authoradas apenas para renderizacao, sem alterar `x-ui.width`, `sections` ou o documento de authoring. Um singleton elegivel criado por wrap pode preencher sua linha visual; controles compactos, uploads e tipos desconhecidos preservam seus spans. `groupedCommand.contextFields` identifica campos schema-backed já hidratados pela surface: eles permanecem no `FormGroup` e no payload, mas não renderizam controles redundantes. Use `responsiveColumns`, por exemplo `{ lg: 3, md: 2, sm: 1 }`, para drawers, side sheets e painéis corporativos estreitos sem copiar `FormConfig.sections` locais. `schemaType` e `schemaOperation` sao validados contra `schemaUrl` quando a URL declara esses parametros. |
 
 O authoring emite o warning `dynamicForm.config.layout.groupedCommand.row.incomplete` quando uma linha gerada com dois ou mais campos ocupa menos de 12 colunas. Com `partialRowStrategy='fill-compatible'`, o warning desaparece quando a projeção resolve a linha; ele permanece acionável para `preserve` ou quando controles compactos/fixos/desconhecidos não podem ser redistribuídos.
 | `backConfig` | `BackConfig \| undefined` | `undefined` | Active | Integra retorno/navegacao no painel de configuracao; `confirmOnDirty` tem precedencia sobre `behavior.confirmOnUnsavedChanges` no cancel. |