@praxisui/dynamic-form 8.0.0-beta.1 → 8.0.0-beta.12

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, 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 { AsyncConfigStorage, FormLayout, FieldMetadata, FormLayoutRule, FormRuleTargetType as FormRuleTargetType$1, PraxisJsonLogicService, FormSection, FormRow, FormColumn, FormConfig, FormLayoutItem, 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, GlobalActionCatalogEntry, FieldDefinition, ComponentDocMeta, Breakpoint, IconPickerService, GlobalActionRef, SurfaceOpenPayload, AiCapabilityCategory, AiValueKind, AiCapabilityCatalog, ComponentAuthoringManifest } from '@praxisui/core';
 import * as rxjs from 'rxjs';
 import { Observable, BehaviorSubject } from 'rxjs';
 import { SettingsPanelService, SettingsValueProvider } from '@praxisui/settings-panel';
@@ -96,6 +96,7 @@ interface Operation {
         sectionId?: string;
         rowId?: string;
         columnId?: string;
+        itemId?: string;
         fieldName?: string;
         sectionIndex?: number;
         rowIndex?: number;
@@ -106,6 +107,7 @@ interface Operation {
         sectionId?: string;
         rowId?: string;
         columnId?: string;
+        itemId?: string;
         fieldName?: string;
         sectionIndex?: number;
         rowIndex?: number;
@@ -178,6 +180,14 @@ declare class DynamicFormLayoutService {
     private capitalizeFirstLetter;
     private assertIndex;
     private mutate;
+    private getFieldName;
+    private findFieldLayoutItemIndex;
+    private getLayoutInsertIndexForFieldIndex;
+    private applyLayoutItemsToColumn;
+    private insertFieldLayoutItem;
+    private removeFieldLayoutItem;
+    private hasLayoutItems;
+    private moveFieldLayoutItem;
     moveSection(config: FormConfig, fromIndex: number, toIndex: number): LayoutResult;
     insertSection(config: FormConfig, section: any, atIndex?: number): LayoutResult;
     removeSection(config: FormConfig, index: number, _policy?: RemovePolicy): LayoutResult;
@@ -235,6 +245,37 @@ declare class DynamicFormLayoutService {
         rowId: string;
         columnId: string;
     }, field: any, atIndex?: number): LayoutResult;
+    insertLayoutItemById(config: FormConfig, target: {
+        sectionId: string;
+        rowId: string;
+        columnId: string;
+    }, item: FormLayoutItem, atIndex?: number): LayoutResult;
+    moveLayoutItemById(config: FormConfig, from: {
+        sectionId: string;
+        rowId: string;
+        columnId: string;
+        itemId: string;
+    }, to: {
+        sectionId: string;
+        rowId: string;
+        columnId: string;
+        toIndex: number;
+    }, options?: {
+        policy?: RemovePolicy;
+        correlationId?: string;
+        origin?: string;
+    }): LayoutResult;
+    updateLayoutItemById(config: FormConfig, target: {
+        sectionId: string;
+        rowId: string;
+        columnId: string;
+        itemId: string;
+    }, item: FormLayoutItem): LayoutResult;
+    removeLayoutItemById(config: FormConfig, sectionId: string, rowId: string, columnId: string, itemId: string, options?: {
+        policy?: RemovePolicy;
+        correlationId?: string;
+        origin?: string;
+    }): LayoutResult;
     removeFieldById(config: FormConfig, sectionId: string, rowId: string, columnId: string, fieldName: string, options?: {
         policy?: RemovePolicy;
         correlationId?: string;
@@ -349,6 +390,7 @@ declare class PraxisFormActionsComponent implements OnChanges, OnDestroy {
     getInvalidSubmitHint(): string;
     private applyOverrides;
     private registerActionShortcuts;
+    private resolveButtonActionId;
     private isSecondaryButton;
     static ɵfac: i0.ɵɵFactoryDeclaration<PraxisFormActionsComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<PraxisFormActionsComponent, "praxis-form-actions", never, { "actions": { "alias": "actions"; "required": false; }; "editorialVisualContext": { "alias": "editorialVisualContext"; "required": false; }; "isSubmitting": { "alias": "isSubmitting"; "required": false; }; "formIsValid": { "alias": "formIsValid"; "required": false; }; "submitError": { "alias": "submitError"; "required": false; }; "invalidRequiredFieldLabels": { "alias": "invalidRequiredFieldLabels"; "required": false; }; "formId": { "alias": "formId"; "required": false; }; "actionOverrides": { "alias": "actionOverrides"; "required": false; }; }, { "action": "action"; }, never, never, true, never>;
@@ -506,6 +548,19 @@ type ResolvedSectionHeaderVisual = {
     text?: string;
     ariaLabel: string;
 };
+interface FormColumnFieldsRenderItem {
+    kind: 'fields';
+    id: string;
+    fields: FieldMetadata[];
+}
+interface FormColumnRichContentRenderItem {
+    kind: 'richContent';
+    id: string;
+    document: RichContentDocument;
+    layout: 'block' | 'inline';
+    rootClassName?: string | null;
+}
+type FormColumnRenderItem = FormColumnFieldsRenderItem | FormColumnRichContentRenderItem;
 declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     private crud;
     private http;
@@ -808,6 +863,7 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     private hasInteractiveFormState;
     private captureFormRuntimeState;
     private getDirtyFieldNames;
+    private collectDirtyFieldNames;
     private buildCurrentFormRuntimeContext;
     private buildRestoreTargetContext;
     private isCompatibleRuntimeStateContext;
@@ -888,11 +944,17 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     toggleSectionCollapse(event: Event, section: FormSection): void;
     sectionPanelId(section: FormSection, index: number): string;
     getSectionCollapsedSummary(section: FormSection): string;
+    getColumnItems(column: FormColumn): FormLayoutItem[];
+    getColumnRenderItems(column: FormColumn): FormColumnRenderItem[];
     getColumnFields(column: {
-        fields: string[];
+        fields?: string[];
+        items?: FormLayoutItem[];
         id?: string;
     }): FieldMetadata[];
+    getRichContentLayoutItemDocument(item: FormLayoutItem): RichContentDocument | null;
+    getRichContentLayoutItemLayout(item: FormLayoutItem): 'block' | 'inline';
     private getColumnFieldsSignature;
+    private getColumnItemsSignature;
     private getColumnRuleProps;
     private buildFieldRuleMetadataOverrides;
     private normalizeRuleFieldOptions;
@@ -911,6 +973,7 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     private _showConfirmationDialog;
     onFormAction(event: PraxisFormActionEvent): void;
     private _executeAction;
+    private getFormActionEventId;
     onSubmit(): Promise<void>;
     private navigateAfterSave;
     private shouldConfirmCancelOnDirty;
@@ -978,6 +1041,7 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     private getControlTypeName;
     private applyNullDeletionPatch;
     private stripNullMarkersFromPatch;
+    private mergeMetadataObjectPatch;
     private deleteMetadataPath;
     private getMetadataPath;
     /**
@@ -1200,13 +1264,16 @@ declare class PraxisDynamicFormConfigEditor implements SettingsValueProvider, On
     };
     private destroy$;
     private hasProcessedInitialRuleState;
+    private jsonEditorIsValid;
+    private globalActionValidationIssues;
+    private readonly globalActionCatalog;
     isDirty$: BehaviorSubject<boolean>;
     isValid$: BehaviorSubject<boolean>;
     isBusy$: BehaviorSubject<boolean>;
     private lastRulesSignature;
     private readonly DEBUG;
     private debugLog;
-    constructor(storage: AsyncConfigStorage, configService: FormConfigService, settingsPanel: SettingsPanelService, cdr: ChangeDetectorRef, injectedData?: any);
+    constructor(storage: AsyncConfigStorage, configService: FormConfigService, settingsPanel: SettingsPanelService, cdr: ChangeDetectorRef, globalActionCatalogSource?: ReadonlyArray<GlobalActionCatalogEntry[]>, injectedData?: any);
     ngOnInit(): void;
     reset(): void;
     updateDirtyState(reason?: string): void;
@@ -1216,6 +1283,11 @@ declare class PraxisDynamicFormConfigEditor implements SettingsValueProvider, On
     onJsonValidationChange(result: JsonValidationResult): void;
     onJsonEditorEvent(_event: JsonEditorEvent): void;
     onConfigChange(newConfig: FormConfig): void;
+    private updateValidityState;
+    private collectGlobalActionValidationIssues;
+    private collectGlobalActionValidationTargets;
+    private findGlobalActionCatalogEntry;
+    private buildGlobalActionCatalog;
     onRulesChanged(state: RuleBuilderState): void;
     get jsonDocument(): DynamicFormAuthoringDocument;
     onBackConfigChange(): void;
@@ -1248,7 +1320,7 @@ declare class PraxisDynamicFormConfigEditor implements SettingsValueProvider, On
     private toPresentationSnapshot;
     private toSchemaPrefsSnapshot;
     private toBackConfigSnapshot;
-    static ɵfac: i0.ɵɵFactoryDeclaration<PraxisDynamicFormConfigEditor, [null, null, null, null, { optional: true; }]>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<PraxisDynamicFormConfigEditor, [null, null, null, null, { optional: true; }, { optional: true; }]>;
     static ɵcmp: i0.ɵɵComponentDeclaration<PraxisDynamicFormConfigEditor, "praxis-dynamic-form-config-editor", never, {}, {}, never, never, true, never>;
 }
 interface FormConfigLike {
@@ -1323,11 +1395,42 @@ declare class LayoutPrefsService {
     static ɵprov: i0.ɵɵInjectableDeclaration<LayoutPrefsService>;
 }
 
+type VisualBlockPresetId = 'text' | 'notice' | 'divider' | 'infoCard';
+interface VisualBlockPreset {
+    id: VisualBlockPresetId;
+    labelKey: string;
+    icon: string;
+}
+
 interface FieldDropEvent {
     event: CdkDragDrop<any>;
     sectionIndex: number;
     rowIndex: number;
 }
+interface VisualBlockEvent {
+    sectionIndex: number;
+    rowIndex: number;
+    columnIndex: number;
+    itemId: string;
+}
+interface AddVisualBlockEvent {
+    sectionIndex: number;
+    rowIndex: number;
+    columnIndex: number;
+    presetId: VisualBlockPresetId;
+}
+interface AddApiFieldEvent {
+    sectionIndex: number;
+    rowIndex: number;
+    columnIndex: number;
+    fieldName: string;
+}
+interface MoveVisualBlockEvent extends VisualBlockEvent {
+    direction: -1 | 1;
+}
+interface MoveVisualBlockToColumnEvent extends VisualBlockEvent {
+    targetColumnIndex: number;
+}
 /**
  * Editor component for configuring sections, rows and fields of a dynamic form.
  * Provides a collapsible palette of available fields.
@@ -1337,13 +1440,18 @@ declare class LayoutEditorComponent implements OnInit {
     configChange: EventEmitter<FormConfig>;
     paletteCollapsed: boolean;
     protected readonly prefs: LayoutPrefsService;
+    private readonly layoutService;
+    private readonly settingsPanel;
+    private readonly i18n;
+    private visualBlockIdSequence;
     protected readonly colorTokens: typeof LayoutColorToken;
     selected: {
-        type: 'section' | 'row' | 'column' | 'field';
+        type: 'section' | 'row' | 'column' | 'field' | 'visualBlock';
         sectionIndex?: number;
         rowIndex?: number;
         columnIndex?: number;
         fieldName?: string;
+        itemId?: string;
     } | null;
     gapGlobal: number;
     setGapGlobal(val: number | string): void;
@@ -1368,6 +1476,7 @@ declare class LayoutEditorComponent implements OnInit {
      * Fields that are not yet placed in any section/column of the layout.
      */
     get availableFields(): FieldMetadata[];
+    t(key: string, params?: Record<string, string | number | boolean | null | undefined>): string;
     get columnDropListIds(): string[];
     getColumnId(sectionIndex: number, rowIndex: number, columnIndex: number): string;
     private parseColumnId;
@@ -1378,10 +1487,24 @@ declare class LayoutEditorComponent implements OnInit {
     selectRow(sectionIndex: number, rowIndex: number): void;
     selectColumn(sectionIndex: number, rowIndex: number, columnIndex: number): void;
     dropField({ event }: FieldDropEvent): void;
+    private getColumnTargetByIndex;
+    private getLayoutItemTargetByIndex;
     dropSection(event: CdkDragDrop<FormSection[]>): void;
     addSection(): void;
     removeSection(index: number): void;
     onSectionUpdated(index: number, updatedSection: FormSection): void;
+    addVisualBlockToColumn(event: AddVisualBlockEvent): void;
+    private createVisualBlockItemId;
+    addApiFieldToColumn(event: AddApiFieldEvent): void;
+    openVisualBlockEditor(event: {
+        sectionIndex: number;
+        rowIndex: number;
+        columnIndex: number;
+        itemId: string;
+    }): void;
+    moveVisualBlock(event: MoveVisualBlockEvent): void;
+    moveVisualBlockToColumn(event: MoveVisualBlockToColumnEvent): void;
+    removeVisualBlock(event: VisualBlockEvent): void;
     private emitNewConfig;
     onApplyStyleToAll(patch: Partial<FormSection>): void;
     trackBySection(index: number, s: FormSection & {
@@ -1394,15 +1517,17 @@ declare class LayoutEditorComponent implements OnInit {
 declare class RowConfiguratorComponent implements OnChanges {
     row: FormRow;
     fieldMetadata: FieldMetadata[];
+    availableFields: FieldMetadata[];
     sectionIndex: number;
     rowIndex: number;
     isLastRow: boolean;
     selected: {
-        type: 'section' | 'row' | 'column' | 'field';
+        type: 'section' | 'row' | 'column' | 'field' | 'visualBlock';
         sectionIndex?: number;
         rowIndex?: number;
         columnIndex?: number;
         fieldName?: string;
+        itemId?: string;
     } | null;
     availableFieldsListId: string | null;
     connectedDropListIds: string[];
@@ -1412,8 +1537,42 @@ declare class RowConfiguratorComponent implements OnChanges {
     remove: EventEmitter<void>;
     applyRowGapAll: EventEmitter<number>;
     fieldDrop: EventEmitter<CdkDragDrop<any, any, any>>;
+    addVisualBlock: EventEmitter<{
+        rowIndex: number;
+        columnIndex: number;
+        presetId: VisualBlockPresetId;
+    }>;
+    addApiField: EventEmitter<{
+        rowIndex: number;
+        columnIndex: number;
+        fieldName: string;
+    }>;
+    editVisualBlock: EventEmitter<{
+        rowIndex: number;
+        columnIndex: number;
+        itemId: string;
+    }>;
+    moveVisualBlock: EventEmitter<{
+        rowIndex: number;
+        columnIndex: number;
+        itemId: string;
+        direction: -1 | 1;
+    }>;
+    moveVisualBlockToColumn: EventEmitter<{
+        rowIndex: number;
+        columnIndex: number;
+        targetColumnIndex: number;
+        itemId: string;
+    }>;
+    removeVisualBlock: EventEmitter<{
+        rowIndex: number;
+        columnIndex: number;
+        itemId: string;
+    }>;
     select: EventEmitter<any>;
     activeDropIndex: number | null;
+    protected readonly visualBlockPresets: readonly VisualBlockPreset[];
+    private readonly i18n;
     private hoverTimer;
     protected readonly breakpoints: Breakpoint[];
     previewBreakpoint: Breakpoint;
@@ -1426,6 +1585,19 @@ declare class RowConfiguratorComponent implements OnChanges {
     ngOnChanges(changes: SimpleChanges): void;
     private rebuildConnectedColumnsCache;
     getFieldByName(fieldName: string): FieldMetadata;
+    getColumnLayoutItems(column: FormColumn): FormLayoutItem[];
+    hasColumnContent(column: FormColumn): boolean;
+    getVisualBlockLabel(item: FormLayoutItem): string;
+    private findRichContentLabel;
+    private findRichNodeLabel;
+    t(key: string, params?: Record<string, string | number | boolean | null | undefined>): string;
+    getFieldLabel(field: FieldMetadata): string;
+    selectVisualBlock(columnIndex: number, item: FormLayoutItem, event: MouseEvent): void;
+    openVisualBlockEditor(columnIndex: number, item: FormLayoutItem, event: MouseEvent): void;
+    moveVisualBlockItem(columnIndex: number, item: FormLayoutItem, direction: -1 | 1, event: MouseEvent): void;
+    canMoveVisualBlockToColumn(columnIndex: number, direction: -1 | 1): boolean;
+    moveVisualBlockToAdjacentColumn(columnIndex: number, item: FormLayoutItem, direction: -1 | 1, event: MouseEvent): void;
+    removeVisualBlockItem(columnIndex: number, item: FormLayoutItem, event: MouseEvent): void;
     drop(event: CdkDragDrop<string[]>): void;
     selectRow(): void;
     openColumnConfig(index: number): void;
@@ -1444,6 +1616,8 @@ declare class RowConfiguratorComponent implements OnChanges {
     removeRow(): void;
     moveColumn(index: number, direction: number): void;
     clearColumn(index: number): void;
+    addVisualBlockToColumn(index: number, presetId: VisualBlockPresetId): void;
+    addApiFieldToColumn(index: number, fieldName: string): void;
     addFieldToColumn(index: number): void;
     getColumnId(index: number): string;
     private generateId;
@@ -1467,7 +1641,7 @@ declare class RowConfiguratorComponent implements OnChanges {
     adjustOffset(columnIndex: number, delta: number): void;
     getSuggestedSpan(columnIndex: number): number | null;
     static ɵfac: i0.ɵɵFactoryDeclaration<RowConfiguratorComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<RowConfiguratorComponent, "praxis-row-configurator", never, { "row": { "alias": "row"; "required": false; }; "fieldMetadata": { "alias": "fieldMetadata"; "required": false; }; "sectionIndex": { "alias": "sectionIndex"; "required": false; }; "rowIndex": { "alias": "rowIndex"; "required": false; }; "isLastRow": { "alias": "isLastRow"; "required": false; }; "selected": { "alias": "selected"; "required": false; }; "availableFieldsListId": { "alias": "availableFieldsListId"; "required": false; }; "connectedDropListIds": { "alias": "connectedDropListIds"; "required": false; }; "gapGlobal": { "alias": "gapGlobal"; "required": false; }; }, { "rowChange": "rowChange"; "remove": "remove"; "applyRowGapAll": "applyRowGapAll"; "fieldDrop": "fieldDrop"; "select": "select"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RowConfiguratorComponent, "praxis-row-configurator", never, { "row": { "alias": "row"; "required": false; }; "fieldMetadata": { "alias": "fieldMetadata"; "required": false; }; "availableFields": { "alias": "availableFields"; "required": false; }; "sectionIndex": { "alias": "sectionIndex"; "required": false; }; "rowIndex": { "alias": "rowIndex"; "required": false; }; "isLastRow": { "alias": "isLastRow"; "required": false; }; "selected": { "alias": "selected"; "required": false; }; "availableFieldsListId": { "alias": "availableFieldsListId"; "required": false; }; "connectedDropListIds": { "alias": "connectedDropListIds"; "required": false; }; "gapGlobal": { "alias": "gapGlobal"; "required": false; }; }, { "rowChange": "rowChange"; "remove": "remove"; "applyRowGapAll": "applyRowGapAll"; "fieldDrop": "fieldDrop"; "addVisualBlock": "addVisualBlock"; "addApiField": "addApiField"; "editVisualBlock": "editVisualBlock"; "moveVisualBlock": "moveVisualBlock"; "moveVisualBlockToColumn": "moveVisualBlockToColumn"; "removeVisualBlock": "removeVisualBlock"; "select": "select"; }, never, never, true, never>;
 }
 
 declare class FieldConfiguratorComponent {
@@ -1581,6 +1755,7 @@ type ActionCatalogOption = {
     id: string;
     label: string;
     description?: string;
+    payloadSchema?: GlobalActionCatalogEntry['payloadSchema'];
     param?: {
         required?: boolean;
         label?: string;
@@ -1634,7 +1809,6 @@ declare class SectionEditorComponent implements OnInit, AfterViewInit, OnDestroy
     isBusy$: BehaviorSubject<boolean>;
     private readonly globalActionCatalogSource;
     private readonly i18n;
-    readonly legacyActionSpecs: _praxisui_core.GlobalActionSpec[];
     readonly globalActionCatalog: ActionCatalogOption[];
     readonly customActionValue = "__custom__";
     private destroy$;
@@ -1654,12 +1828,12 @@ declare class SectionEditorComponent implements OnInit, AfterViewInit, OnDestroy
         label?: string;
     }): string;
     getHeaderActionSpecById(id: string): ActionCatalogOption | undefined;
-    getHeaderActionSelectValue(value?: string): string;
-    getHeaderActionParam(value?: string): string;
-    getHeaderActionCustomValue(value?: string): string;
-    getHeaderGlobalActionSchema(value?: string): _praxisui_core.GlobalActionUiSchema | undefined;
-    getHeaderSurfaceOpenActionPayload(value?: string): SurfaceOpenPayload;
-    isHeaderActionParamMissing(value?: string): boolean;
+    getHeaderActionSelectValue(value?: string, globalAction?: GlobalActionRef): string;
+    getHeaderActionParam(value?: string, globalAction?: GlobalActionRef): string;
+    getHeaderActionCustomValue(value?: string, globalAction?: GlobalActionRef): string;
+    getHeaderGlobalActionSchema(value?: string, globalAction?: GlobalActionRef): _praxisui_core.GlobalActionUiSchema | undefined;
+    getHeaderSurfaceOpenActionPayload(value?: string, globalAction?: GlobalActionRef): SurfaceOpenPayload;
+    isHeaderActionParamMissing(value?: string, globalAction?: GlobalActionRef): boolean;
     onHeaderActionSelectChange(index: number, value: string): void;
     onHeaderActionParamChange(index: number, value: string): void;
     onHeaderActionCustomChange(index: number, value: string): void;
@@ -1693,6 +1867,7 @@ declare class SectionEditorComponent implements OnInit, AfterViewInit, OnDestroy
     private normalizeHeaderActions;
     private mapCatalogEntryToActionSpec;
     private getActionCatalogDescription;
+    private normalizeHeaderGlobalAction;
     private headerActionStyleValidator;
     private stringifyHeaderActionStyle;
     private parseHeaderActionStyle;
@@ -1973,5 +2148,14 @@ 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 };
+/**
+ * Manifesto de authoring canônico para o componente praxis-dynamic-form.
+ * Este arquivo define as operações permitidas pela IA para editar formulários.
+ *
+ * @version 1.5.0
+ * @status COMPLIANT - Alinhado com contrato v2, gate de aceitação e semântica local/schema-backed.
+ */
+declare const PRAXIS_DYNAMIC_FORM_AUTHORING_MANIFEST: ComponentAuthoringManifest;
+
+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_AUTHORING_MANIFEST, 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, 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,16 +1,16 @@
 {
   "name": "@praxisui/dynamic-form",
-  "version": "8.0.0-beta.1",
+  "version": "8.0.0-beta.12",
   "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/rich-content": "^8.0.0-beta.1",
-    "@praxisui/settings-panel": "^8.0.0-beta.1",
-    "@praxisui/visual-builder": "^8.0.0-beta.1",
-    "@praxisui/core": "^8.0.0-beta.1",
-    "@praxisui/cron-builder": "^8.0.0-beta.1"
+    "@praxisui/rich-content": "^8.0.0-beta.12",
+    "@praxisui/settings-panel": "^8.0.0-beta.12",
+    "@praxisui/visual-builder": "^8.0.0-beta.12",
+    "@praxisui/core": "^8.0.0-beta.12",
+    "@praxisui/cron-builder": "^8.0.0-beta.12"
   },
   "dependencies": {
     "tslib": "^2.3.0",