@praxisui/dynamic-form 1.0.0-beta.66 → 1.0.0-beta.68

package/index.d.ts

@@ -5,7 +5,7 @@ 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 { AsyncConfigStorage, FormLayout, FieldMetadata, FormLayoutRule, FormRuleTargetType as FormRuleTargetType$1, FormSection, FormRow, FormColumn, FormConfig, FormActionButton, BackConfig, FormHooksLayout, EndpointConfig, FormSubmitEvent, FormReadyEvent, FormValueChangeEvent, SyncResult, FormInitializationError, LoadingState, FormCustomActionEvent, FormActionConfirmationEvent, WidgetDefinition, GenericCrudService, ConnectionStorage, DynamicFormService, ErrorMessageService, SchemaNormalizerService, ComponentMetadataRegistry, GlobalConfigService, ComponentKeyService, LoadingOrchestrator, PraxisLoadingRenderer, FormHooksRegistry, FormHookPreset, LoggerService, FormConfigState, FieldDefinition, Breakpoint, ComponentDocMeta, IconPickerService, AiCapabilityCategory, AiValueKind, AiCapability, AiCapabilityCatalog } 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, WidgetDefinition, GenericCrudService, ConnectionStorage, DynamicFormService, ErrorMessageService, SchemaNormalizerService, ComponentMetadataRegistry, GlobalConfigService, ComponentKeyService, LoadingOrchestrator, PraxisLoadingRenderer, FormHooksRegistry, FormHookPreset, LoggerService, FormConfigState, FieldDefinition, Breakpoint, ComponentDocMeta, IconPickerService, PraxisI18nService, AiCapabilityCategory, AiValueKind, AiCapability, AiCapabilityCatalog } from '@praxisui/core';
 import * as rxjs from 'rxjs';
 import { Observable, BehaviorSubject } from 'rxjs';
 import { SettingsPanelService, SettingsValueProvider } from '@praxisui/settings-panel';
@@ -61,6 +61,8 @@ declare class FormRulesService {
      * @returns A RuleEvaluationResult object containing the visibility and required states for the fields.
      */
     applyRules(formGroup: FormGroup, formRules: FormLayoutRule[]): RuleApplicationResult;
+    private setPath;
+    private deletePath;
     static ɵfac: i0.ɵɵFactoryDeclaration<FormRulesService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<FormRulesService>;
 }
@@ -443,6 +445,25 @@ interface DynamicFieldRenderErrorEvent {
     error: unknown;
     fatal: boolean;
 }
+type ResolvedSectionHeaderVisual = {
+    kind: 'none';
+} | {
+    kind: 'icon';
+    icon: string;
+} | {
+    kind: 'image';
+    src: string;
+    alt: string;
+} | {
+    kind: 'initials';
+    text: string;
+    ariaLabel: string;
+} | {
+    kind: 'placeholder';
+    icon?: string;
+    text?: string;
+    ariaLabel: string;
+};
 declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     private crud;
     private fb;
@@ -586,11 +607,14 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     private columnRuleProps;
     private pendingEntityId;
     private loadedEntityId;
+    private hydratedEntityId;
     private loadedEntityData;
     private schemaCache;
     private lastSchemaMeta?;
     private schemaRootHooks?;
     private destroy$;
+    private readonly sectionHeaderBlobUrlCache;
+    private readonly sectionHeaderObjectUrls;
     private lastCorrelationId?;
     private currentDnD?;
     private columnFieldsCache;
@@ -689,6 +713,11 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     private syncWithServer;
     private loadEntity;
     private buildFormFromConfig;
