@praxisui/dynamic-form 10.0.0-rc.36 → 10.0.0-rc.38

package/README.md

@@ -55,6 +55,12 @@ Use `optionSource.dependsOn` for dependent option lists and workflow actions for
 
 Use a local `FormConfig` when the host already knows the sections and fields.
 
+With `configPersistenceStrategy="input-first"`, an explicitly bound host configuration remains authoritative even when it contains only actions or other policies. The schema for the current operation supplies missing fields and layout; stale persisted fields are not used to fill those gaps.
+
+Each form owns its mutable `GenericCrudService` and editor field/rule context. Sibling forms cannot change one another's resource, custom endpoints or schema client. This is a breaking beta correction for hosts that previously replaced an ancestor `GenericCrudService`: configure the form through `resourcePath`, `apiEndpointKey`, `apiUrlEntry` and the direct-form `customEndpoints` input. An ancestor service subclass is no longer used by the form; HTTP interceptors, `API_URL` and shared infrastructure remain inherited. Tests that substitute the client must use `TestBed.overrideComponent(PraxisDynamicForm, { add: { providers: [{ provide: GenericCrudService, useValue: crudMock }] } })`, retaining the other component providers.
+
+An explorer combining selectors from several resources is a local form, not an edit command for one of those resource DTOs. Its fields may query real API options through their own resource metadata while remaining `source: 'local'` with `submitPolicy: 'omit'`. Use a distinct form identity when replacing a schema-backed command with such an explorer; persisted connections are still restored for their original identity. The `/dependency-fields-demo` reference follows this pattern and gives the current host definition precedence with `configPersistenceStrategy="input-first"`; its previous `cascade-*` configurations and connections are left untouched.
+
 ```ts
 import { Component } from '@angular/core';
 import { FormConfig } from '@praxisui/core';
@@ -747,3 +753,7 @@ suportada, ocupa a linha seguinte. Nenhum documento ou protocolo de Save é alte
 - [Canonical technical overview: Overview](https://praxisui.dev/docs/components/praxis-dynamic-form)
 - [Praxis Angular public catalog](https://praxisui.dev/angular)
 <!-- praxis-npm-catalog-links:end -->
+
+### Filhos de páginas governadas
+
+Consulte [o adapter nativo de página](docs/governed-page-widget-adapter.md) para reconstrução sem defaults, presença exata, identidade derivada e execução sem preferências concorrentes.

package/ai/component-registry.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": "1.0.0",
-  "generatedAt": "2026-10-21T13:45:30.091Z",
+  "generatedAt": "2026-10-23T20:24:09.136Z",
   "packageName": "@praxisui/dynamic-form",
-  "packageVersion": "10.0.0-rc.36",
+  "packageVersion": "10.0.0-rc.38",
   "sourceRegistry": "praxis-component-registry-ingestion",
   "sourceRegistryVersion": "1.0.0",
   "componentCount": 2,
@@ -49,7 +49,7 @@
         },
         {
           "name": "mode",
-          "type": "'create' | 'edit' | 'view'",
+          "type": "'create' | 'edit' | 'view' | 'presentation' | 'dossier'",
           "required": false,
           "description": "Modo do formulario",
           "label": "Modo",
@@ -176,9 +176,9 @@
         },
         {
           "name": "configPersistenceStrategy",
-          "type": "'local-first' | 'input-first'",
+          "type": "'local-first' | 'input-first' | 'volatile'",
           "required": false,
-          "description": "Define se a configuracao local persistida ou os inputs do host tem precedencia; input-first preserva inclusive o mode explicito contra preferencias persistidas.",
+          "description": "Define se a configuracao local persistida ou os inputs do host tem precedencia; input-first preserva inclusive o mode explícito; volatile usa a configuração do host sem ler, salvar ou limpar preferências do filho.",
           "default": "local-first"
         },
         {
@@ -6865,9 +6865,11 @@
             "allowedValues": [
               "create",
               "edit",
-              "view"
+              "view",
+              "presentation",
+              "dossier"
             ],
-            "description": "Modo de operação"
+            "description": "Modos nativos preservados em documentos. Em novos fluxos, prefira view com presentationModeGlobal para separar operação dos dados e apresentação."
           },
           {
             "name": "presentation",
@@ -6884,9 +6886,10 @@
             "type": "string",
             "allowedValues": [
               "local-first",
-              "input-first"
+              "input-first",
+              "volatile"
             ],
-            "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."
+            "description": "Precedência entre configuração persistida e contrato explícito do host. Use volatile para filhos controlados por página, sem storage independente. Use input-first em dialogs e surfaces transitórias governadas por schema para preservar mode e estados operacionais publicados pelo servidor."
           },
           {
             "name": "generatedLayoutPreset",
@@ -9415,9 +9418,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 | null)\n  - initialValue (Record<string, unknown> | null)\n  - emptyState (PraxisDynamicFormEmptyState | null)\n  - editorialContext (Record<string, unknown> | null)\n  - mode ('create' | 'edit' | 'view')\n  - config (FormConfig)\n  - actions (FormConfig['actions'] | null)\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  - submitResourceVersionTargetResourceKey (string | null)\n  - submitResourceVersionTargetIdField (string | 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  - presentation (DynamicFormPresentationSnapshot | null)\n  - presentationPreset (FormPresentationPreset)\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  - payloadPreviewChange (FormPayloadPreviewEvent)\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",
+          "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 | null)\n  - initialValue (Record<string, unknown> | null)\n  - emptyState (PraxisDynamicFormEmptyState | null)\n  - editorialContext (Record<string, unknown> | null)\n  - mode ('create' | 'edit' | 'view' | 'presentation' | 'dossier')\n  - config (FormConfig)\n  - actions (FormConfig['actions'] | null)\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  - submitResourceVersionTargetResourceKey (string | null)\n  - submitResourceVersionTargetIdField (string | null)\n  - responseSchemaUrl (string | null)\n  - enableCustomization (boolean)\n  - showAiAssistant (boolean)\n  - formId (string)\n  - componentInstanceId (string)\n  - configPersistenceStrategy ('local-first' | 'input-first' | 'volatile')\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  - presentation (DynamicFormPresentationSnapshot | null)\n  - presentationPreset (FormPresentationPreset)\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  - payloadPreviewChange (FormPayloadPreviewEvent)\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": "8425658a28ef61e2ebcf2ce2cc5b45835050556a4f810e83a4c167290dfcd80a",
+          "contentHash": "c23522b0ae4de2b4f759620ac16675455e6d0fe9e97b630e7248b82a8a3d463c",
           "sourceKind": "component_definition",
           "sourceId": "praxis-dynamic-form",
           "corpusVersion": "1.0.0"
@@ -9845,9 +9848,9 @@
         {
           "chunkIndex": 43,
           "chunkKind": "authoring_manifest",
-          "content": "{\"schemaVersion\":\"1.0.0\",\"manifestVersion\":\"1.5.4\",\"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\":\"actions\",\"type\":\"FormConfig['actions'] | null\",\"description\":\"Overrides de apresentação da barra de ações fornecidos pelo host sem substituir o contrato HTTP da surface.\"},{\"name\":\"formId\",\"type\":\"string\",\"description\":\"Identidade estável usada pelo runtime para persistência local da configuração.\"},{\"name\":\"resourcePath\",\"type\":\"string\",\"description\":\"Caminho do recurso (API)\"},{\"name\":\"resourceId\",\"type\":\"string | number | null\",\"description\":\"Identidade canônica do registro carregado em modos edit e view.\"},{\"name\":\"emptyState\",\"type\":\"PraxisDynamicFormEmptyState | null\",\"description\":\"Authorado em bindings.emptyState no editor; null desliga explicitamente. Placeholder opt-in para mode=view sem resourceId nem snapshot local; reutiliza o empty state compartilhado e mantém a mensagem de negócio no plano/host.\"},{\"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\":\"presentation\",\"type\":\"DynamicFormPresentationSnapshot | null\",\"description\":\"Projeção de contextSnapshot.presentation para hosts e Page Builder. Tamanhos em pixels; null remove ajustes explícitos. Não altera mode nem presentationModeGlobal.\"},{\"name\":\"presentationModeGlobal\",\"type\":\"boolean | null\",\"description\":\"Preferência de exibição, também authorada em bindings.presentationModeGlobal: true apresenta rótulos e valores somente em mode=view; false força campos; null/ausência segue layoutPolicy. Não altera o modo dos dados.\"},{\"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\"}]}",
+          "content": "{\"schemaVersion\":\"1.0.0\",\"manifestVersion\":\"1.5.4\",\"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\":\"actions\",\"type\":\"FormConfig['actions'] | null\",\"description\":\"Overrides de apresentação da barra de ações fornecidos pelo host sem substituir o contrato HTTP da surface.\"},{\"name\":\"formId\",\"type\":\"string\",\"description\":\"Identidade estável usada pelo runtime para persistência local da configuração.\"},{\"name\":\"resourcePath\",\"type\":\"string\",\"description\":\"Caminho do recurso (API)\"},{\"name\":\"resourceId\",\"type\":\"string | number | null\",\"description\":\"Identidade canônica do registro carregado em modos edit e view.\"},{\"name\":\"emptyState\",\"type\":\"PraxisDynamicFormEmptyState | null\",\"description\":\"Authorado em bindings.emptyState no editor; null desliga explicitamente. Placeholder opt-in para mode=view sem resourceId nem snapshot local; reutiliza o empty state compartilhado e mantém a mensagem de negócio no plano/host.\"},{\"name\":\"readUrl\",\"type\":\"string\",\"description\":\"Endpoint canonico de leitura para surfaces VIEW/READ_PROJECTION\"},{\"name\":\"mode\",\"type\":\"string\",\"allowedValues\":[\"create\",\"edit\",\"view\",\"presentation\",\"dossier\"],\"description\":\"Modos nativos preservados em documentos. Em novos fluxos, prefira view com presentationModeGlobal para separar operação dos dados e apresentação.\"},{\"name\":\"presentation\",\"type\":\"DynamicFormPresentationSnapshot | null\",\"description\":\"Projeção de contextSnapshot.presentation para hosts e Page Builder. Tamanhos em pixels; null remove ajustes explícitos. Não altera mode nem presentationModeGlobal.\"},{\"name\":\"presentationModeGlobal\",\"type\":\"boolean | null\",\"description\":\"Preferência de exibição, também authorada em bindings.presentationModeGlobal: true apresenta rótulos e valores somente em mode=view; false força campos; null/ausência segue layoutPolicy. Não altera o modo dos dados.\"},{\"name\":\"configPersistenceStrategy\",\"type\":\"string\",\"allowedValues\":[\"local-first\",\"input-first\",\"volatile\"],\"description\":\"Precedência entre configuração persistida e contrato explícito do host. Use volatile para filhos controlados por página, sem storage independente. 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": "71de795e514367583af30f004099e53c0376010d58718a6b73935e544a090303",
+          "contentHash": "2c3f132524d3cf73b6c9cb6f4591d2b1c076e1b444aa5c792be33a8d3d758c46",
           "sourceKind": "component_definition",
           "sourceId": "praxis-dynamic-form",
           "corpusVersion": "1.0.0"
@@ -16537,9 +16540,11 @@
             "allowedValues": [
               "create",
               "edit",
-              "view"
+              "view",
+              "presentation",
+              "dossier"
             ],
-            "description": "Modo de operação"
+            "description": "Modos nativos preservados em documentos. Em novos fluxos, prefira view com presentationModeGlobal para separar operação dos dados e apresentação."
           }
         ],
         "editableTargets": [
@@ -17907,9 +17912,9 @@
         {
           "chunkIndex": 30,
           "chunkKind": "authoring_manifest",
-          "content": "{\"schemaVersion\":\"1.0.0\",\"manifestVersion\":\"1.0.0\",\"componentId\":\"praxis-filter-form\",\"ownerPackage\":\"@praxisui/dynamic-form\",\"configSchemaId\":\"FormConfig\",\"chunkSection\":\"runtimeInputs\",\"runtimeInputs\":[{\"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\":\"formId\",\"type\":\"string\",\"description\":\"Identidade estável usada pelo runtime para persistência local da configuração.\"},{\"name\":\"resourcePath\",\"type\":\"string\",\"description\":\"Caminho do recurso (API)\"},{\"name\":\"mode\",\"type\":\"string\",\"allowedValues\":[\"create\",\"edit\",\"view\"],\"description\":\"Modo de operação\"}]}",
+          "content": "{\"schemaVersion\":\"1.0.0\",\"manifestVersion\":\"1.0.0\",\"componentId\":\"praxis-filter-form\",\"ownerPackage\":\"@praxisui/dynamic-form\",\"configSchemaId\":\"FormConfig\",\"chunkSection\":\"runtimeInputs\",\"runtimeInputs\":[{\"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\":\"formId\",\"type\":\"string\",\"description\":\"Identidade estável usada pelo runtime para persistência local da configuração.\"},{\"name\":\"resourcePath\",\"type\":\"string\",\"description\":\"Caminho do recurso (API)\"},{\"name\":\"mode\",\"type\":\"string\",\"allowedValues\":[\"create\",\"edit\",\"view\",\"presentation\",\"dossier\"],\"description\":\"Modos nativos preservados em documentos. Em novos fluxos, prefira view com presentationModeGlobal para separar operação dos dados e apresentação.\"}]}",
           "sourcePointer": "projects/praxis-dynamic-form/src/lib/ai/praxis-filter-form-authoring-manifest.ts",
-          "contentHash": "e87e0eebe5c750ff0bf9624b953e5ad603ae63ca2584702c9618500202fbed00",
+          "contentHash": "87565432bc9d9f832bcd7f5d85001fe6d2eca9009c4f211468588e358ef89239",
           "sourceKind": "component_definition",
           "sourceId": "praxis-filter-form",
           "corpusVersion": "1.0.0"

package/docs/dynamic-form-authoring-document-semantics.md

@@ -4,7 +4,7 @@ doc_type: "adr"
 component: "praxis-dynamic-form"
 status: "accepted"
 owner: "praxis-ui"
-last_updated: "2026-09-10"
+last_updated: "2026-10-23"
 ---
 
 # Dynamic Form Authoring Document Semantics
@@ -23,6 +23,26 @@ Ao aplicar um documento canônico:
 
 Payloads legados ou parciais recebidos por APIs de compatibilidade, como `applyConfigFromAdapter(...)`, permanecem com semântica `merge-compat`: campos não informados devem ser preservados até migração completa para o contrato canônico.
 
+## Rule conversion and recovery
+
+`config.formRules` owns the canonical rule expression and both effect branches.
+`formRulesState` is derived visual authoring state. Wizard inline JSON Logic must
+survive Apply, Save and reopen unchanged. Conditions outside the visual graph
+vocabulary remain intact inline and are diagnosed as `runtime-only`; a valid
+root-data reference (`var: ''`) is not an invalid field reference.
+
+A partial graph must never weaken an AND/OR expression by dropping children.
+Missing rule roots, rules without a serializable target, and missing, cyclic or
+unsupported explicit condition graph nodes block Apply/Save while
+retaining the draft and last accepted configuration. Repairing through the
+properties panel revalidates the draft. Deleting the last rule removes both
+`formRules` and `formRulesState`, including after a validation failure.
+
+Editor validation that gates Apply/Save uses the injected `PraxisJsonLogicService`
+and the same host operator registry as runtime evaluation. A registered host
+operator can remain runtime-only in the visual builder and must still save and
+reopen. Unknown operators and invalid arity remain blocked.
+
 ## Filter Form projection
 
 `praxis-filter-form` compartilha o mesmo documento canônico, parser e serializer,
@@ -161,7 +181,8 @@ that the resource schema could not be loaded.
 
 The wrapper also exposes the existing `configPersistenceStrategy` as **Fonte da configuração**.
 **Definida nesta página** selects `input-first`; **Preferências salvas** selects `local-first`.
-The runtime default remains `local-first`. When the goal is a page-owned layout, select `input-first`
+**Configuração temporária** selects `volatile`, which never reads, saves or clears independent child preferences.
+The runtime default remains `local-first`. For ordinary page layouts, select `input-first`
 so an older saved form preference does not replace the correctly persisted page sections on reload.
 Changing only the source preserves the authored page config even if the currently displayed effective
 layout came from older local preferences. This is an existing runtime input, not a new persistence
@@ -213,3 +234,11 @@ Conflicting preference regression: the external config hydration suite passed al
 and placeholder (log `/private/tmp/praxis-form-preference-conflict-tests.log`). This
 is an isolated storage-service test and serialized widget round-trip; actual
 backend persistence and visual editor interaction are validated separately.
+
+## Governed page child adapter
+
+For published page authorship, use [the native page adapter](governed-page-widget-adapter.md), not the
+common wrapper output directly. It preserves exact presence and only explicit editor deltas, locks
+bindings/context to the admitted seed, and derives volatile execution inputs from page/widget identity.
+Native `presentation` and `dossier` modes survive open/save/reopen; new visual flows still prefer
+`view` with a separate display preference. Filter Form keeps its three-mode runtime subset.

package/docs/evidence/p1-authoring-20261022/validation.md

@@ -0,0 +1,134 @@
+# P1 form authoring — issues #631, #632 and #633
+
+Classification: public behavior change with cross-library consumers. Canonical owners are Dynamic Form (rules bridge, form client/context and hydration) and Metadata Editor (cascade authoring). No exported type, endpoint, workspace configuration or dependency change.
+
+## Scope and compatibility
+
+- Preserve wizard JSON Logic and both property branches through Apply/Save/reopen. Invalid graphs remain available for repair and cannot silently become unconditional rules.
+- Preserve non-identity cascade filter maps and extraction paths. Table rows own the current edit draft; suggestions fill missing mappings.
+- Give each mounted form its own mutable CRUD client and editor context. This is a breaking beta DI correction; ancestor GenericCrudService replacements must migrate to supported component inputs or component-level test overrides. Shared HTTP infrastructure remains inherited.
+- Make the Quickstart dependency demo a local relationship explorer. Selectors query real resources individually; fields are omitted from domain payloads. Its new document identities avoid inheriting old schema-backed connections.
+- Open field customization from the current canonical materialization, rather than stale selection/render snapshots.
+
+Existing contracts cover these behaviors: already supported but incorrectly materialized. No parallel contract or new authoring vocabulary was introduced.
+
+## Review and gate resolution
+
+The implementation was isolated on main 8da9401a8; unrelated dirty checkout changes and unrelated documentation hunks were excluded. Reviewers different from the authors inspected conversion/diagnostics, cascade editing, DI ownership, demo and both remaining gates.
+
+The old label test conflated a selected snapshot with the current materialization. Regression tests now preserve the Cargo expectation while giving the canonical document/presentation that label, and making selection/cache explicitly obsolete.
+
+The earlier host-test compilation failure involved a nullable assertion in an unrelated dirty test. That test is absent from this main baseline; the demo target is compiled and executed without importing the unrelated changes or altering TypeScript configuration.
+
+Additional review covered deleting the last invalid rule, repairing through the properties panel, diagnostics for conditions outside the graph subset and loading rules without formRulesState. Valid runtime-only conditions must remain intact; invalid conditions must remain blocked. JSON Logic var:'' is a valid root-data reference, not an invalid field path.
+
+## Validation
+
+All selected gates passed on the isolated source tree:
+
+| Gate | Result |
+| --- | --- |
+| Rule converters, configuration editor, diagnostics and isolation | 114 passed |
+| Dynamic Form main/config/editorial/presentation/manifest/hydration/protocol | 334 passed |
+| Cascade service and tab | 17 passed |
+| CRUD dialog host consumer | 50 passed |
+| Additional DI consumers: entity selection, schema recovery, layout tabs, presentation preset and widget editor | 77 passed |
+| Dependency demo host target | 1 passed |
+| Official build helper: Metadata Editor, Dynamic Form, CRUD + dependency closure | Passed |
+| Final Dynamic Form and CRUD builds after gate repairs | Passed |
+| Published documentation assets | Passed, 5 packages |
+| MatSelect content model and diff whitespace | Passed |
+
+The isolated dependency tree was installed using npm ci. No broad full-test-suite
+or release certification is claimed. Counts represent separate lanes, not a
+claim about unique test coverage.
+
+Exact focal spec includes and commands are reproducible from the changed spec
+paths; the main lane also includes first/external hydration, authoring protocol
+and the authoring manifest. Builds use development configuration. Artifact logs
+are retained in the workspace under artifacts/form-p1-fixes-20261022/clean-*.log.
+
+## Final local browser smoke
+
+The isolated checkout was served frozen on official UI4003, with its proxy
+explicitly directed to unavailable local API8088. This smoke exercised the local
+editor only and did not attempt option loading or domain submission.
+
+Through the visible JSON tab of dependency-fields-demo, a malformed condition
+(`{"===": []}`) produced an invalid-condition diagnostic and disabled Apply and
+Save. Correcting the document by removing rule/state through the same JSON tab
+re-enabled both buttons. Drafts were cancelled and tabs closed; nothing was
+saved to the host or remote configuration.
+
+![Invalid condition blocks Apply and Save](final-invalid-blocked.png)
+
+![Corrected document re-enables Apply and Save](final-recovered-enabled.png)
+
+The native confirmation for the visual Remove button could not be accepted by
+the browser-control adapter because its focus command timed out. That attempt
+was abandoned and its tab closed. Visual deletion via that button is not claimed
+as passed; the component regression covers deletion and reopen. The rule list
+also retained a stale row after JSON replacement while canonical diagnostics
+were empty: the remaining UI coherence work belongs to #635. The screenshots
+record this limit rather than hiding it.
+
+ Tests are unit/component tests using ChromeHeadless, without a database. Dependency builds use the official build-libs helper and its dependency closure. No release workflow, deployment or domain mutation is performed.
+
+## Earlier visual audit evidence
+
+The analyst journeys were repeated in Chrome on the previous shared source snapshot, using official UI4003/API8088 and assigned remote Neon branches with runtime identities/TLS. Those screenshots are historical visual evidence, not proof of this isolated revision. Current revision validation is listed separately above.
+
+- #631: wizard Ativo=true/false controlled Foto visibility and required state; persisted expression and both effects survived reload.
+- #632: Cargo/Departamento non-identity mapping survived explicit Edit, Save, Apply and reload.
+- #633: RH, Base/Equipe/Membro and Ameaça/Missão/Incidente/Indenização chains completed with real filtered option requests; parent replacement/clear emptied descendants; no-result search and sibling-tab independence were checked.
+- CRUD native Add dialog loaded its command schema and was closed without submission.
+
+Limits retained: Foto originally arrived formHidden and required temporary exposure in the visible JSON editor. After reload the target catalog again omitted it, a remaining #635 issue. Structural dotted mapping proof does not certify backend acceptance of that filter. No narrow-screen, screen-reader, adverse-latency, remote ETag/concurrency or latest-release certification is claimed.
+
+Detailed original audit artifacts are retained in the workspace artifacts/form-p1-fixes-20261022 directory and linked from the issue discussions. No credentials/network headers are published.
+
+## Derived artifacts and skills
+
+README/JSON API owner documentation explains DI migration and the explorer; Metadata Editor README explains lossless cascade editing. No public-api, AI operation/path, manifest shape, HTTP corpus or landing-page contract changed, so no parallel derived contract was created. Authoring manifest tests and published documentation asset checks cover the existing surfaces.
+
+Canonical cascade and runtime DI skill updates were previously integrated through praxis-codex-skills#826 and #827 and selectively synchronized. Existing form roundtrip guidance remains adequate: formRulesState is derived, canonical rules are preserved, and runtime discovery does not own persisted semantics. The additional gate repairs enforce that existing guidance.
+
+## Final review before integration — 2026-10-23
+
+A new independent review of cad84dd00 found and corrected three cases before
+integration:
+
+- A missing or targetless rule root was silently dropped, so the new empty-rule
+  branch could delete the last accepted rules. Projection now rejects every
+  referenced invalid root, including a mixed valid/invalid graph. The editor
+  keeps the accepted document and invalid draft and blocks saving; an explicit
+  rootNodes=[] still supports intentional deletion.
+- Blocking diagnostics used a built-in-only JSON Logic instance and rejected a
+  valid host operator. Editor diagnostics and command validation now share the
+  injected runtime service. A real registered operator is tested through runtime
+  evaluation and editor Save/reopen; unknown operators and invalid arity fail.
+- Removing a cascade dependency retained its extraction override record. The
+  save path now removes both mapping and extraction override for removed
+  dependencies; save/reopen/re-add and last-dependency/default cases are covered.
+
+An additional consumer inventory found four test fixtures still providing the
+CRUD mock in the ancestor injector. They now use the documented component-level
+replacement. The entity-selection fixture also supplies the current HttpResponse
+read API while preserving request, error and cancellation assertions. The widget
+editor fixture does not mount Dynamic Form and was intentionally left unchanged.
+
+Before/after evidence: missing-root regressions failed before the fix; the host
+operator regression failed before registry propagation; the extra DI lane had
+19 failures before fixture updates and finished 77/77. Final focused rules lane
+114/114 and cascades 17/17 passed. The 334-test form lane, 50-test CRUD lane and demo lane were also rerun after
+the production repairs and passed. All three owner/consumer builds were rerun after production repairs.
+No database or remote release workflow was required for these review repairs.
+
+The earlier native-dialog/browser and #635 limitations remain unchanged. They
+are not presented as newly validated by these unit/component regressions.
+
+The two narrowly scoped guidance additions were independently reviewed and
+integrated through praxis-codex-skills#829 (merge fb0fb5c). Both affected skills
+were selectively synchronized and audited; the other 787 installed skill files
+remained byte-identical and seven unrelated drifts were preserved. No new skill
+or public contract was introduced.

package/docs/governed-page-widget-adapter.md

@@ -0,0 +1,58 @@
+# Dynamic Form em páginas governadas
+
+O adapter do owner mantém `definition.inputs.config` como a única fonte de configuração do filho.
+A página guarda autoria; o documento nativo é reconstruído a partir desses inputs. A projeção de
+execução é transitória e nunca deve ser gravada de volta no documento da página.
+
+O perfil inicial vem do contrato P0 `page-publication-p0` de `praxis-config-starter` (PR #506).
+Core valida estrutura, referências, limites e exige validators dos owners. Este adapter valida o
+perfil nativo local; não autoriza uma fonte, registra uma seed ou substitui a admissão no servidor.
+
+`decodeDynamicFormPageInputs` reconstrói `praxis.dynamic-form.editor` v1:
+config, bindings presentes (`mode`, `emptyState`, `presentationModeGlobal`) e contexto presente
+(`backConfig`, `presentation`, `schemaPrefs`). Schema prefs só existe se algum dos três inputs
+`notifyIfOutdated`, `snoozeMs`, `autoOpenSettingsOnOutdated` estiver presente. Ausência, `false`,
+zero, objeto vazio admitido e `null` são preservados. Null em objetos mesclados de config é negado;
+null dentro de arrays atômicos permanece autoria. `layoutScope` não cabe neste perfil.
+
+Os cinco modos nativos são `create`, `edit`, `view`, `presentation` e `dossier`. O editor visual
+continua preferindo os três modos de operação com `presentationModeGlobal` separado. Abrir um
+documento nativo dos demais modos não deve convertê-lo. Filter Form mantém somente seus três modos.
+
+`encodeDynamicFormPageInputs` é a projeção inversa sem defaults. Campos fora do perfil,
+blocos vazios sem representação nos inputs, identidade/storage e dados de execução recebem
+diagnóstico. O adapter não filtra silenciosamente autoria incompatível.
+
+`projectDynamicFormPageEditorChanges(authoredInputs, editorBaseline, editorValue)` aplica apenas
+deltas explícitos sobre a autoria original usando o reconciliador nativo do owner. Capture o
+baseline após a normalização/montagem do editor e preserve-o durante aquela sessão. Alterar
+bindings ou contexto do mesmo widget retorna `seed.replacement-required`; a página precisa
+substituir o widget com nova key e nova fonte admitida. A API de projeção altera somente o draft
+que o chamador recebe; ela não salva preferências nem persiste a página.
+
+`materializeDynamicFormPageRuntimeInputs(inputs, pageId, widgetKey)` usa o helper canônico Core para
+identidades `page:<pageId>:widget:<widgetKey>`, projeta `configPersistenceStrategy: 'volatile'`
+e desabilita customização/copiloto independentes no filho. Submit e dados continuam nos contratos
+de domínio existentes. Não existe input runtime `authoringDocument`.
+
+A estratégia `volatile` impede leitura, gravação e limpeza de preferências próprias e conexão
+persistida. O Form preserva identidade operacional para montar o formulário, mas as trilhas de
+config/bindings/contexto/schema preferences ficam sem I/O de storage.
+Defaults visuais/materializações transitórias permanecem internos ao runtime e ao editor.
+
+Limites: JSON lossless, 256 KiB UTF-8 e profundidade 64 pelo helper Core compartilhado; o documento
+integral da página também tem o mesmo orçamento. Não há host publicado, endpoint de publicação,
+fonte admitida, banco ou release novos neste incremento. A integração Page Builder/host governado
+é trabalho posterior; os wrappers comuns continuam atendendo os fluxos não governados existentes.
+
+`volatile` também exclui overlays pessoais de configuração global nos defaults/estado de autoria
+que o owner consome. A instância compartilhada `GlobalConfigService` pode ler sua chave global;
+isso não é prova de zero leitura na aplicação. Tenant, cache, locale e CSP continuam infraestrutura
+do host. O gate comprova ausência de I/O nas chaves do filho e ausência de influência da autoria
+pessoal sobre a configuração publicada. Em Table, `TableDefaultsProvider.getDefaults(id,
+{ includeGlobal: false })` preserva defaults nativos sem duplicá-los; mudanças globais e reset
+seguem a mesma política, inclusive o fallback de timezone usado em regras JSON Logic.
+
+Respostas e filas de preferências capturam a geração, a identidade e a estratégia do filho. Trocar identidade, documento ou estratégia (inclusive A → volatile → A), ou destruir a instância, invalida a continuação antiga antes do próximo I/O ou da materialização. Uma requisição já enviada não é cancelada retroativamente. Respostas tardias de erro também passam pelo mesmo fence.
+
+O fence segue a chave do recurso: conexão, inputs e schema preferences usam identidade do owner e geração do host; apresentação acrescenta a chave `form-pres:<id>:<mode>`. Hidratar mode/path das próprias preferências iniciais não troca o owner. Eventos de inputs do host invalidam a geração e iniciam uma resolução atual. Schema, config e escritas também capturam os bindings de runtime.