@praxisui/dynamic-form 3.0.0-beta.9 → 4.0.0-beta.0

package/index.d.ts

@@ -1,12 +1,13 @@
 import * as i0 from '@angular/core';
-import { OnChanges, OnDestroy, EventEmitter, SimpleChanges, OnInit, ChangeDetectorRef, Provider, AfterViewInit, ElementRef } from '@angular/core';
+import { OnChanges, OnDestroy, EventEmitter, SimpleChanges, OnInit, ChangeDetectorRef, NgZone, Provider, AfterViewInit, ElementRef } from '@angular/core';
+import { HttpClient } from '@angular/common/http';
 import { FormGroup, FormBuilder, FormArray } from '@angular/forms';
 import { Router, ActivatedRoute } from '@angular/router';
 import { MatDialog } from '@angular/material/dialog';
 import { MatSnackBar } from '@angular/material/snack-bar';
 import { CdkDragStart, CdkDragMove, CdkDragEnd, CdkDragDrop } from '@angular/cdk/drag-drop';
 import * as _praxisui_core from '@praxisui/core';
-import { AsyncConfigStorage, FormLayout, FieldMetadata, FormLayoutRule, FormRuleTargetType as FormRuleTargetType$1, FormSection, FormRow, FormColumn, FormConfig, FormActionButton, BackConfig, FormHooksLayout, EndpointConfig, FormSubmitEvent, FormReadyEvent, FormValueChangeEvent, SyncResult, FormInitializationError, LoadingState, FormCustomActionEvent, FormActionConfirmationEvent, WidgetEventEnvelope, WidgetDefinition, GenericCrudService, ConnectionStorage, DynamicFormService, ErrorMessageService, SchemaNormalizerService, ComponentMetadataRegistry, GlobalConfigService, ComponentKeyService, LoadingOrchestrator, PraxisLoadingRenderer, FormHooksRegistry, FormHookPreset, LoggerService, FormSectionHeaderAction, FormSectionHeaderConfig, FormConfigState, FieldDefinition, ComponentDocMeta, Breakpoint, IconPickerService, SurfaceOpenPayload, AiCapabilityCategory, AiValueKind, AiCapability, AiCapabilityCatalog } from '@praxisui/core';
+import { AsyncConfigStorage, FormLayout, FieldMetadata, FormLayoutRule, FormRuleTargetType as FormRuleTargetType$1, FormSection, FormRow, FormColumn, FormConfig, FormActionButton, BackConfig, ApiEndpoint, ApiUrlEntry, FormHooksLayout, EndpointConfig, FormSubmitEvent, FormReadyEvent, FormValueChangeEvent, SyncResult, FormInitializationError, LoadingState, FormCustomActionEvent, FormActionConfirmationEvent, WidgetEventEnvelope, WidgetDefinition, GenericCrudService, ConnectionStorage, DynamicFormService, ErrorMessageService, SchemaNormalizerService, ComponentMetadataRegistry, GlobalConfigService, ComponentKeyService, LoadingOrchestrator, ApiUrlConfig, PraxisLoadingRenderer, FormHooksRegistry, FormHookPreset, LoggerService, FormSectionHeaderAction, FormSectionHeaderConfig, FormConfigState, FieldDefinition, ComponentDocMeta, Breakpoint, IconPickerService, SurfaceOpenPayload, AiCapabilityCategory, AiValueKind, AiCapability, AiCapabilityCatalog } from '@praxisui/core';
 import * as rxjs from 'rxjs';
 import { Observable, BehaviorSubject } from 'rxjs';
 import { SettingsPanelService, SettingsValueProvider } from '@praxisui/settings-panel';
@@ -399,6 +400,14 @@ interface DynamicFormValidationContext {
         schemaHash?: string;
     };
 }
