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

package/README.md

@@ -29,6 +29,20 @@ Peer dependencies:
 - `@praxisui/ai`, `@praxisui/core`, `@praxisui/dynamic-fields`, `@praxisui/metadata-editor`, `@praxisui/rich-content`, `@praxisui/settings-panel`, `@praxisui/visual-builder` `^9.0.0-beta.12`
 - `rxjs` `^7.8.0`
 
+## Reactive backend determinations
+
+When the exact request schema from `/schemas/filtered` publishes root-level `x-ui.reactiveDeterminations`, the form can execute the Metadata-compiled backend capability after a valid source changes and apply server-derived draft values. The projection is backend-owned, tenant-neutral and transient: it is never copied to `FormConfig` and cannot be authored as a callback, URL or local write policy.
+
+Triggers, source fields and request/response bindings use JSON Pointer. The runtime supports nested object bindings, accepts at most 64 total input/output bindings and rejects duplicate or hierarchically overlapping pointers. It resolves the capability only against the configured API origin and rejects protocol-relative, encoded-separator or cross-origin targets. Output bindings have one closed meaning: server-derived draft values replace their targets. Metadata cannot select `if-pristine`, `if-empty` or another incidental UI policy.
+
+The runtime waits until hydration finishes and invalidates the previous generation as soon as a newer relevant value or validation status arrives, before the new debounce completes. `sourcePaths` is an intentional trigger subset of `inputs`: changing a non-trigger input invalidates the current draft, emits `input-changed-awaiting-trigger`, and blocks submit/navigation until a source trigger recalculates it. Every configured response path is resolved before target controls are written; all nested targets are populated before change observers are notified. Chained determinations receive one logical batch signal after the complete commit, rather than one execution per output control. Their dependency order uses hierarchical input/output JSON Pointer overlap, and the canonical projection rejects cycles and overlapping multi-writers. Downstream waits while upstream is pending and runs only after authoritative outputs or confirmed unchanged inputs. Null/undefined upstream outputs and failed, invalid or cancelled upstream generations settle downstream as skipped instead of invoking it with missing or stale data. If a control rejects a write, the runtime attempts to restore earlier writes and reports a terminal failure. This is a coordinated client-side batch, not a transaction or an ACID guarantee.
+
+A determination remains pending through debounce, asynchronous validation and capability execution. Submit attempts wait with a bounded timeout and repeat the stability check after hooks that may mutate controls. Output controls are disabled transiently as server-owned draft values, but remain present in `getRawValue()`, `valueChange` and submit payloads; this state is not persisted in `FormConfig`.
+
+Hosts can observe metadata-only evidence through `reactiveDeterminationExecuted` and aggregate state through `reactiveDeterminationPendingChange`. Before navigating or closing a composed surface, inspect `hasPendingReactiveDeterminations()` and `hasUnsatisfiedReactiveDeterminations()` and await `waitForReactiveDeterminations(timeoutMs?)`; `false` means timeout or that the latest generation did not produce a current authoritative draft, and must block the transition. Cancelled pending correlations terminate as `skipped/superseded`. No event or method exposes form or response values.
+
+Use `optionSource.dependsOn` for dependent option lists and workflow actions for persistent transitions. Recommendations, side-effect refresh and backend validation are separate capabilities. The final backend command must still authorize, recompute or validate fiscal, pricing, eligibility, compliance and approval outcomes.
+
 ## Minimum Local Runtime
 
 Use a local `FormConfig` when the host already knows the sections and fields.
@@ -139,12 +153,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 +237,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-14T19:32:41.263Z",
   "packageName": "@praxisui/dynamic-form",
-  "packageVersion": "9.0.5-rc.2",
+  "packageVersion": "9.0.5-rc.20",
   "sourceRegistry": "praxis-component-registry-ingestion",
   "sourceRegistryVersion": "1.0.0",
   "componentCount": 2,
