@praxisui/dynamic-form 8.0.0-beta.33 → 8.0.0-beta.34

package/fesm2022/{praxisui-dynamic-form-dynamic-form-agentic-authoring-turn-flow-IcmiP6u5.mjs → praxisui-dynamic-form-dynamic-form-agentic-authoring-turn-flow-CmFfx-VR.mjs}

@@ -21,7 +21,7 @@ class DynamicFormAgenticAuthoringTurnFlow {
         const componentType = this.adapter.componentType || request.componentType || 'form';
         const currentState = this.toAiJsonObject(this.adapter.getCurrentConfig());
         const runtimeState = this.optionalJsonObject(this.adapter.getRuntimeState?.());
-        const contextHints = this.optionalJsonObject(this.adapter.getAuthoringContext?.());
+        const contextHints = this.mergeJsonObjects(this.optionalJsonObject(this.adapter.getAuthoringContext?.()), this.optionalJsonObject(request.action?.contextHints));
         if (this.shouldRestrictToInlineHelp(contextHints)) {
             return this.toInlineHelpOnlyResult(prompt, request, contextHints);
         }
@@ -121,6 +121,7 @@ class DynamicFormAgenticAuthoringTurnFlow {
                 state: 'clarification',
                 phase: 'clarify',
                 sessionId: response.sessionId ?? request.sessionId,
+                observationId: response.observationId ?? request.observationId ?? null,
                 assistantMessage: response.message || 'Preciso de mais detalhes para continuar.',
                 clarificationQuestions: questions,
                 quickReplies: this.toQuickReplies(response),
@@ -133,6 +134,7 @@ class DynamicFormAgenticAuthoringTurnFlow {
                 state: 'success',
                 phase: 'summarize',
                 sessionId: response.sessionId ?? request.sessionId,
+                observationId: response.observationId ?? request.observationId ?? null,
                 assistantMessage: message,
                 statusText: message,
                 canApply: false,
@@ -144,6 +146,7 @@ class DynamicFormAgenticAuthoringTurnFlow {
                 state: 'error',
                 phase: 'capture',
                 sessionId: response.sessionId ?? request.sessionId,
+                observationId: response.observationId ?? request.observationId ?? null,
                 assistantMessage: message,
                 errorText: message,
                 diagnostics: response.warnings?.length ? { warnings: response.warnings } : undefined,
@@ -156,6 +159,7 @@ class DynamicFormAgenticAuthoringTurnFlow {
                 state: 'review',
                 phase: 'review',
                 sessionId: response.sessionId ?? request.sessionId,
+                observationId: response.observationId ?? request.observationId ?? null,
                 assistantMessage: `${response.explanation || 'Proposta de alteracao pronta para revisar.'}${suffix}`,
                 statusText: 'Revise a proposta antes de aplicar.',
                 canApply: true,
@@ -171,6 +175,7 @@ class DynamicFormAgenticAuthoringTurnFlow {
             state: 'success',
             phase: 'summarize',
             sessionId: response.sessionId ?? request.sessionId,
+            observationId: response.observationId ?? request.observationId ?? null,
             assistantMessage: response.message || response.explanation || 'Nenhuma alteracao necessaria.',
             statusText: response.message || response.explanation || 'Nenhuma alteracao necessaria.',
             canApply: false,
@@ -229,6 +234,8 @@ class DynamicFormAgenticAuthoringTurnFlow {
             id: reply.id,
             label: reply.label,
             value: reply.prompt,
+            description: reply.description ?? undefined,
+            contextHints: reply.contextHints ? { ...reply.contextHints } : undefined,
         }));
         return labels.map((label, index) => ({
             id: `dynamic-form-clarification-${index + 1}`,
@@ -244,12 +251,14 @@ class DynamicFormAgenticAuthoringTurnFlow {
             return payloads
                 .map((option, index) => {
                 const label = option.label?.trim() || option.value?.trim() || `Opcao ${index + 1}`;
-                const prompt = option.example?.trim() || option.value?.trim() || label;
+                const prompt = option.value?.trim() || option.example?.trim() || label;
                 return {
                     id: `option-${index + 1}`,
                     label,
                     prompt,
                     kind: 'clarification-option',
+                    description: option.example?.trim() || undefined,
+                    contextHints: this.optionalJsonObject(option.contextHints),
                 };
             });
         }
@@ -260,6 +269,8 @@ class DynamicFormAgenticAuthoringTurnFlow {
             label: option.trim(),
             prompt: option.trim(),
             kind: 'clarification-option',
+            description: undefined,
+            contextHints: undefined,
         }));
     }
     buildCurrentStateDigest(currentState, runtimeState) {
@@ -313,6 +324,16 @@ class DynamicFormAgenticAuthoringTurnFlow {
         const object = this.toAiJsonObject(value);
         return Object.keys(object).length ? object : undefined;
     }
+    mergeJsonObjects(base, overlay) {
+        if (!base)
+            return overlay;
+        if (!overlay)
+            return base;
+        return {
+            ...base,
+            ...overlay,
+        };
+    }
     toAiJsonObject(value) {
         const record = this.toRecord(value);
         if (!record) {

package/fesm2022/praxisui-dynamic-form.mjs

@@ -199,6 +199,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.14", ngImpo
  * Non-date arrays and other values are returned untouched.
  */
 function normalizeDateArrays(data) {
+    if (data instanceof Date) {
+        return data;
+    }
     if (Array.isArray(data)) {
         if (isDateArray(data)) {
             return formatDateArray(data);
@@ -10861,7 +10864,7 @@ class PraxisDynamicForm {
         if (this.loadedEntityId === this.pendingEntityId) {
             if (this.loadedEntityData && Object.keys(this.form.controls).length) {
                 this.entityHydrationPending = false;
-                this.form.patchValue(this.loadedEntityData);
+                this.form.patchValue(this.normalizeFormPatchValue(this.loadedEntityData));
                 this.hydratedEntityId = this.pendingEntityId;
                 this.debugLog('[PDF] loadEntity:repatch', { id: this.pendingEntityId });
             }
@@ -10883,7 +10886,7 @@ class PraxisDynamicForm {
             next: (data) => {
                 this.entityHydrationPending = false;
                 if (data && typeof data === 'object') {
-                    const normalized = normalizeDateArrays(data);
+                    const normalized = this.normalizeFormPatchValue(data);
                     this.loadedEntityData = normalized;
                     if (Object.keys(this.form.controls).length) {
                         this.form.patchValue(normalized);
@@ -11229,7 +11232,7 @@ class PraxisDynamicForm {
             : null;
         const valueToRestore = snapshotValue ?? fallbackEntityValue ?? fallbackInitialValue;
         if (valueToRestore) {
-            this.form.patchValue(valueToRestore, { emitEvent: false });
+            this.form.patchValue(this.normalizeFormPatchValue(valueToRestore), { emitEvent: false });
         }
         if (!previousState ||
             !options.preserveInteractionState ||
@@ -11247,9 +11250,53 @@ class PraxisDynamicForm {
         if (!this.initialValue || typeof this.initialValue !== 'object') {
             return null;
         }
-        const normalized = normalizeDateArrays(this.initialValue);
+        const normalized = this.normalizeFormPatchValue(this.initialValue);
         return Object.keys(normalized || {}).length ? normalized : null;
     }
+    normalizeFormPatchValue(value) {
+        const normalized = normalizeDateArrays(value);
+        if (!normalized || typeof normalized !== 'object' || Array.isArray(normalized)) {
+            return normalized;
+        }
+        const fieldMetadata = this.config?.fieldMetadata || [];
+        if (!fieldMetadata.length) {
+            return normalized;
+        }
+        const result = { ...normalized };
+        for (const field of fieldMetadata) {
+            if (!field?.name || !this.isDateControlMetadata(field) || !(field.name in result)) {
+                continue;
+            }
+            result[field.name] = this.coerceDateControlValue(result[field.name]);
+        }
+        return result;
+    }
+    isDateControlMetadata(field) {
+        const controlType = normalizeControlTypeKey(field?.controlType);
+        return controlType === 'DATE_PICKER' || controlType === 'DATE' || controlType === 'DATE_INPUT';
+    }
+    coerceDateControlValue(value) {
+        if (value == null || value === '') {
+            return value;
+        }
+        if (value instanceof Date) {
+            return Number.isNaN(value.getTime()) ? null : value;
+        }
+        if (typeof value !== 'string') {
+            return value;
+        }
+        const trimmed = value.trim();
+        if (!trimmed) {
+            return value;
+        }
+        if (/^\d{4}-\d{2}-\d{2}$/.test(trimmed)) {
+            const [year, month, day] = trimmed.split('-').map(Number);
+            const date = new Date(year, month - 1, day);
+            return Number.isNaN(date.getTime()) ? value : date;
+        }
+        const parsed = new Date(trimmed);
+        return Number.isNaN(parsed.getTime()) ? value : parsed;
+    }
     /**
      * Backward-compatible required validation for DATE_RANGE controls.
      * Some core builds do not enforce required start/end for dateRange fields.
@@ -13375,12 +13422,21 @@ class PraxisDynamicForm {
         if (!controller)
             return;
         const state = controller.snapshot();
+        const contextHints = reply.contextHints ? { ...reply.contextHints } : undefined;
         const next$ = state.state === 'clarification'
-            ? controller.answerClarification(reply.prompt)
+            ? controller.answerClarification({
+                id: reply.id,
+                label: reply.label,
+                value: reply.prompt,
+                description: reply.description ?? undefined,
+                contextHints,
+            })
             : controller.submitPrompt(reply.prompt, {
                 kind: reply.kind || 'quick-reply',
                 id: reply.id,
                 value: reply.prompt,
+                displayPrompt: reply.label,
+                contextHints,
             });
         next$.subscribe((nextState) => {
             this.aiAssistantPrompt = '';
@@ -13411,7 +13467,7 @@ class PraxisDynamicForm {
     initializeAiAssistantController() {
         if (this.aiAssistantController)
             return;
-        import('./praxisui-dynamic-form-dynamic-form-agentic-authoring-turn-flow-IcmiP6u5.mjs')
+        import('./praxisui-dynamic-form-dynamic-form-agentic-authoring-turn-flow-CmFfx-VR.mjs')
             .then(({ DynamicFormAgenticAuthoringTurnFlow }) => {
             if (this.aiAssistantController)
                 return;

package/package.json

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

package/types/praxisui-dynamic-form.d.ts

@@ -999,6 +999,9 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     private isCompatibleRuntimeStateContext;
     private restoreFormRuntimeState;
     private getNormalizedInitialValue;
+    private normalizeFormPatchValue;
+    private isDateControlMetadata;
+    private coerceDateControlValue;
     /**
      * Backward-compatible required validation for DATE_RANGE controls.
      * Some core builds do not enforce required start/end for dateRange fields.