@praxisui/dynamic-form 9.0.68-rc.2 → 10.0.0-rc.0

package/ai/component-registry.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": "1.0.0",
-  "generatedAt": "2026-09-10T01:25:13.157Z",
+  "generatedAt": "2026-09-10T12:25:16.581Z",
   "packageName": "@praxisui/dynamic-form",
-  "packageVersion": "9.0.68-rc.2",
+  "packageVersion": "10.0.0-rc.0",
   "sourceRegistry": "praxis-component-registry-ingestion",
   "sourceRegistryVersion": "1.0.0",
   "componentCount": 2,

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

package/fesm2022/praxisui-dynamic-form.mjs

@@ -24140,6 +24140,45 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.14", ngImpo
   `, styles: [".destination-fields{display:grid;gap:var(--px-editor-section-gap, 1rem)}mat-form-field{width:100%;min-width:0}.destination-option{display:grid;white-space:normal;overflow-wrap:anywhere}.destination-summary{color:var(--mat-sys-on-surface-variant, var(--md-sys-color-on-surface-variant));font-size:var(--mat-sys-body-small-size, .75rem);line-height:var(--mat-sys-body-small-line-height, 1rem)}mat-hint{overflow-wrap:anywhere}\n"] }]
         }] });
 
+const unsafeKeys = new Set(['__proto__', 'prototype', 'constructor']);
+function isRecord$1(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return false;
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+}
+function cloneValue(value) {
+    if (Array.isArray(value))
+        return value.map(cloneValue);
+    if (!isRecord$1(value))
+        return value;
+    return Object.fromEntries(Object.entries(value)
+        .filter(([key]) => !unsafeKeys.has(key))
+        .map(([key, entry]) => [key, cloneValue(entry)]));
+}
+/** Materializes the metadata editor's recursive delta without mutating its baseline. */
+function mergeFieldMetadataPatch(base, patch) {
+    if (!isRecord$1(patch)) {
+        return cloneValue(patch);
+    }
+    const result = {};
+    if (isRecord$1(base)) {
+        for (const [key, value] of Object.entries(base)) {
+            if (!unsafeKeys.has(key))
+                result[key] = cloneValue(value);
+        }
+    }
+    for (const [key, value] of Object.entries(patch)) {
+        if (unsafeKeys.has(key))
+            continue;
+        if (value === null)
+            delete result[key];
+        else
+            result[key] = mergeFieldMetadataPatch(result[key], value);
+    }
+    return result;
+}
+
 /**
  * Editor component for configuring sections, rows and fields of a dynamic form.
  * Provides a collapsible palette of available fields.
@@ -24592,10 +24631,12 @@ class LayoutEditorComponent {
     }
     openFieldMetadataEditorInternal(editorComponent, field) {
         const fieldName = field.name;
+        // Each emitted delta is cumulative relative to the field opened in the child.
+        const baseline = mergeFieldMetadataPatch(field, {});
         const handlePatch = (patch) => {
             if (!patch)
                 return;
-            this.applyFieldMetadataPatch(fieldName, patch);
+            this.applyFieldMetadataPatch(fieldName, patch, baseline);
         };
         const title = this.t('field.editMetadataTitle', { field: field.label || field.name });
         const ref = this.settingsPanel.openChild({
@@ -24614,13 +24655,12 @@ class LayoutEditorComponent {
         ref?.applied$?.subscribe(handlePatch);
         ref?.saved$?.subscribe(handlePatch);
     }
-    applyFieldMetadataPatch(fieldName, patch) {
+    applyFieldMetadataPatch(fieldName, patch, baseline) {
         const fieldMetadata = (this.config.fieldMetadata || []).map((field) => {
             if (field.name !== fieldName)
                 return field;
             return {
-                ...field,
-                ...patch,
+                ...mergeFieldMetadataPatch(baseline ?? field, patch),
                 name: field.name,
             };
         });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@praxisui/dynamic-form",
-  "version": "9.0.68-rc.2",
+  "version": "10.0.0-rc.0",
   "description": "Angular dynamic form engine for Praxis UI: metadata-driven forms, hooks, and services integrating @praxisui/* packages.",
   "peerDependencies": {
     "@angular/common": "^21.0.0",
@@ -9,13 +9,13 @@
     "@angular/forms": "^21.0.0",
     "@angular/material": "^21.0.0",
     "@angular/router": "^21.0.0",
-    "@praxisui/ai": "^9.0.68-rc.2",
-    "@praxisui/dynamic-fields": "^9.0.68-rc.2",
-    "@praxisui/metadata-editor": "^9.0.68-rc.2",
-    "@praxisui/rich-content": "^9.0.68-rc.2",
-    "@praxisui/settings-panel": "^9.0.68-rc.2",
-    "@praxisui/visual-builder": "^9.0.68-rc.2",
-    "@praxisui/core": "^9.0.68-rc.2",
+    "@praxisui/ai": "^10.0.0-rc.0",
+    "@praxisui/dynamic-fields": "^10.0.0-rc.0",
+    "@praxisui/metadata-editor": "^10.0.0-rc.0",
+    "@praxisui/rich-content": "^10.0.0-rc.0",
+    "@praxisui/settings-panel": "^10.0.0-rc.0",
+    "@praxisui/visual-builder": "^10.0.0-rc.0",
+    "@praxisui/core": "^10.0.0-rc.0",
     "rxjs": "^7.8.0"
   },
   "dependencies": {