@@ -350,6 +350,18 @@
           "type": "{ outdated: boolean; serverHash?: string; lastVerifiedAt?: string; formId?: string }",
           "required": false,
           "description": "Emite quando o status do schema muda"
+        },
+        {
+          "name": "reactiveDeterminationExecuted",
+          "type": "ReactiveDeterminationExecutionEvent",
+          "required": false,
+          "description": "Emite evidência metadata-only sem valores sensíveis ao iniciar, executar, ignorar ou falhar uma determinação reativa backend."
+        },
+        {
+          "name": "reactiveDeterminationPendingChange",
+          "type": "boolean",
+          "required": false,
+          "description": "Emite o estado agregado de estabilizacao das determinacoes, sem valores do formulario ou da resposta."
         }
       ],
       "configSchemaId": "FormConfig",
@@ -4279,7 +4291,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 +6235,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",
@@ -8738,9 +8750,9 @@
         {
           "chunkIndex": 0,
           "chunkKind": "summary",
-          "content": "Component ID: praxis-dynamic-form\nSelector: praxis-dynamic-form\nFriendly Name: Praxis Dynamic Form\nDescription: Formulario dinamico com layout por secoes/linhas/colunas e campos renderizados por metadados.\nCategory: form\nLib/Package: @praxisui/dynamic-form\nTags: widget, form, configurable, hasWizard, stable\nInputs:\n  - resourcePath (string)\n  - resourceId (string | number)\n  - initialValue (Record<string, unknown> | null)\n  - editorialContext (Record<string, unknown> | null)\n  - mode ('create' | 'edit' | 'view')\n  - config (FormConfig)\n  - schemaSource ('resource' | 'filter')\n  - schemaUrl (string | null)\n  - readUrl (string | null)\n  - apiEndpointKey (ApiEndpoint | string | null)\n  - apiUrlEntry (ApiUrlEntry | null)\n  - submitUrl (string | null)\n  - submitMethod ('post' | 'put' | 'patch' | null)\n  - submitIdempotencyKey (string | null)\n  - submitCorrelationId (string | null)\n  - submitResourceVersion (string | number | null)\n  - responseSchemaUrl (string | null)\n  - enableCustomization (boolean)\n  - showAiAssistant (boolean)\n  - formId (string)\n  - componentInstanceId (string)\n  - configPersistenceStrategy ('local-first' | 'input-first')\n  - layout (FormLayout)\n  - generatedLayoutPreset ('default' | 'compactPresentation')\n  - layoutPolicy (DynamicFormLayoutPolicy | null)\n  - backConfig (BackConfig)\n  - hooks (FormHooksLayout)\n  - removeEmptyContainersOnSave (boolean)\n  - reactiveValidation (boolean | null)\n  - reactiveValidationDebounceMs (number | null)\n  - notifyIfOutdated ('inline' | 'snackbar' | 'both' | 'none')\n  - snoozeMs (number)\n  - autoOpenSettingsOnOutdated (boolean)\n  - readonlyModeGlobal (boolean | null)\n  - disabledModeGlobal (boolean | null)\n  - presentationModeGlobal (boolean | null)\n  - fieldIconPolicy ('all' | 'presentation-only' | 'none')\n  - visibleGlobal (boolean | null)\n  - customEndpoints (EndpointConfig)\nOutputs:\n  - formSubmit (FormSubmitEvent)\n  - formCancel (void)\n  - formReset (void)\n  - configChange (FormConfig)\n  - configPatchChange (DynamicFormConfigPatchChangeEvent)\n  - formReady (FormReadyEvent)\n  - valueChange (FormValueChangeEvent)\n  - syncCompleted (SyncResult)\n  - initializationError (FormInitializationError)\n  - enableCustomizationChange (boolean)\n  - customAction (FormCustomActionEvent)\n  - actionConfirmation (FormActionConfirmationEvent)\n  - schemaStatusChange ({ outdated: boolean; serverHash?: string; lastVerifiedAt?: string; formId?: string })\n",
+          "content": "Component ID: praxis-dynamic-form\nSelector: praxis-dynamic-form\nFriendly Name: Praxis Dynamic Form\nDescription: Formulario dinamico com layout por secoes/linhas/colunas e campos renderizados por metadados.\nCategory: form\nLib/Package: @praxisui/dynamic-form\nTags: widget, form, configurable, hasWizard, stable\nInputs:\n  - resourcePath (string)\n  - resourceId (string | number)\n  - initialValue (Record<string, unknown> | null)\n  - editorialContext (Record<string, unknown> | null)\n  - mode ('create' | 'edit' | 'view')\n  - config (FormConfig)\n  - schemaSource ('resource' | 'filter')\n  - schemaUrl (string | null)\n  - readUrl (string | null)\n  - apiEndpointKey (ApiEndpoint | string | null)\n  - apiUrlEntry (ApiUrlEntry | null)\n  - submitUrl (string | null)\n  - submitMethod ('post' | 'put' | 'patch' | null)\n  - submitIdempotencyKey (string | null)\n  - submitCorrelationId (string | null)\n  - submitResourceVersion (string | number | null)\n  - responseSchemaUrl (string | null)\n  - enableCustomization (boolean)\n  - showAiAssistant (boolean)\n  - formId (string)\n  - componentInstanceId (string)\n  - configPersistenceStrategy ('local-first' | 'input-first')\n  - layout (FormLayout)\n  - generatedLayoutPreset ('default' | 'compactPresentation')\n  - layoutPolicy (DynamicFormLayoutPolicy | null)\n  - backConfig (BackConfig)\n  - hooks (FormHooksLayout)\n  - removeEmptyContainersOnSave (boolean)\n  - reactiveValidation (boolean | null)\n  - reactiveValidationDebounceMs (number | null)\n  - notifyIfOutdated ('inline' | 'snackbar' | 'both' | 'none')\n  - snoozeMs (number)\n  - autoOpenSettingsOnOutdated (boolean)\n  - readonlyModeGlobal (boolean | null)\n  - disabledModeGlobal (boolean | null)\n  - presentationModeGlobal (boolean | null)\n  - fieldIconPolicy ('all' | 'presentation-only' | 'none')\n  - visibleGlobal (boolean | null)\n  - customEndpoints (EndpointConfig)\nOutputs:\n  - formSubmit (FormSubmitEvent)\n  - formCancel (void)\n  - formReset (void)\n  - configChange (FormConfig)\n  - configPatchChange (DynamicFormConfigPatchChangeEvent)\n  - formReady (FormReadyEvent)\n  - valueChange (FormValueChangeEvent)\n  - syncCompleted (SyncResult)\n  - initializationError (FormInitializationError)\n  - enableCustomizationChange (boolean)\n  - customAction (FormCustomActionEvent)\n  - actionConfirmation (FormActionConfirmationEvent)\n  - schemaStatusChange ({ outdated: boolean; serverHash?: string; lastVerifiedAt?: string; formId?: string })\n  - reactiveDeterminationExecuted (ReactiveDeterminationExecutionEvent)\n  - reactiveDeterminationPendingChange (boolean)\n",
           "sourcePointer": "projects/praxis-dynamic-form/src/lib/praxis-dynamic-form.metadata.ts",
-          "contentHash": "ccb2750e1ca46377c941d3e9c7ceeeaa5aab003a7c49dd74cc4de3d123a71746",
+          "contentHash": "eefb78815e87637042fb708712793ec5a994fa0c9ae7e14224680a8cb60d925c",
           "sourceKind": "component_definition",
           "sourceId": "praxis-dynamic-form",
           "corpusVersion": "1.0.0"
@@ -8838,9 +8850,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 +9170,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 +13709,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 +15699,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.