@praxisui/dynamic-form 1.0.0-beta.60 → 1.0.0-beta.62

package/index.d.ts

@@ -343,6 +343,94 @@ declare class FormAiAdapter extends BaseAiAdapter<FormConfig> {
     private isFilled;
 }
 
+interface EditorDocument<TConfig, TBindings = unknown> {
+    kind: string;
+    version: number;
+    config: TConfig;
+    bindings?: TBindings;
+}
+interface EditorDiagnostic {
+    level: 'error' | 'warning' | 'info';
+    code: string;
+    message: string;
+    path?: string;
+}
+type DynamicFormMode = 'create' | 'edit' | 'view';
+interface DynamicFormBindings {
+    mode?: DynamicFormMode;
+}
+interface DynamicFormPresentationSnapshot {
+    labelPosition?: 'above' | 'left';
+    labelFontSize?: number | null;
+    valueFontSize?: number | null;
+    compact?: boolean;
+    density?: 'comfortable' | 'cozy' | 'compact';
+    labelWidth?: number | null;
+    labelAlign?: 'start' | 'center' | 'end';
+    valueAlign?: 'start' | 'center' | 'end';
+}
+interface DynamicFormSchemaPrefsSnapshot {
+    notifyIfOutdated?: 'inline' | 'snackbar' | 'both' | 'none';
+    snoozeMs?: number;
+    autoOpenSettingsOnOutdated?: boolean;
+}
+interface DynamicFormContextSnapshot {
+    backConfig?: BackConfig;
+    presentation?: DynamicFormPresentationSnapshot;
+    schemaPrefs?: DynamicFormSchemaPrefsSnapshot;
+}
+interface DynamicFormAuthoringDocument extends EditorDocument<FormConfig, DynamicFormBindings> {
+    kind: 'praxis.dynamic-form.editor';
+    version: 1;
+    contextSnapshot?: DynamicFormContextSnapshot;
+}
+interface DynamicFormValidationContext {
+    server?: {
+        schemaHash?: string;
+    };
+}
+interface DynamicFormProjectionContext {
+    mode?: DynamicFormMode;
+}
+interface DynamicFormRuntimeContext {
+    currentBindings?: DynamicFormBindings;
+    currentContextSnapshot?: DynamicFormContextSnapshot;
+    server?: {
+        schemaHash?: string;
+    };
+}
+interface DynamicFormApplyPlan {
+    canonicalConfig: FormConfig;
+    bindingsPatch?: DynamicFormBindings;
+    contextSnapshot?: DynamicFormContextSnapshot;
+    persistence?: {
+        saveConfig?: boolean;
+        saveBindings?: boolean;
+        saveContextSnapshot?: boolean;
+    };
+    runtime?: {
+        rebindMode?: boolean;
+        clearMode?: boolean;
+        rebuildForm?: boolean;
+        refreshPresentation?: boolean;
+        clearPresentation?: boolean;
+        refreshSchemaState?: boolean;
+        clearSchemaState?: boolean;
+        refreshBackNavigation?: boolean;
+        clearBackNavigation?: boolean;
+    };
+    metadata?: {
+        attachSchemaSnapshot?: boolean;
+    };
+    diff?: {
+        modeChanged?: boolean;
+        presentationChanged?: boolean;
+        schemaPrefsChanged?: boolean;
+        backConfigChanged?: boolean;
+    };
+    diagnostics: EditorDiagnostic[];
+}
+
 interface DynamicFieldRenderErrorEvent {
     phase: 'executeRendering' | 'detectChanges';
     fieldName: string;
@@ -380,7 +468,7 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     resourcePath?: string;
     resourceId?: string | number;
     /**
-     * Shared editorial context for widgets hosted before/after the form.
+     * Shared editorial context for widgets 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.
      */
@@ -465,9 +553,9 @@ 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/after the form sections. */
+    /** Re-emits events from editorial widgets hosted before, before actions, or after the form. */
     widgetEvent: EventEmitter<{
-        placement: "before" | "after";
+        placement: "before" | "beforeActions" | "after";
         sourceId: string;
         output?: string;
         payload?: any;
@@ -508,6 +596,9 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     private editorialWidgetContextDeps;
     get formBlocksBefore(): WidgetDefinition[];
     get formBlocksAfter(): WidgetDefinition[];
+    get formBlocksBeforeActions(): WidgetDefinition[];
+    get beforeActionsPlacement(): 'insideLastSection' | 'afterSections';
+    get actionPlacement(): 'insideLastSection' | 'afterSections' | 'top';
     /**
      * Precedence for editorial widget interpolation:
      * 1. form runtime context
@@ -520,7 +611,7 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
      * In-place mutations do not invalidate the cached merged context snapshot.
      */
     getEditorialWidgetContext(): Record<string, unknown>;
-    onEditorialWidgetEvent(placement: 'before' | 'after', event: {
+    onEditorialWidgetEvent(placement: 'before' | 'beforeActions' | 'after', event: {
         sourceId: string;
         output?: string;
         payload?: any;
@@ -613,6 +704,8 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     isSectionVisible(section?: FormSection): boolean;
     getSectionTitle(section: FormSection): string | undefined;
     getSectionDescription(section: FormSection): string | undefined;
+    getSectionAppearance(section: FormSection): 'card' | 'plain' | 'step' | undefined;
+    getSectionStepLabel(section: FormSection): string | undefined;
     getSectionTitleColor(section: FormSection): string | undefined;
     getSectionDescriptionColor(section: FormSection): string | undefined;
     getSectionTitleStyle(section: FormSection): string | undefined;
@@ -779,8 +872,20 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     trackBySection(index: number, section: FormSection): string;
     trackByRow(index: number, row: FormRow): string;
     trackByColumn(index: number, column: FormColumn): string;
-    /** Apply configuration updates coming from external adapters (e.g., AI) in a controlled way. */
+    /** Apply configuration or canonical authoring updates coming from external adapters (e.g., AI). */
     applyConfigFromAdapter(nextConfig: FormConfig): void;
+    applyConfigFromAdapter(nextConfig: DynamicFormAuthoringDocument): void;
+    private buildDynamicFormEditorRuntimeContext;
+    private captureCurrentContextSnapshot;
+    private captureCurrentPresentationSnapshot;
+    private captureCurrentSchemaPrefsSnapshot;
+    private executeDynamicFormEditorApplyPlan;
+    private attachRuntimeMetadataToDynamicFormConfig;
+    private parsePresentationCssNumber;
+    private clearDynamicFormEditorPersistence;
+    private clearStoredPresentationSnapshots;
+    private resetPresentationVarsToDefaults;
+    private resetSchemaPrefsToDefaults;
     retryInitialization(): void;
     getErrorTitle(): string;
     showDetailedError(): void;
@@ -825,7 +930,9 @@ declare class FormConfigService {
 interface JsonValidationResult {
     isValid: boolean;
     error?: string;
+    document?: DynamicFormAuthoringDocument;
     config?: FormConfig;
+    diagnostics?: EditorDiagnostic[];
 }
 interface JsonEditorEvent {
     type: 'apply' | 'format' | 'validation';
@@ -835,12 +942,15 @@ declare class JsonConfigEditorComponent implements OnInit, OnDestroy {
     private cdr;
     private configService;
     config: FormConfig | null;
+    document: DynamicFormAuthoringDocument | null;
     configChange: EventEmitter<FormConfig>;
+    documentChange: EventEmitter<DynamicFormAuthoringDocument>;
     validationChange: EventEmitter<JsonValidationResult>;
     editorEvent: EventEmitter<JsonEditorEvent>;
     jsonText: string;
     isValidJson: boolean;
     jsonError: string;
+    diagnostics: EditorDiagnostic[];
     private destroy$;
     private jsonTextChanges$;
     constructor(cdr: ChangeDetectorRef, configService: FormConfigService);
@@ -850,18 +960,20 @@ declare class JsonConfigEditorComponent implements OnInit, OnDestroy {
     applyJsonChanges(): void;
     formatJson(): void;
     updateJsonFromConfig(config: FormConfig): void;
+    updateJsonFromDocument(document: DynamicFormAuthoringDocument): void;
     /**
      * Força atualização do JSON com a configuração atual
      */
     refreshJson(): void;
     getCurrentConfig(): FormConfig | null;
+    getCurrentDocument(): DynamicFormAuthoringDocument | null;
     hasChanges(): boolean;
     private validateJson;
     private updateValidationState;
     insertHooksTemplate(): void;
     enableReactiveValidation(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<JsonConfigEditorComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<JsonConfigEditorComponent, "form-json-config-editor", never, { "config": { "alias": "config"; "required": false; }; }, { "configChange": "configChange"; "validationChange": "validationChange"; "editorEvent": "editorEvent"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<JsonConfigEditorComponent, "form-json-config-editor", never, { "config": { "alias": "config"; "required": false; }; "document": { "alias": "document"; "required": false; }; }, { "configChange": "configChange"; "documentChange": "documentChange"; "validationChange": "validationChange"; "editorEvent": "editorEvent"; }, never, never, true, never>;
 }
 
 declare class PraxisDynamicFormConfigEditor implements SettingsValueProvider, OnInit, OnDestroy {
@@ -875,10 +987,14 @@ declare class PraxisDynamicFormConfigEditor implements SettingsValueProvider, On
     ruleBuilderState?: RuleBuilderState;
     currentRules: FormLayoutRule[];
     private initialConfig;
+    private initialDocument;
+    private readonly openedWithCanonicalDocument;
     backConfig?: BackConfig;
+    private includeBackConfigBlock;
     formId?: string;
     componentKeyId?: string;
     inputMode: 'create' | 'edit' | 'view';
+    private includeBindingsBlock;
     private readonly editorMode;
     isPresentationMode: boolean;
     truncatePreview: boolean;
@@ -903,6 +1019,8 @@ declare class PraxisDynamicFormConfigEditor implements SettingsValueProvider, On
         snoozeMs: number;
         autoOpenSettingsOnOutdated: boolean;
     };
+    private includePresentationBlock;
+    private includeSchemaPrefsBlock;
     serverMeta?: {
         serverHash?: string;
         lastVerifiedAt?: string;
@@ -921,11 +1039,20 @@ declare class PraxisDynamicFormConfigEditor implements SettingsValueProvider, On
     updateDirtyState(reason?: string): void;
     getSettingsValue(): any;
     onSave(): any;
-    onJsonConfigChange(newConfig: FormConfig): void;
+    onJsonConfigChange(newValue: FormConfig | DynamicFormAuthoringDocument): void;
     onJsonValidationChange(result: JsonValidationResult): void;
     onJsonEditorEvent(_event: JsonEditorEvent): void;
     onConfigChange(newConfig: FormConfig): void;
     onRulesChanged(state: RuleBuilderState): void;
+    get jsonDocument(): DynamicFormAuthoringDocument;
+    onBackConfigChange(): void;
+    isBindingsBlockPersisted(): boolean;
+    isPresentationBlockPersisted(): boolean;
+    isSchemaPrefsBlockPersisted(): boolean;
+    isBackConfigBlockPersisted(): boolean;
+    onInputModeChange(): void;
+    onPresentationPrefsChange(reason: string): void;
+    onSchemaPrefsChange(reason: string): void;
     private createRuleBuilderConfig;
     private mapMetadataToSchema;
     private mapDataTypeToFieldType;
@@ -938,6 +1065,13 @@ declare class PraxisDynamicFormConfigEditor implements SettingsValueProvider, On
     restoreHintsDefaults(): void;
     private loadPrefsFromStorage;
     private normalizeMode;
+    private buildAuthoringDocument;
+    private createBackConfigState;
+    private mergePresentationPrefs;
+    private mergeSchemaPrefs;
+    private toPresentationSnapshot;
+    private toSchemaPrefsSnapshot;
+    private toBackConfigSnapshot;
     static ɵfac: i0.ɵɵFactoryDeclaration<PraxisDynamicFormConfigEditor, [null, null, null, null, { optional: true; }]>;
     static ɵcmp: i0.ɵɵComponentDeclaration<PraxisDynamicFormConfigEditor, "praxis-dynamic-form-config-editor", never, {}, {}, never, never, true, never>;
 }
@@ -1206,6 +1340,25 @@ declare function normalizeDateArrays(data: any): any;
 declare const SETTINGS_PANEL_DYNAMIC_FORM_PROVIDER: Provider;
 declare function provideSettingsPanelDynamicForm(): Provider;
 
+declare function createDynamicFormAuthoringDocument(source: {
+    config?: unknown;
+    bindings?: unknown;
+    contextSnapshot?: unknown;
+}): DynamicFormAuthoringDocument;
+declare function parseLegacyOrDynamicFormDocument(raw: unknown): DynamicFormAuthoringDocument;
+declare function normalizeDynamicFormAuthoringDocument(doc: DynamicFormAuthoringDocument): DynamicFormAuthoringDocument;
+declare function validateDynamicFormAuthoringDocument(doc: DynamicFormAuthoringDocument, context?: DynamicFormValidationContext): EditorDiagnostic[];
+declare function validateDynamicFormAuthoringInput(raw: unknown, context?: DynamicFormValidationContext): EditorDiagnostic[];
+declare function toCanonicalDynamicFormConfig(doc: DynamicFormAuthoringDocument, _context?: DynamicFormProjectionContext): FormConfig;
+declare function buildDynamicFormApplyPlan(doc: DynamicFormAuthoringDocument, runtime?: DynamicFormRuntimeContext, options?: {
+    saveConfig?: boolean;
+    saveBindings?: boolean;
+    saveContextSnapshot?: boolean;
+    attachSchemaSnapshot?: boolean;
+    replaceContext?: boolean;
+}): DynamicFormApplyPlan;
+declare function serializeDynamicFormAuthoringDocument(doc: DynamicFormAuthoringDocument): unknown;
+
 declare class CanvasToolbarComponent {
     selectedElement: CanvasElement | null;
     editMetadata: EventEmitter<void>;
@@ -1240,6 +1393,8 @@ declare class CanvasToolbarComponent {
 }
 
 interface EditableFormSection extends FormSection {
+    appearance?: 'card' | 'plain' | 'step';
+    stepLabel?: string;
     collapsible?: boolean;
     collapsed?: boolean;
     order?: number;
@@ -1564,5 +1719,5 @@ 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, PraxisDynamicForm, PraxisDynamicFormConfigEditor, PraxisFilterForm, PraxisFormActionsComponent, RowConfiguratorComponent, RowEditorComponent, SETTINGS_PANEL_DYNAMIC_FORM_PROVIDER, SectionEditorComponent, TASK_PRESETS, applyVisibilityRules, formLayoutRulesToBuilderState, getFormAiCatalog, getFormCapabilities, getFormEnum, isRuleSatisfied, normalizeDateArrays, providePraxisDynamicFormMetadata, provideSettingsPanelDynamicForm, ruleBuilderStateToFormLayoutRules, stripLegacyFieldMetadata };
-export type { CanvasElement, CanvasElementType, CanvasPathPart, Capability$1 as Capability, CapabilityCatalog$1 as CapabilityCatalog, CapabilityCategory$1 as CapabilityCategory, DynamicFieldRenderErrorEvent, 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 { 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, 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, 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 };

package/package.json

@@ -1,17 +1,17 @@
 {
   "name": "@praxisui/dynamic-form",
-  "version": "1.0.0-beta.60",
+  "version": "1.0.0-beta.62",
   "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.60",
-    "@praxisui/visual-builder": "^1.0.0-beta.60",
-    "@praxisui/specification-core": "^1.0.0-beta.60",
-    "@praxisui/specification": "^1.0.0-beta.60",
-    "@praxisui/core": "^1.0.0-beta.60",
-    "@praxisui/cron-builder": "^1.0.0-beta.60"
+    "@praxisui/settings-panel": "^1.0.0-beta.62",
+    "@praxisui/visual-builder": "^1.0.0-beta.62",
+    "@praxisui/specification-core": "^1.0.0-beta.62",
+    "@praxisui/specification": "^1.0.0-beta.62",
+    "@praxisui/core": "^1.0.0-beta.62",
+    "@praxisui/cron-builder": "^1.0.0-beta.62"
   },
   "dependencies": {
     "tslib": "^2.3.0",
@@ -25,17 +25,18 @@
     "type": "git",
     "url": "https://github.com/codexrodrigues/praxis-ui-angular"
   },
-  "homepage": "https://github.com/codexrodrigues/praxis-ui-angular#readme",
+  "homepage": "https://praxisui.dev",
   "bugs": {
     "url": "https://github.com/codexrodrigues/praxis-ui-angular/issues"
   },
   "keywords": [
     "angular",
     "praxisui",
-    "forms",
     "dynamic-form",
     "metadata",
-    "ui"
+    "schema-driven",
+    "forms",
+    "runtime-config"
   ],
   "sideEffects": false,
   "module": "fesm2022/praxisui-dynamic-form.mjs",