+type DynamicFormRuntimeValueSource = 'runtime-input' | 'legacy-crud';
+interface DynamicFormResolvedRuntimeContract {
+    schemaUrl?: string;
+    schemaSource?: DynamicFormRuntimeValueSource;
+    submitUrl?: string;
+    submitMethod?: 'post' | 'put' | 'patch';
+    submitSource?: DynamicFormRuntimeValueSource;
+}
 interface DynamicFormProjectionContext {
     mode?: DynamicFormMode;
 }
@@ -408,6 +417,7 @@ interface DynamicFormRuntimeContext {
     server?: {
         schemaHash?: string;
     };
+    resolvedContract?: DynamicFormResolvedRuntimeContract;
 }
 interface DynamicFormApplyPlan {
     canonicalConfig: FormConfig;
@@ -468,6 +478,7 @@ type ResolvedSectionHeaderVisual = {
 };
 declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     private crud;
+    private http;
     private fb;
     private cdr;
     private layoutService;
@@ -487,6 +498,8 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     private global;
     private componentKeys;
     private loadingOrchestrator;
+    private ngZone;
+    private apiUrlConfig;
     private loadingRenderer?;
     private router?;
     private route?;
@@ -511,6 +524,18 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
      * 'filter' usa o schema do DTO de filtro (via /schemas/filtered no POST /filter request)
      */
     schemaSource: 'resource' | 'filter';
+    /** Canonical schema URL published by the backend surface catalog. */
+    schemaUrl?: string | null;
+    /** Canonical submit URL published by the backend surface catalog. */
+    submitUrl?: string | null;
+    /** Canonical submit method published by the backend surface catalog. */
+    submitMethod?: string | null;
+    /** Canonical response schema URL exposed for runtime diagnostics/follow-up. */
+    responseSchemaUrl?: string | null;
+    /** API endpoint entry used to resolve relative canonical URLs in detached hosts. */
+    apiEndpointKey?: ApiEndpoint | string | null;
+    /** Resolved API entry carried by detached hosts when route-scoped API_URL is not inherited. */
+    apiUrlEntry?: ApiUrlEntry | null;
     /**
      * CUSTOMIZAÇÃO DE LAYOUT - NÃO confundir com edição de dados do formulário
      *
@@ -613,6 +638,9 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     private lastSchemaMeta?;
     private schemaRootHooks?;
     private destroy$;
+    private formValueChangesSubscription;
+    private formBuildCycleId;
+    private suppressedValueChangeBuildId;
     private readonly sectionHeaderBlobUrlCache;
     private readonly sectionHeaderObjectUrls;
     private lastCorrelationId?;
@@ -682,12 +710,21 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     private mountAnimationTimer;
     protected isMounting: boolean;
     private hasBuiltFormFromConfig;
-    constructor(crud: GenericCrudService<any>, fb: FormBuilder, cdr: ChangeDetectorRef, layoutService: FormLayoutService, contextService: FormContextService, rulesService: FormRulesService, settingsPanel: SettingsPanelService, dialog: MatDialog, asyncConfigStorage: AsyncConfigStorage, connectionStorage: ConnectionStorage, dynamicForm: DynamicFormService, snackBar: MatSnackBar, canvasState: CanvasStateService, dynamicLayout: DynamicFormLayoutService, errorMessages: ErrorMessageService, schemaNormalizer: SchemaNormalizerService, componentMetaRegistry: ComponentMetadataRegistry, global: GlobalConfigService, componentKeys: ComponentKeyService, loadingOrchestrator: LoadingOrchestrator, loadingRenderer?: PraxisLoadingRenderer | undefined, router?: Router | undefined, route?: ActivatedRoute | undefined, hooksRegistry?: FormHooksRegistry | undefined, hookPresets?: FormHookPreset[] | null | undefined, logger?: LoggerService | undefined);
+    constructor(crud: GenericCrudService<any>, http: HttpClient, fb: FormBuilder, cdr: ChangeDetectorRef, layoutService: FormLayoutService, contextService: FormContextService, rulesService: FormRulesService, settingsPanel: SettingsPanelService, dialog: MatDialog, asyncConfigStorage: AsyncConfigStorage, connectionStorage: ConnectionStorage, dynamicForm: DynamicFormService, snackBar: MatSnackBar, canvasState: CanvasStateService, dynamicLayout: DynamicFormLayoutService, errorMessages: ErrorMessageService, schemaNormalizer: SchemaNormalizerService, componentMetaRegistry: ComponentMetadataRegistry, global: GlobalConfigService, componentKeys: ComponentKeyService, loadingOrchestrator: LoadingOrchestrator, ngZone: NgZone, apiUrlConfig: ApiUrlConfig, loadingRenderer?: PraxisLoadingRenderer | undefined, router?: Router | undefined, route?: ActivatedRoute | undefined, hooksRegistry?: FormHooksRegistry | undefined, hookPresets?: FormHookPreset[] | null | undefined, logger?: LoggerService | undefined);
     private emitLoadingState;
     private buildLoadingContext;
     private beginLoading;
     private endLoading;
     private runHooks;
+    private resolveSubmitOperation;
+    private buildSubmitRequest;
+    private normalizeSubmitMethod;
+    private resolveSubmitHref;
+    private resolveApiHref;
+    private resolveApiOrigin;
+    private resolveApiEntry;
+    private configureCrudRuntime;
+    private unwrapRestApiResponse;
     private resolveStageDeclarations;
     private resolvePresetDeclarations;
     get shouldShowConfigControls(): boolean;
@@ -712,6 +749,9 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     private syncWithServer;
     private loadEntity;
     private buildFormFromConfig;
+    private resetFormValueChangesSubscription;
+    private scheduleValueChangeBootstrapRelease;
+    private hasInteractiveFormState;
     private captureFormRuntimeState;
     private buildCurrentFormRuntimeContext;
     private buildRestoreTargetContext;
@@ -939,6 +979,8 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     applyConfigFromAdapter(nextConfig: FormConfig): void;
     applyConfigFromAdapter(nextConfig: DynamicFormAuthoringDocument): void;
     private buildDynamicFormEditorRuntimeContext;
+    private buildResolvedRuntimeContractForEditor;
+    private readLegacySchemaUrlForEditor;
     private captureCurrentContextSnapshot;
     private captureCurrentPresentationSnapshot;
     private captureCurrentSchemaPrefsSnapshot;
@@ -952,6 +994,7 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     retryInitialization(): void;
     getErrorTitle(): string;
     showDetailedError(): void;
+    private tryBuildExplicitSchemaContext;
     private buildSchemaContext;
     private getSchemaWithCache;
     private isReactiveValidationEnabled;
@@ -960,8 +1003,8 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     private logRowGapsSnapshot;
     private applyPresentationVars;
     private applyPresentationConfig;
-    static ɵfac: i0.ɵɵFactoryDeclaration<PraxisDynamicForm, [null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, { optional: true; }, { optional: true; }, { optional: true; }, { optional: true; }, { optional: true; }, { optional: true; }]>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<PraxisDynamicForm, "praxis-dynamic-form", never, { "resourcePath": { "alias": "resourcePath"; "required": false; }; "resourceId": { "alias": "resourceId"; "required": false; }; "editorialContext": { "alias": "editorialContext"; "required": false; }; "mode": { "alias": "mode"; "required": false; }; "config": { "alias": "config"; "required": false; }; "schemaSource": { "alias": "schemaSource"; "required": false; }; "enableCustomization": { "alias": "enableCustomization"; "required": false; }; "formId": { "alias": "formId"; "required": false; }; "componentInstanceId": { "alias": "componentInstanceId"; "required": false; }; "layout": { "alias": "layout"; "required": false; }; "backConfig": { "alias": "backConfig"; "required": false; }; "hooks": { "alias": "hooks"; "required": false; }; "removeEmptyContainersOnSave": { "alias": "removeEmptyContainersOnSave"; "required": false; }; "reactiveValidation": { "alias": "reactiveValidation"; "required": false; }; "reactiveValidationDebounceMs": { "alias": "reactiveValidationDebounceMs"; "required": false; }; "notifyIfOutdated": { "alias": "notifyIfOutdated"; "required": false; }; "snoozeMs": { "alias": "snoozeMs"; "required": false; }; "autoOpenSettingsOnOutdated": { "alias": "autoOpenSettingsOnOutdated"; "required": false; }; "readonlyModeGlobal": { "alias": "readonlyModeGlobal"; "required": false; }; "disabledModeGlobal": { "alias": "disabledModeGlobal"; "required": false; }; "presentationModeGlobal": { "alias": "presentationModeGlobal"; "required": false; }; "visibleGlobal": { "alias": "visibleGlobal"; "required": false; }; "customEndpoints": { "alias": "customEndpoints"; "required": false; }; }, { "formSubmit": "formSubmit"; "formCancel": "formCancel"; "formReset": "formReset"; "configChange": "configChange"; "formReady": "formReady"; "valueChange": "valueChange"; "syncCompleted": "syncCompleted"; "initializationError": "initializationError"; "loadingStateChange": "loadingStateChange"; "enableCustomizationChange": "enableCustomizationChange"; "customAction": "customAction"; "actionConfirmation": "actionConfirmation"; "schemaStatusChange": "schemaStatusChange"; "fieldRenderError": "fieldRenderError"; "widgetEvent": "widgetEvent"; }, never, never, true, never>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<PraxisDynamicForm, [null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, { optional: true; }, { optional: true; }, { optional: true; }, { optional: true; }, { optional: true; }, { optional: true; }]>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<PraxisDynamicForm, "praxis-dynamic-form", never, { "resourcePath": { "alias": "resourcePath"; "required": false; }; "resourceId": { "alias": "resourceId"; "required": false; }; "editorialContext": { "alias": "editorialContext"; "required": false; }; "mode": { "alias": "mode"; "required": false; }; "config": { "alias": "config"; "required": false; }; "schemaSource": { "alias": "schemaSource"; "required": false; }; "schemaUrl": { "alias": "schemaUrl"; "required": false; }; "submitUrl": { "alias": "submitUrl"; "required": false; }; "submitMethod": { "alias": "submitMethod"; "required": false; }; "responseSchemaUrl": { "alias": "responseSchemaUrl"; "required": false; }; "apiEndpointKey": { "alias": "apiEndpointKey"; "required": false; }; "apiUrlEntry": { "alias": "apiUrlEntry"; "required": false; }; "enableCustomization": { "alias": "enableCustomization"; "required": false; }; "formId": { "alias": "formId"; "required": false; }; "componentInstanceId": { "alias": "componentInstanceId"; "required": false; }; "layout": { "alias": "layout"; "required": false; }; "backConfig": { "alias": "backConfig"; "required": false; }; "hooks": { "alias": "hooks"; "required": false; }; "removeEmptyContainersOnSave": { "alias": "removeEmptyContainersOnSave"; "required": false; }; "reactiveValidation": { "alias": "reactiveValidation"; "required": false; }; "reactiveValidationDebounceMs": { "alias": "reactiveValidationDebounceMs"; "required": false; }; "notifyIfOutdated": { "alias": "notifyIfOutdated"; "required": false; }; "snoozeMs": { "alias": "snoozeMs"; "required": false; }; "autoOpenSettingsOnOutdated": { "alias": "autoOpenSettingsOnOutdated"; "required": false; }; "readonlyModeGlobal": { "alias": "readonlyModeGlobal"; "required": false; }; "disabledModeGlobal": { "alias": "disabledModeGlobal"; "required": false; }; "presentationModeGlobal": { "alias": "presentationModeGlobal"; "required": false; }; "visibleGlobal": { "alias": "visibleGlobal"; "required": false; }; "customEndpoints": { "alias": "customEndpoints"; "required": false; }; }, { "formSubmit": "formSubmit"; "formCancel": "formCancel"; "formReset": "formReset"; "configChange": "configChange"; "formReady": "formReady"; "valueChange": "valueChange"; "syncCompleted": "syncCompleted"; "initializationError": "initializationError"; "loadingStateChange": "loadingStateChange"; "enableCustomizationChange": "enableCustomizationChange"; "customAction": "customAction"; "actionConfirmation": "actionConfirmation"; "schemaStatusChange": "schemaStatusChange"; "fieldRenderError": "fieldRenderError"; "widgetEvent": "widgetEvent"; }, never, never, true, never>;
 }
 
 declare class FormConfigService {
@@ -1052,6 +1095,8 @@ declare class PraxisDynamicFormConfigEditor implements SettingsValueProvider, On
     private initialConfig;
     private initialDocument;
     private readonly openedWithCanonicalDocument;
+    readonly runtimeContext?: DynamicFormRuntimeContext;
+    readonly runtimeContract?: DynamicFormResolvedRuntimeContract;
     backConfig?: BackConfig;
     private includeBackConfigBlock;
     formId?: string;
@@ -1113,6 +1158,8 @@ declare class PraxisDynamicFormConfigEditor implements SettingsValueProvider, On
     isPresentationBlockPersisted(): boolean;
     isSchemaPrefsBlockPersisted(): boolean;
     isBackConfigBlockPersisted(): boolean;
+    hasResolvedRuntimeContract(): boolean;
+    describeRuntimeSource(source?: DynamicFormRuntimeValueSource): string;
     onInputModeChange(): void;
     onPresentationPrefsChange(reason: string): void;
     onSchemaPrefsChange(reason: string): void;
@@ -1129,6 +1176,7 @@ declare class PraxisDynamicFormConfigEditor implements SettingsValueProvider, On
     private loadPrefsFromStorage;
     private normalizeMode;
     private buildAuthoringDocument;
+    private normalizeResolvedRuntimeContract;
     private createBackConfigState;
     private mergePresentationPrefs;
     private mergeSchemaPrefs;
@@ -1169,6 +1217,8 @@ declare class PraxisFilterForm implements OnChanges, OnDestroy {
     ngOnChanges(changes: SimpleChanges): void;
     ngOnDestroy(): void;
     private buildForm;
+    private buildRestorableValues;
+    private hasExplicitDefaultValue;
     onFormSubmit(): void;
     getColumnFields(column: FormColumn): FieldMetadata[];
     get fieldMetadata(): FieldMetadata[];
@@ -1859,4 +1909,4 @@ declare const FORM_COMPONENT_AI_CAPABILITIES: CapabilityCatalog;
 declare function getFormAiCatalog(formConfig?: FormConfig): AiCapabilityCatalog;
 
 export { ActionsEditorComponent, CanvasStateService, CanvasToolbarComponent, ColumnEditorComponent, DynamicFormLayoutService, FORM_AI_CAPABILITIES, FORM_COMPONENT_AI_CAPABILITIES, FieldConfiguratorComponent, FieldEditorComponent, FormConfigService, FormContextService, FormLayoutService, JsonConfigEditorComponent, LayoutColorToken, LayoutEditorComponent, LayoutPrefsService, PRAXIS_DYNAMIC_FORM_COMPONENT_METADATA, PRAXIS_FILTER_FORM_COMPONENT_METADATA, PraxisDynamicForm, PraxisDynamicFormConfigEditor, PraxisFilterForm, PraxisFormActionsComponent, RowConfiguratorComponent, RowEditorComponent, SETTINGS_PANEL_DYNAMIC_FORM_PROVIDER, SectionEditorComponent, TASK_PRESETS, applyVisibilityRules, buildDynamicFormApplyPlan, createDynamicFormAuthoringDocument, formLayoutRulesToBuilderState, getFormAiCatalog, getFormCapabilities, getFormEnum, isRuleSatisfied, normalizeDateArrays, normalizeDynamicFormAuthoringDocument, parseLegacyOrDynamicFormDocument, providePraxisDynamicFormMetadata, providePraxisFilterFormMetadata, provideSettingsPanelDynamicForm, ruleBuilderStateToFormLayoutRules, serializeDynamicFormAuthoringDocument, stripLegacyFieldMetadata, toCanonicalDynamicFormConfig, validateDynamicFormAuthoringDocument, validateDynamicFormAuthoringInput };
-export type { CanvasElement, CanvasElementType, CanvasPathPart, Capability$1 as Capability, CapabilityCatalog$1 as CapabilityCatalog, CapabilityCategory$1 as CapabilityCategory, DynamicFieldRenderErrorEvent, DynamicFormApplyPlan, DynamicFormAuthoringDocument, DynamicFormBindings, DynamicFormContextSnapshot, DynamicFormMode, DynamicFormPresentationSnapshot, DynamicFormProjectionContext, DynamicFormRuntimeContext, DynamicFormSchemaPrefsSnapshot, DynamicFormValidationContext, EditorDiagnostic, EditorDocument, FieldPath, FieldPathContainer, FieldPathWithIndex, Capability as FormComponentCapability, CapabilityCatalog as FormComponentCapabilityCatalog, CapabilityCategory as FormComponentCapabilityCategory, ValueKind as FormComponentValueKind, FormConfigLike, IdPath, JsonEditorEvent, JsonValidationResult, LayoutChange, LayoutResult, Operation, Path, PathWithIndex, PraxisFormActionEvent, RemovePolicy, ValidationReport, ValueKind$1 as ValueKind };
+export type { CanvasElement, CanvasElementType, CanvasPathPart, Capability$1 as Capability, CapabilityCatalog$1 as CapabilityCatalog, CapabilityCategory$1 as CapabilityCategory, DynamicFieldRenderErrorEvent, DynamicFormApplyPlan, DynamicFormAuthoringDocument, DynamicFormBindings, DynamicFormContextSnapshot, DynamicFormMode, DynamicFormPresentationSnapshot, DynamicFormProjectionContext, DynamicFormResolvedRuntimeContract, DynamicFormRuntimeContext, DynamicFormRuntimeValueSource, DynamicFormSchemaPrefsSnapshot, DynamicFormValidationContext, EditorDiagnostic, EditorDocument, FieldPath, FieldPathContainer, FieldPathWithIndex, Capability as FormComponentCapability, CapabilityCatalog as FormComponentCapabilityCatalog, CapabilityCategory as FormComponentCapabilityCategory, ValueKind as FormComponentValueKind, FormConfigLike, IdPath, JsonEditorEvent, JsonValidationResult, LayoutChange, LayoutResult, Operation, Path, PathWithIndex, PraxisFormActionEvent, RemovePolicy, ValidationReport, ValueKind$1 as ValueKind };

package/package.json

@@ -1,17 +1,17 @@
 {
   "name": "@praxisui/dynamic-form",
-  "version": "3.0.0-beta.9",
+  "version": "4.0.0-beta.0",
   "description": "Angular dynamic form engine for Praxis UI: metadata-driven forms, hooks, and services integrating @praxisui/* packages.",
   "peerDependencies": {
     "@angular/common": "^20.0.0",
     "@angular/core": "^20.0.0",
     "@angular/cdk": "^20.0.0",
-    "@praxisui/settings-panel": "^3.0.0-beta.9",
-    "@praxisui/visual-builder": "^3.0.0-beta.9",
-    "@praxisui/specification-core": "^3.0.0-beta.9",
-    "@praxisui/specification": "^3.0.0-beta.9",
-    "@praxisui/core": "^3.0.0-beta.9",
-    "@praxisui/cron-builder": "^3.0.0-beta.9"
+    "@praxisui/settings-panel": "^4.0.0-beta.0",
+    "@praxisui/visual-builder": "^4.0.0-beta.0",
+    "@praxisui/specification-core": "^4.0.0-beta.0",
+    "@praxisui/specification": "^4.0.0-beta.0",
+    "@praxisui/core": "^4.0.0-beta.0",
+    "@praxisui/cron-builder": "^4.0.0-beta.0"
   },
   "dependencies": {
     "tslib": "^2.3.0",