+    private captureFormRuntimeState;
+    private buildCurrentFormRuntimeContext;
+    private buildRestoreTargetContext;
+    private isCompatibleRuntimeStateContext;
+    private restoreFormRuntimeState;
     /**
      * Backward-compatible required validation for DATE_RANGE controls.
      * Some core builds do not enforce required start/end for dateRange fields.
@@ -729,6 +758,17 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     getRowClasses(row: FormRow): string[];
     getRowStyles(row: FormRow): Record<string, any> | null;
     getSectionIcon(section: FormSection): string | undefined;
+    getSectionHeaderVisual(section: FormSection): ResolvedSectionHeaderVisual;
+    private getSectionHeaderConfig;
+    private getSectionHeaderFieldValue;
+    private getSectionHeaderInitialsSourceValue;
+    private getSectionHeaderFallbackIcon;
+    private getSectionHeaderEmptyVisual;
+    private getSectionHeaderAltText;
+    private deriveSectionHeaderInitials;
+    private resolveSectionHeaderImageSrc;
+    private bytesToDataUrl;
+    private firstNonEmptyString;
     getSectionClasses(section: FormSection): string[];
     getSectionStyles(section: FormSection): Record<string, any> | null;
     private sanitizeSectionStylesForEditorialContext;
@@ -1402,7 +1442,20 @@ declare class CanvasToolbarComponent {
     static ɵcmp: i0.ɵɵComponentDeclaration<CanvasToolbarComponent, "praxis-canvas-toolbar", never, { "selectedElement": { "alias": "selectedElement"; "required": false; }; }, { "editMetadata": "editMetadata"; "delete": "delete"; "moveUp": "moveUp"; "moveDown": "moveDown"; "selectPath": "selectPath"; "requestClose": "requestClose"; "toggleReadonly": "toggleReadonly"; "toggleRequired": "toggleRequired"; "toggleHidden": "toggleHidden"; "toggleDisabled": "toggleDisabled"; }, never, never, true, never>;
 }
 
+type FormSectionHeaderMode = 'icon' | 'avatar-image' | 'avatar-initials' | 'auto';
+type FormSectionHeaderEmptyState = 'fallback-icon' | 'placeholder-avatar' | 'none';
+interface FormSectionHeaderConfig {
+    mode?: FormSectionHeaderMode;
+    sourceField?: string;
+    initialsSourceField?: string;
+    altField?: string;
+    fallbackIcon?: string;
+    emptyState?: FormSectionHeaderEmptyState;
+    initialsMaxLength?: number;
+}
+
 interface EditableFormSection extends FormSection {
+    sectionHeader?: FormSectionHeaderConfig;
     appearance?: 'card' | 'plain' | 'step';
     stepLabel?: string;
     collapsible?: boolean;
@@ -1431,7 +1484,9 @@ declare class SectionEditorComponent implements OnInit, AfterViewInit, OnDestroy
     private fb;
     private data;
     private iconPicker;
+    private i18n;
     focusTarget?: 'title' | 'description';
+    fieldMetadata: FieldMetadata[];
     section: EditableFormSection;
     form: FormGroup;
     breakpoints: Breakpoint[];
@@ -1443,19 +1498,32 @@ declare class SectionEditorComponent implements OnInit, AfterViewInit, OnDestroy
     descriptionInput?: ElementRef<HTMLTextAreaElement>;
     constructor(fb: FormBuilder, data: {
         section: EditableFormSection;
-    }, iconPicker: IconPickerService);
+        fieldMetadata?: FieldMetadata[];
+    }, iconPicker: IconPickerService, i18n: PraxisI18nService);
     ngOnInit(): void;
     ngAfterViewInit(): void;
     ngOnDestroy(): void;
     getSettingsValue(): any;
     pickIcon(): Promise<void>;
     clearIcon(): void;
+    pickFallbackIcon(): Promise<void>;
+    clearFallbackIcon(): void;
     applyPreset(key: 'default' | 'simple' | 'collapsible' | 'denseGrid'): void;
     setCustomColors(value: string): void;
     onTitleStyleChange(style: string): void;
     onDescriptionStyleChange(style: string): void;
+    get fieldOptions(): Array<{
+        value: string;
+        label: string;
+    }>;
+    tx(key: string, fallback: string): string;
+    private applyNormalizedFormValue;
+    private normalizeSectionFormValue;
+    private normalizeSectionHeader;
+    private normalizeOptionalString;
+    private normalizeOptionalNumber;
     static ɵfac: i0.ɵɵFactoryDeclaration<SectionEditorComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<SectionEditorComponent, "praxis-section-editor", never, { "focusTarget": { "alias": "focusTarget"; "required": false; }; }, {}, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SectionEditorComponent, "praxis-section-editor", never, { "focusTarget": { "alias": "focusTarget"; "required": false; }; "fieldMetadata": { "alias": "fieldMetadata"; "required": false; }; }, {}, never, never, true, never>;
 }
 
 interface EditableFormRow extends FormRow {

package/package.json

@@ -1,17 +1,17 @@
 {
   "name": "@praxisui/dynamic-form",
-  "version": "1.0.0-beta.66",
+  "version": "1.0.0-beta.68",
   "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": "^1.0.0-beta.66",
-    "@praxisui/visual-builder": "^1.0.0-beta.66",
-    "@praxisui/specification-core": "^1.0.0-beta.66",
-    "@praxisui/specification": "^1.0.0-beta.66",
-    "@praxisui/core": "^1.0.0-beta.66",
-    "@praxisui/cron-builder": "^1.0.0-beta.66"
+    "@praxisui/settings-panel": "^1.0.0-beta.68",
+    "@praxisui/visual-builder": "^1.0.0-beta.68",
+    "@praxisui/specification-core": "^1.0.0-beta.68",
+    "@praxisui/specification": "^1.0.0-beta.68",
+    "@praxisui/core": "^1.0.0-beta.68",
+    "@praxisui/cron-builder": "^1.0.0-beta.68"
   },
   "dependencies": {
     "tslib": "^2.3.0",