@praxisui/dynamic-form 9.0.68-rc.3 → 10.0.0-rc.10

package/README.md

@@ -732,3 +732,10 @@ editor” até 768px de largura disponível, mantendo a mesma seleção e os con
 das abas. Acima desse limite, reaparece a navegação por abas. O Settings Panel
 organiza título, expandir e fechar em uma grade até 599px; a prévia, quando
 suportada, ocupa a linha seguinte. Nenhum documento ou protocolo de Save é alterado.
+
+<!-- praxis-npm-catalog-links:start -->
+## Official documentation and examples
+
+- [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 -->

package/ai/component-registry.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": "1.0.0",
-  "generatedAt": "2026-09-10T02:26:52.714Z",
+  "generatedAt": "2026-10-13T14:47:21.726Z",
   "packageName": "@praxisui/dynamic-form",
-  "packageVersion": "9.0.68-rc.3",
+  "packageVersion": "10.0.0-rc.10",
   "sourceRegistry": "praxis-component-registry-ingestion",
   "sourceRegistryVersion": "1.0.0",
   "componentCount": 2,
@@ -272,6 +272,13 @@
           "required": false,
           "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": "presentationPreset",
+          "type": "FormPresentationPreset",
+          "required": false,
+          "description": "Preset visual nativo para modo apresentação: corporate-dossier, editorial-card, compact-presentation ou default.",
+          "label": "Preset de Apresentação"
+        },
         {
           "name": "presentationModeGlobal",
           "type": "boolean | null",
@@ -9200,9 +9207,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  - 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')\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",
           "sourcePointer": "projects/praxis-dynamic-form/src/lib/praxis-dynamic-form.metadata.ts",
-          "contentHash": "57063c838a09c8c0eedf363c56552f772223f3ed3159b0cf265f4f88f5a5214d",
+          "contentHash": "8425658a28ef61e2ebcf2ce2cc5b45835050556a4f810e83a4c167290dfcd80a",
           "sourceKind": "component_definition",
           "sourceId": "praxis-dynamic-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-08-19"
+last_updated: "2026-09-10"
 ---
 
 # Dynamic Form Authoring Document Semantics
@@ -50,6 +50,12 @@ Patches vindos de `@praxisui/metadata-editor` para `fieldMetadata` seguem semant
 
 Para `entityLookup`, o bloco `fieldMetadata[].optionSource` e aninhado e deve ser mesclado em profundidade. O dynamic-form deve preservar campos existentes, como `key`, `resourcePath`, `valuePropertyPath` e `capabilities.byIds`, quando o editor alterar apenas partes do contrato, como `dependsOn`, `selectionPolicy`, `detail` ou `capabilities.auditSnapshot`.
 
+No Layout Editor, cada evento aceito é um delta cumulativo relativo ao campo na
+abertura. A aplicação usa esse baseline imutável: A → B → Aplicar → A → Concluir
+restaura A mesmo quando o delta final está vazio. Alterações em outros campos do
+rascunho pai são preservadas. Arrays são substituídos e `null` remove somente a
+propriedade endereçada; a identidade `name` permanece estável.
+
 Essa regra evita perda silenciosa do contrato canonico de Entity Lookup durante o fluxo: abrir editor -> aplicar/salvar -> reabrir editor -> runtime consumir.
 
 ## Consequences