@praxisui/dynamic-form 6.0.0-beta.0 → 8.0.0-beta.0

package/index.d.ts

@@ -7,7 +7,7 @@ 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, PraxisJsonLogicService, FormSection, FormRow, FormColumn, FormConfig, FormActionButton, AiCapability, 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, AiCapabilityCatalog } from '@praxisui/core';
+import { AsyncConfigStorage, FormLayout, FieldMetadata, FormLayoutRule, FormRuleTargetType as FormRuleTargetType$1, PraxisJsonLogicService, FormSection, FormRow, FormColumn, FormConfig, FormActionButton, AiCapability, BackConfig, ApiEndpoint, ApiUrlEntry, FormHooksLayout, EndpointConfig, FormSubmitEvent, FormReadyEvent, FormValueChangeEvent, SyncResult, FormInitializationError, LoadingState, FormCustomActionEvent, FormActionConfirmationEvent, RichContentDocument, JsonLogicRecord, GenericCrudService, ConnectionStorage, DynamicFormService, ErrorMessageService, SchemaNormalizerService, ComponentMetadataRegistry, GlobalConfigService, ComponentKeyService, LoadingOrchestrator, ApiUrlConfig, PraxisLoadingRenderer, FormHooksRegistry, FormHookPreset, LoggerService, FormSectionHeaderAction, FormSectionHeaderConfig, FormConfigState, FieldDefinition, ComponentDocMeta, Breakpoint, IconPickerService, SurfaceOpenPayload, AiCapabilityCategory, AiValueKind, AiCapabilityCatalog } from '@praxisui/core';
 import * as rxjs from 'rxjs';
 import { Observable, BehaviorSubject } from 'rxjs';
 import { SettingsPanelService, SettingsValueProvider } from '@praxisui/settings-panel';
@@ -512,10 +512,11 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     private readonly DEBUG;
     resourcePath?: string;
     resourceId?: string | number;
+    initialValue?: Record<string, unknown> | null;
     /**
-     * Shared editorial context for widgets hosted around the form.
+     * Shared editorial context for rich content hosted around the form.
      * Treat this input as immutable: in-place mutations do not invalidate the cached
-     * widget context snapshot used to avoid re-binding on every change detection pass.
+     * merged context snapshot used to avoid re-binding on every change detection pass.
      */
     editorialContext: Record<string, unknown> | null;
     mode: 'create' | 'edit' | 'view';
@@ -583,6 +584,8 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     visibleGlobal: boolean | null;
     get effectivePresentation(): boolean;
     get effectiveReadonly(): boolean;
+    get effectiveDisabledMode(): boolean | null;
+    get effectiveFormIsValid(): boolean;
     /** Value propagated to DynamicFieldLoader; null allows per-field metadata */
     get presentationForLoader(): boolean | null;
     /** Custom endpoints for CRUD operations */
@@ -610,10 +613,6 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     }>;
     /** Forwarded from DynamicFieldLoader to allow host-side observability. */
     fieldRenderError: EventEmitter<DynamicFieldRenderErrorEvent>;
-    /** Re-emits events from editorial widgets hosted before, before actions, or after the form. */
-    widgetEvent: EventEmitter<WidgetEventEnvelope & {
-        placement: "before" | "beforeActions" | "after";
-    }>;
     isLoading: boolean;
     submitting: boolean;
     submitError: string | null;
@@ -636,6 +635,7 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     private loadedEntityId;
     private hydratedEntityId;
     private loadedEntityData;
+    private entityHydrationPending;
     private schemaCache;
     private lastSchemaMeta?;
     private schemaRootHooks?;
@@ -643,6 +643,7 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     private formValueChangesSubscription;
     private formBuildCycleId;
     private suppressedValueChangeBuildId;
+    private pendingBootstrapValueChangeBuildId;
     private readonly sectionHeaderBlobUrlCache;
     private readonly sectionHeaderObjectUrls;
     private lastCorrelationId?;
@@ -654,24 +655,26 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     private resolvedPrefs;
     private editorialWidgetContextCache;
     private editorialWidgetContextDeps;
-    get formBlocksBefore(): WidgetDefinition[];
-    get formBlocksAfter(): WidgetDefinition[];
-    get formBlocksBeforeActions(): WidgetDefinition[];
+    private readonly emptyEditorialRichContentDocument;
+    get formBlocksBefore(): RichContentDocument | null;
+    get formBlocksAfter(): RichContentDocument | null;
+    get formBlocksBeforeActions(): RichContentDocument | null;
+    get formBlocksBeforeDocument(): RichContentDocument;
+    get formBlocksBeforeActionsDocument(): RichContentDocument;
+    get formBlocksAfterDocument(): RichContentDocument;
     get beforeActionsPlacement(): 'insideLastSection' | 'afterSections';
     get actionPlacement(): 'insideLastSection' | 'afterSections' | 'top';
     /**
-     * Precedence for editorial widget interpolation:
+     * Precedence for editorial rich-content interpolation:
      * 1. form runtime context
      * 2. config.editorialContext
      * 3. host editorialContext input
      * Later layers override earlier ones.
-     * Widget explicit inputs still win after interpolation because they are bound directly.
      *
      * Invariant: config.editorialContext and editorialContext must be replaced immutably.
      * In-place mutations do not invalidate the cached merged context snapshot.
      */
-    getEditorialWidgetContext(): Record<string, unknown>;
-    onEditorialWidgetEvent(placement: 'before' | 'beforeActions' | 'after', event: WidgetEventEnvelope): void;
+    getEditorialRichContentContext(): JsonLogicRecord;
     private reactiveValidate$?;
     private warnedMissingId;
     private schemaState;
@@ -759,6 +762,7 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     private buildRestoreTargetContext;
     private isCompatibleRuntimeStateContext;
     private restoreFormRuntimeState;
+    private getNormalizedInitialValue;
     /**
      * Backward-compatible required validation for DATE_RANGE controls.
      * Some core builds do not enforce required start/end for dateRange fields.
@@ -1011,7 +1015,7 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     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, 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>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<PraxisDynamicForm, "praxis-dynamic-form", never, { "resourcePath": { "alias": "resourcePath"; "required": false; }; "resourceId": { "alias": "resourceId"; "required": false; }; "initialValue": { "alias": "initialValue"; "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"; }, never, never, true, never>;
 }
 
 declare class FormConfigService {

package/package.json

@@ -1,15 +1,16 @@
 {
   "name": "@praxisui/dynamic-form",
-  "version": "6.0.0-beta.0",
+  "version": "8.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": "^6.0.0-beta.0",
-    "@praxisui/visual-builder": "^6.0.0-beta.0",
-    "@praxisui/core": "^6.0.0-beta.0",
-    "@praxisui/cron-builder": "^6.0.0-beta.0"
+    "@praxisui/rich-content": "^8.0.0-beta.0",
+    "@praxisui/settings-panel": "^8.0.0-beta.0",
+    "@praxisui/visual-builder": "^8.0.0-beta.0",
+    "@praxisui/core": "^8.0.0-beta.0",
+    "@praxisui/cron-builder": "^8.0.0-beta.0"
   },
   "dependencies": {
     "tslib": "^2.3.0",