@praxisui/dynamic-form 8.0.0-beta.2 → 8.0.0-beta.21

package/index.d.ts

@@ -7,12 +7,12 @@ 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, RichBlockHostCapabilities, 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, JsonLogicExpression, GlobalActionCatalogEntry, PraxisRuntimeConditionalEffectRule, PraxisRuntimeGlobalActionEffect, GlobalActionField, FieldDefinition, ComponentDocMeta, Breakpoint, DomainRuleRequestOptions, DomainRuleService, DomainRuleMaterialization, 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';
+import { BaseAiAdapter, AiResponseCompileResult, PatchResult, PraxisAssistantShellLayout, PraxisAssistantTurnViewState, PraxisAssistantShellLabels, PraxisAssistantSessionSnapshot, PraxisAssistantShellQuickReply, PraxisAssistantShellMessage } from '@praxisui/ai';
 import { KeyboardShortcutService } from '@praxisui/dynamic-fields';
-import { BaseAiAdapter, PatchResult } from '@praxisui/ai';
 import { RuleBuilderConfig, RuleBuilderState } from '@praxisui/visual-builder';
 
 declare class FormLayoutService {
@@ -44,6 +44,15 @@ declare class FormContextService {
     static ɵprov: i0.ɵɵInjectableDeclaration<FormContextService>;
 }
 
+type RuleApplicationDiagnosticCode = 'missing-targets' | 'missing-effect' | 'unsupported-target-type' | 'field-target-not-found' | 'target-not-found' | 'invalid-condition' | 'invalid-value-expression' | 'computed-value-iteration-limit' | 'unsupported-property' | 'rule-evaluation-error';
+interface RuleApplicationDiagnostic {
+    ruleId?: string;
+    ruleName?: string;
+    code: RuleApplicationDiagnosticCode;
+    targetType?: FormLayoutRule['targetType'];
+    targetId?: string;
+    details?: string[];
+}
 /**
  * Structured properties resulting from rule evaluation.
  */
@@ -53,6 +62,15 @@ interface RuleApplicationResult {
     actionProps: Record<string, Record<string, any>>;
     rowProps: Record<string, Record<string, any>>;
     columnProps: Record<string, Record<string, any>>;
+    visualBlockProps: Record<string, Record<string, any>>;
+    fieldValues: Record<string, any>;
+    formData: Record<string, any>;
+    diagnostics: RuleApplicationDiagnostic[];
+}
+type RuleApplicationTargetType = NonNullable<FormLayoutRule['targetType']>;
+type RuleApplicationTargetIndex = Partial<Record<RuleApplicationTargetType, ReadonlySet<string>>>;
+interface RuleApplicationContext {
+    targetIndex?: RuleApplicationTargetIndex;
 }
 declare class FormRulesService {
     private readonly jsonLogic;
@@ -64,8 +82,15 @@ declare class FormRulesService {
      * @param formRules The array of rules to process.
      * @returns A RuleEvaluationResult object containing the visibility and required states for the fields.
      */
-    applyRules(formGroup: FormGroup, formRules: FormLayoutRule[]): RuleApplicationResult;
+    applyRules(formGroup: FormGroup, formRules: FormLayoutRule[], context?: RuleApplicationContext): RuleApplicationResult;
+    private ruleTargetExists;
+    private normalizeRuleTargetId;
     private evaluateCondition;
+    private evaluateRuleValue;
+    private evaluateJsonLogicValue;
+    private resolveComputedRuleFormData;
+    private areRuleValuesEqual;
+    private addUnsupportedPropertyDiagnostics;
     private setPath;
     private deletePath;
     static ɵfac: i0.ɵɵFactoryDeclaration<FormRulesService, never>;
@@ -96,6 +121,7 @@ interface Operation {
         sectionId?: string;
         rowId?: string;
         columnId?: string;
+        itemId?: string;
         fieldName?: string;
         sectionIndex?: number;
         rowIndex?: number;
@@ -106,6 +132,7 @@ interface Operation {
         sectionId?: string;
         rowId?: string;
         columnId?: string;
+        itemId?: string;
         fieldName?: string;
         sectionIndex?: number;
         rowIndex?: number;
@@ -156,6 +183,23 @@ interface ValidationReport {
     valid: boolean;
     errors: string[];
 }
+type LocalFieldInsertionDiagnosticCode = 'missing-field-name' | 'missing-control-type' | 'field-name-already-exists' | 'schema-field-name-collision' | 'invalid-local-field-source';
+interface LocalFieldInsertionDiagnostic {
+    code: LocalFieldInsertionDiagnosticCode;
+    severity: 'error' | 'warning';
+    message: string;
+    fieldName?: string;
+}
+interface InsertLocalFieldOptions {
+    atIndex?: number;
+    schemaFieldNames?: Iterable<string>;
+    correlationId?: string;
+    origin?: string;
+}
+interface InsertLocalFieldResult extends LayoutResult {
+    applied: boolean;
+    diagnostics: LocalFieldInsertionDiagnostic[];
+}
 declare class DynamicFormLayoutService {
     private readonly changesSubject;
     readonly changes$: rxjs.Observable<LayoutChange>;
@@ -178,6 +222,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 +287,44 @@ declare class DynamicFormLayoutService {
         rowId: string;
         columnId: string;
     }, field: any, atIndex?: number): LayoutResult;
+    insertLocalFieldById(config: FormConfig, target: {
+        sectionId: string;
+        rowId: string;
+        columnId: string;
+    }, field: FieldMetadata, options?: InsertLocalFieldOptions): InsertLocalFieldResult;
+    insertLayoutItemById(config: FormConfig, target: {
+        sectionId: string;
+        rowId: string;
+        columnId: string;
+    }, item: FormLayoutItem, atIndex?: number): LayoutResult;
+    private prepareLocalFieldMetadata;
+    private validateLocalFieldInsertion;
+    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 +439,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>;
@@ -361,6 +452,10 @@ declare class PraxisFormActionsComponent implements OnChanges, OnDestroy {
 interface FormAiHost {
     config: FormConfig;
     form: FormGroup;
+    mode?: 'create' | 'edit' | 'view';
+    enableCustomization?: boolean;
+    readonlyModeGlobal?: boolean | null;
+    effectiveReadonly?: boolean;
     applyConfigFromAdapter(config: FormConfig): void;
 }
 
@@ -374,13 +469,25 @@ declare class FormAiAdapter extends BaseAiAdapter<FormConfig> {
     getCapabilities(): AiCapability[];
     getTaskPresets(): Record<string, string[]>;
     getRuntimeState(): Record<string, any>;
+    getAuthoringContext(): Record<string, any>;
+    compileAiResponse(response: Record<string, unknown>): AiResponseCompileResult | null;
     createSnapshot(): FormConfig;
     restoreSnapshot(snapshot: FormConfig): Promise<void>;
     applyPatch(patch: Partial<FormConfig>, intent?: string): Promise<PatchResult>;
     getContextDescription(): string;
     private applyConfig;
     private smartMergeFormConfig;
+    private extractIncomingRules;
+    private extractVisualBlockGuidanceOperationRule;
+    private coerceSingleOperationResponse;
+    private operationInputRecord;
+    private normalizeVisualBlockGuidanceOperationInput;
+    private visualBlockGuidanceParamsToRule;
+    private normalizeLlmRule;
+    private mergeRulesById;
     private cloneConfig;
+    private asRecord;
+    private toNonEmptyString;
     private isFilled;
 }
 
@@ -481,6 +588,13 @@ interface DynamicFormApplyPlan {
     diagnostics: EditorDiagnostic[];
 }
 
+interface PraxisDynamicFormDomainRulesOptions {
+    enabled?: boolean;
+    targetArtifactKey?: string | null;
+    targetLayer?: string | null;
+    targetArtifactType?: string | null;
+    status?: string | null;
+}
 interface DynamicFieldRenderErrorEvent {
     phase: 'executeRendering' | 'detectChanges';
     fieldName: string;
@@ -506,6 +620,21 @@ 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;
+    className?: string | null;
+    style?: Record<string, any> | null;
+}
+type FormColumnRenderItem = FormColumnFieldsRenderItem | FormColumnRichContentRenderItem;
 declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     private crud;
     private http;
@@ -537,12 +666,20 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     private hookPresets?;
     private logger?;
     private readonly i18n;
+    private readonly injector;
+    private readonly aiApi;
+    private readonly assistantSessions;
+    private readonly aiTurnOrchestrator;
+    private readonly jsonLogic;
+    private readonly aiAssistantSessionEffect;
+    private readonly globalActions;
     private readonly DEBUG;
     private effectiveActionsCache?;
     private effectiveActionsCacheBase?;
     private effectiveActionsCacheOverride?;
     private invalidRequiredFieldLabelsCache;
     private invalidRequiredFieldLabelsSignature;
+    readonly richContentHostCapabilities: RichBlockHostCapabilities;
     resourcePath?: string;
     resourceId?: string | number;
     initialValue?: Record<string, unknown> | null;
@@ -617,6 +754,8 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     disabledModeGlobal: boolean | null;
     presentationModeGlobal: boolean | null;
     visibleGlobal: boolean | null;
+    /** Opt-in loader for shared domain rule materializations persisted outside FormConfig. */
+    domainRules: PraxisDynamicFormDomainRulesOptions | boolean | null;
     get effectivePresentation(): boolean;
     get effectiveReadonly(): boolean;
     get effectiveDisabledMode(): boolean | null;
@@ -649,6 +788,8 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     }>;
     /** Forwarded from DynamicFieldLoader to allow host-side observability. */
     fieldRenderError: EventEmitter<DynamicFieldRenderErrorEvent>;
+    /** Emits runtime rule diagnostics so hosts can surface or log invalid rules. */
+    ruleDiagnosticsChange: EventEmitter<RuleApplicationDiagnostic[]>;
     isLoading: boolean;
     submitting: boolean;
     submitError: string | null;
@@ -659,6 +800,13 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     private isInitialized;
     form: FormGroup;
     aiAdapter: FormAiAdapter;
+    aiAssistantOpen: boolean;
+    aiAssistantPrompt: string;
+    aiAssistantLayout: PraxisAssistantShellLayout;
+    aiAssistantViewState: PraxisAssistantTurnViewState;
+    readonly aiAssistantLabels: Partial<PraxisAssistantShellLabels>;
+    private aiAssistantController;
+    private aiAssistantStateSubscription;
     fieldVisibility: {
         [fieldName: string]: boolean;
     };
@@ -667,6 +815,12 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     actionRuleProps: Record<string, Record<string, any>>;
     private rowRuleProps;
     private columnRuleProps;
+    private visualBlockRuleProps;
+    private materializedFormRules;
+    private materializedFormRulesLoadSignature;
+    private readonly formCommandRuleStates;
+    ruleApplicationDiagnostics: RuleApplicationDiagnostic[];
+    private ruleApplicationDiagnosticsSignature;
     private pendingEntityId;
     private loadedEntityId;
     private hydratedEntityId;
@@ -677,6 +831,7 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     private schemaRootHooks?;
     private destroy$;
     private formValueChangesSubscription;
+    private dependencyPolicySubscription;
     private formBuildCycleId;
     private suppressedValueChangeBuildId;
     private pendingBootstrapValueChangeBuildId;
@@ -804,10 +959,21 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     private loadEntity;
     private buildFormFromConfig;
     private resetFormValueChangesSubscription;
+    private resetDependencyPolicySubscription;
+    private setupEntityLookupDependencyPolicies;
+    private applyEntityLookupDependencyPolicy;
+    private isEntityLookupField;
+    private resolveFieldDependencyNames;
+    private allowEntityLookupLegacyRetention;
+    private hasMeaningfulDependencyValue;
+    private setEntityLookupDependencyConflict;
+    private clearEntityLookupDependencyConflict;
+    private resolveEntityLookupDependencyValidationMessage;
     private scheduleValueChangeBootstrapRelease;
     private hasInteractiveFormState;
     private captureFormRuntimeState;
     private getDirtyFieldNames;
+    private collectDirtyFieldNames;
     private buildCurrentFormRuntimeContext;
     private buildRestoreTargetContext;
     private isCompatibleRuntimeStateContext;
@@ -818,6 +984,12 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
      * Some core builds do not enforce required start/end for dateRange fields.
      */
     private applyDateRangeRequiredValidators;
+    /**
+     * Backward-compatible required validation for multiple entity lookups.
+     * Some form-control builders treat `required` correctly for single lookups but
+     * do not mark empty collections as required when `multiple=true`.
+     */
+    private applyEntityLookupCollectionRequiredValidators;
     private isMountAnimationDisabled;
     private triggerMountAnimation;
     protected getMountDurationVar(): string | null;
@@ -828,7 +1000,19 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     private saveConnection;
     disconnect(): void;
     onToolbarRequestClose(): void;
+    private getActiveFormRules;
+    private refreshMaterializedFormRules;
+    private resolveDomainRulesOptions;
     private evaluateAndApplyRules;
+    private applyRuleComputedFieldValues;
+    private evaluateAndDispatchFormCommandRules;
+    private evaluateFormCommandCondition;
+    private executeFormCommandGlobalAction;
+    private isPotentiallyDestructiveFormCommandAction;
+    private resolveFormCommandPath;
+    private areRuleValuesEqual;
+    private buildRuleApplicationTargetIndex;
+    private setRuleApplicationDiagnostics;
     isSectionCollapsed(section?: FormSection): boolean;
     isSectionCollapsible(section?: FormSection): boolean;
     private getSectionRuleProps;
@@ -888,11 +1072,19 @@ 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 getVisualBlockRuleProps;
+    private isRichContentLayoutItemVisible;
     private getColumnFieldsSignature;
+    private getColumnItemsSignature;
     private getColumnRuleProps;
     private buildFieldRuleMetadataOverrides;
     private normalizeRuleFieldOptions;
@@ -910,7 +1102,12 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     private _getConfirmationMessageForAliases;
     private _showConfirmationDialog;
     onFormAction(event: PraxisFormActionEvent): void;
+    private dispatchRichContentAction;
+    private isRichContentActionAvailable;
+    private hasRichContentCapability;
+    private buildRichContentActionContext;
     private _executeAction;
+    private getFormActionEventId;
     onSubmit(): Promise<void>;
     private navigateAfterSave;
     private shouldConfirmCancelOnDirty;
@@ -924,6 +1121,35 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
      * IMPORTANTE: Independe completamente do mode do formulário
      */
     toggleEditMode(): void;
+    openAiAssistant(): void;
+    openAiAssistantFromSession(session: PraxisAssistantSessionSnapshot): void;
+    closeAiAssistant(): void;
+    onAiAssistantPromptChange(prompt: string): void;
+    onAiAssistantSubmit(prompt: string): void;
+    onAiAssistantApply(): void;
+    onAiAssistantRetry(): void;
+    onAiAssistantCancel(): void;
+    onAiAssistantQuickReply(reply: PraxisAssistantShellQuickReply): void;
+    onAiAssistantEditMessage(message: PraxisAssistantShellMessage): void;
+    onAiAssistantResendMessage(message: PraxisAssistantShellMessage): void;
+    onAiAssistantLayoutChange(layout: PraxisAssistantShellLayout): void;
+    aiAssistantTriggerTestId(position: string): string;
+    private initializeAiAssistantController;
+    private buildAiAssistantContextItems;
+    private buildAiAssistantContextSnapshot;
+    private syncAiAssistantSession;
+    private hasAiAssistantSessionState;
+    private resolveAiAssistantSessionId;
+    private resolveAiAssistantOwnerId;
+    private resolveAiAssistantRouteKey;
+    private resolveAiAssistantSummary;
+    private resolveAiAssistantBadge;
+    private resolveAiAssistantIcon;
+    private resolveAiAssistantSelectedTarget;
+    private toAiAssistantTargetKind;
+    private toAiAssistantTargetId;
+    private toAiAssistantTargetLabel;
+    private toAiAssistantPath;
     openConfigEditor(): Promise<void>;
     onElementMouseEnter(event: MouseEvent, type: CanvasElementType, data: any, element?: HTMLElement): void;
     onElementMouseLeave(event: MouseEvent): void;
@@ -978,6 +1204,7 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     private getControlTypeName;
     private applyNullDeletionPatch;
     private stripNullMarkersFromPatch;
+    private mergeMetadataObjectPatch;
     private deleteMetadataPath;
     private getMetadataPath;
     /**
@@ -1069,7 +1296,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; }; "initialValue": { "alias": "initialValue"; "required": false; }; "editorialContext": { "alias": "editorialContext"; "required": false; }; "mode": { "alias": "mode"; "required": false; }; "config": { "alias": "config"; "required": false; }; "actions": { "alias": "actions"; "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>;
+    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; }; "actions": { "alias": "actions"; "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; }; "domainRules": { "alias": "domainRules"; "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"; "ruleDiagnosticsChange": "ruleDiagnosticsChange"; }, never, never, true, never>;
 }
 
 declare class FormConfigService {
@@ -1147,6 +1374,53 @@ declare class JsonConfigEditorComponent implements OnInit, OnDestroy {
     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>;
 }
 
+interface VisualBlockRuleNodeOption {
+    id: string;
+    label: string;
+    kind: string;
+    roles: Array<'text' | 'title' | 'message'>;
+}
+
+type RuleAuthoringStatus = 'valid' | 'invalid-target' | 'invalid-condition' | 'unsupported-property' | 'sanitized-property' | 'runtime-only' | 'visual-builder-compatible' | 'llm-generated-pending-review';
+interface FormRulePropertyIssue {
+    property: string;
+    reason: 'unsupported-property' | 'invalid-value' | 'sanitized-value';
+}
+interface FormRuleTargetDiagnostic {
+    type: NonNullable<FormLayoutRule['targetType']>;
+    id: string;
+    exists: boolean;
+}
+interface FormRuleDiagnostics {
+    ruleId: string;
+    ruleName?: string;
+    status: RuleAuthoringStatus[];
+    targetRefs: FormRuleTargetDiagnostic[];
+    conditionRefs: string[];
+    acceptedProperties: string[];
+    rejectedProperties: string[];
+    acceptedPropertiesWhenFalse: string[];
+    rejectedPropertiesWhenFalse: string[];
+    propertyIssues?: FormRulePropertyIssue[];
+    propertyIssuesWhenFalse?: FormRulePropertyIssue[];
+    runtimeOnlyReason?: string;
+}
+
+interface CommandRulePreviewModel {
+    state: 'ready' | 'invalid';
+    executionMode: 'preview-only';
+    actionId: string;
+    condition: JsonLogicExpression | null;
+    payload?: unknown;
+    payloadExpr?: string;
+    policy: {
+        trigger: 'on-condition-enter';
+        distinct: boolean;
+        distinctBy?: string;
+        runOnInitialEvaluation?: boolean;
+    };
+    diagnostics: string[];
+}
 declare class PraxisDynamicFormConfigEditor implements SettingsValueProvider, OnInit, OnDestroy {
     private storage;
     private configService;
@@ -1157,6 +1431,26 @@ declare class PraxisDynamicFormConfigEditor implements SettingsValueProvider, On
     ruleBuilderConfig: RuleBuilderConfig;
     ruleBuilderState?: RuleBuilderState;
     currentRules: FormLayoutRule[];
+    selectedCommandRuleId: string;
+    commandRuleCondition: JsonLogicExpression | null;
+    commandRuleConditionJson: string;
+    commandRuleActionId: string;
+    commandRulePayloadJson: string;
+    private commandRulePayloadExpr;
+    commandRuleDistinct: boolean;
+    commandRuleDistinctBy: string;
+    commandRuleRunOnInitialEvaluation: boolean;
+    commandRuleAuthoringError: string | null;
+    commandRulePayloadFieldErrors: Record<string, string>;
+    ruleDiagnostics: FormRuleDiagnostics[];
+    visualBlockNodeOptions: Record<string, VisualBlockRuleNodeOption[]>;
+    ruleDiagnosticsSummary: {
+        total: number;
+        invalid: number;
+        runtimeOnly: number;
+        unsupported: number;
+        pendingReview: number;
+    };
     private initialConfig;
     private initialDocument;
     private readonly openedWithCanonicalDocument;
@@ -1200,13 +1494,16 @@ declare class PraxisDynamicFormConfigEditor implements SettingsValueProvider, On
     };
     private destroy$;
     private hasProcessedInitialRuleState;
+    private jsonEditorIsValid;
+    private globalActionValidationIssues;
+    readonly globalActionCatalog: GlobalActionCatalogEntry[];
     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,7 +1513,53 @@ 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;
+    onRulePropertiesChanged(rules: FormLayoutRule[]): void;
+    get commandRules(): PraxisRuntimeConditionalEffectRule<PraxisRuntimeGlobalActionEffect>[];
+    get selectedCommandRule(): PraxisRuntimeConditionalEffectRule<PraxisRuntimeGlobalActionEffect> | undefined;
+    onCommandRuleSelectionChange(): void;
+    onCommandActionChange(): void;
+    onCommandConditionChanged(condition: JsonLogicExpression | null): void;
+    addCommandRule(): void;
+    applyCommandRule(): void;
+    deleteCommandRule(): void;
+    get commandRuleActionSchema(): _praxisui_core.GlobalActionUiSchema | undefined;
+    shouldShowCommandActionField(field: GlobalActionField): boolean;
+    isCommandActionFieldRequired(field: GlobalActionField): boolean;
+    isCommandActionFieldMissing(field: GlobalActionField): boolean;
+    hasCommandActionFieldError(key: string): boolean;
+    getCommandActionFieldError(key: string): string;
+    get commandRulePreview(): CommandRulePreviewModel;
+    getCommandActionFieldValue(field: GlobalActionField): any;
+    onCommandActionFieldChange(field: GlobalActionField, value: any): void;
+    private initializeCommandRuleEditor;
+    private loadCommandRuleEditor;
+    private updateCommandRules;
+    private parseCommandRuleCondition;
+    private parseOptionalJson;
+    private parseCommandPayloadObject;
+    private collectCommandActionFieldValues;
+    private setCommandActionFieldError;
+    private clearCommandActionFieldError;
+    private nextCommandRuleId;
+    private getDefaultCommandActionId;
+    private formatGlobalActionIssue;
+    private computeRuleDiagnosticsSummary;
+    getRuleStatusLabel(diagnostic: FormRuleDiagnostics): string;
+    getRuleStatusTone(diagnostic: FormRuleDiagnostics): 'ok' | 'warn' | 'error';
+    canAcceptPendingLlmRule(diagnostic: FormRuleDiagnostics): boolean;
+    canApplyRulePropertyFix(diagnostic: FormRuleDiagnostics): boolean;
+    applyRulePropertyFix(ruleId: string): void;
+    acceptPendingLlmRule(ruleId: string): void;
+    getRuleDiagnosticDetails(diagnostic: FormRuleDiagnostics): string[];
+    private getRulePropertyIssueNames;
+    private markLlmRuleAccepted;
+    private refreshRuleDiagnostics;
     get jsonDocument(): DynamicFormAuthoringDocument;
     onBackConfigChange(): void;
     isBindingsBlockPersisted(): boolean;
@@ -1229,7 +1572,15 @@ declare class PraxisDynamicFormConfigEditor implements SettingsValueProvider, On
     onPresentationPrefsChange(reason: string): void;
     onSchemaPrefsChange(reason: string): void;
     private createRuleBuilderConfig;
+    private getVisualBuilderRulePropertySchema;
     private mapMetadataToSchema;
+    private getVisualBlockTargetLabel;
+    private getRuleFieldLabel;
+    private getRuleFieldDescription;
+    private refreshVisualBlockNodeOptions;
+    private collectVisualBlockNodeOptions;
+    private getVisualBlockNodeRoles;
+    private findRichContentNodeText;
     private mapDataTypeToFieldType;
     ngOnDestroy(): void;
     onLayoutSelect(event: any): void;
@@ -1248,7 +1599,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 {
@@ -1300,6 +1651,37 @@ declare const PRAXIS_FILTER_FORM_COMPONENT_METADATA: ComponentDocMeta;
 /** Provider to register PraxisFilterForm metadata. */
 declare function providePraxisFilterFormMetadata(): Provider;
 
+interface PraxisFilterFormWidgetEditorInputs {
+    config?: FormConfig | null;
+    formId?: string;
+    resourcePath?: string;
+    mode?: DynamicFormMode | string;
+    [key: string]: unknown;
+}
+interface PraxisFilterFormWidgetEditorValue {
+    inputs: PraxisFilterFormWidgetEditorInputs;
+}
+declare class PraxisFilterFormWidgetConfigEditor implements SettingsValueProvider, AfterViewInit, OnDestroy {
+    inputs: PraxisFilterFormWidgetEditorInputs | null;
+    widgetKey?: string;
+    formEditor?: PraxisDynamicFormConfigEditor;
+    readonly isDirty$: BehaviorSubject<boolean>;
+    readonly isValid$: BehaviorSubject<boolean>;
+    readonly isBusy$: BehaviorSubject<boolean>;
+    private readonly subscription;
+    ngAfterViewInit(): void;
+    ngOnDestroy(): void;
+    getSettingsValue(): PraxisFilterFormWidgetEditorValue;
+    onSave(): PraxisFilterFormWidgetEditorValue;
+    reset(): void;
+    private initializeChildEditor;
+    private buildValue;
+    private createDocumentFromInputs;
+    private normalizeMode;
+    static ɵfac: i0.ɵɵFactoryDeclaration<PraxisFilterFormWidgetConfigEditor, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<PraxisFilterFormWidgetConfigEditor, "praxis-filter-form-widget-config-editor", never, { "inputs": { "alias": "inputs"; "required": false; }; "widgetKey": { "alias": "widgetKey"; "required": false; }; }, {}, never, never, true, never>;
+}
+
 /** Tokens for theme colors used across the layout editor. */
 declare enum LayoutColorToken {
     Surface = "--md-sys-color-surface",
@@ -1323,11 +1705,53 @@ declare class LayoutPrefsService {
     static ɵprov: i0.ɵɵInjectableDeclaration<LayoutPrefsService>;
 }
 
+type VisualBlockPresetId = 'text' | 'notice' | 'divider' | 'infoCard' | 'callout' | 'keyValueList' | 'recordSummary' | 'lookupCard' | 'disclosure' | 'emptyState';
+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 AddLocalFieldEvent {
+    sectionIndex: number;
+    rowIndex: number;
+    columnIndex: number;
+}
+interface EditFieldEvent {
+    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 +1761,19 @@ 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;
+    private localFieldSequence;
     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 +1798,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 +1809,30 @@ declare class LayoutEditorComponent implements OnInit {
     selectRow(sectionIndex: number, rowIndex: number): void;
     selectColumn(sectionIndex: number, rowIndex: number, columnIndex: number): void;
     dropField({ event }: FieldDropEvent): void;
+    private getColumnLayoutItemByIndex;
+    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;
+    addLocalFieldToColumn(event: AddLocalFieldEvent): void;
+    openFieldMetadataEditor(event: EditFieldEvent): void;
+    private openFieldMetadataEditorInternal;
+    private applyFieldMetadataPatch;
+    private createLocalFieldName;
+    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 +1845,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 +1865,51 @@ 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;
+    }>;
+    addLocalField: EventEmitter<{
+        rowIndex: number;
+        columnIndex: number;
+    }>;
+    editField: 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,11 +1922,26 @@ declare class RowConfiguratorComponent implements OnChanges {
     ngOnChanges(changes: SimpleChanges): void;
     private rebuildConnectedColumnsCache;
     getFieldByName(fieldName: string): FieldMetadata;
-    drop(event: CdkDragDrop<string[]>): void;
+    getColumnLayoutItems(column: FormColumn): FormLayoutItem[];
+    trackLayoutItem(_: number, item: FormLayoutItem): string;
+    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: Event): void;
+    openVisualBlockEditor(columnIndex: number, item: FormLayoutItem, event: Event): void;
+    moveVisualBlockItem(columnIndex: number, item: FormLayoutItem, direction: -1 | 1, event: Event): void;
+    canMoveVisualBlockToColumn(columnIndex: number, direction: -1 | 1): boolean;
+    moveVisualBlockToAdjacentColumn(columnIndex: number, item: FormLayoutItem, direction: -1 | 1, event: Event): void;
+    removeVisualBlockItem(columnIndex: number, item: FormLayoutItem, event: Event): void;
+    drop(event: CdkDragDrop<FormLayoutItem[], FormLayoutItem[] | FieldMetadata[], FormLayoutItem | FieldMetadata>): void;
     selectRow(): void;
     openColumnConfig(index: number): void;
     selectColumn(index: number, event: MouseEvent): void;
-    selectField(fieldName: string, event: MouseEvent): void;
+    selectField(fieldName: string, columnIndex: number, event: MouseEvent): void;
+    openFieldEditor(fieldName: string, columnIndex: number, event: Event): void;
     openRowMenu(): void;
     onMenuClosed(): void;
     onDropEnter(index: number): void;
@@ -1444,6 +1955,9 @@ 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;
+    addLocalFieldToColumn(index: number): void;
     addFieldToColumn(index: number): void;
     getColumnId(index: number): string;
     private generateId;
@@ -1467,7 +1981,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"; "addLocalField": "addLocalField"; "editField": "editField"; "editVisualBlock": "editVisualBlock"; "moveVisualBlock": "moveVisualBlock"; "moveVisualBlockToColumn": "moveVisualBlockToColumn"; "removeVisualBlock": "removeVisualBlock"; "select": "select"; }, never, never, true, never>;
 }
 
 declare class FieldConfiguratorComponent {
@@ -1485,11 +1999,69 @@ declare class FieldConfiguratorComponent {
     static ɵcmp: i0.ɵɵComponentDeclaration<FieldConfiguratorComponent, "praxis-field-configurator", never, { "field": { "alias": "field"; "required": false; }; }, {}, never, never, true, never>;
 }
 
+interface PraxisDynamicFormWidgetEditorInputs {
+    config?: FormConfig | null;
+    mode?: DynamicFormMode;
+    formId?: string;
+    componentInstanceId?: string;
+    backConfig?: BackConfig;
+    notifyIfOutdated?: 'inline' | 'snackbar' | 'both' | 'none';
+    snoozeMs?: number;
+    autoOpenSettingsOnOutdated?: boolean;
+    [key: string]: unknown;
+}
+interface PraxisDynamicFormWidgetEditorValue {
+    inputs: PraxisDynamicFormWidgetEditorInputs;
+}
+declare class PraxisDynamicFormWidgetConfigEditor implements SettingsValueProvider, AfterViewInit, OnDestroy {
+    inputs: PraxisDynamicFormWidgetEditorInputs | null;
+    widgetKey?: string;
+    formEditor?: PraxisDynamicFormConfigEditor;
+    readonly isDirty$: BehaviorSubject<boolean>;
+    readonly isValid$: BehaviorSubject<boolean>;
+    readonly isBusy$: BehaviorSubject<boolean>;
+    private readonly subscription;
+    ngAfterViewInit(): void;
+    ngOnDestroy(): void;
+    getSettingsValue(): PraxisDynamicFormWidgetEditorValue;
+    onSave(): PraxisDynamicFormWidgetEditorValue;
+    reset(): void;
+    private initializeChildEditor;
+    private buildValue;
+    private createDocumentFromInputs;
+    static ɵfac: i0.ɵɵFactoryDeclaration<PraxisDynamicFormWidgetConfigEditor, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<PraxisDynamicFormWidgetConfigEditor, "praxis-dynamic-form-widget-config-editor", never, { "inputs": { "alias": "inputs"; "required": false; }; "widgetKey": { "alias": "widgetKey"; "required": false; }; }, {}, never, never, true, never>;
+}
+
 /** Metadata for PraxisDynamicForm component */
 declare const PRAXIS_DYNAMIC_FORM_COMPONENT_METADATA: ComponentDocMeta;
 /** Provider para auto-registrar metadados do componente Dynamic Form. */
 declare function providePraxisDynamicFormMetadata(): Provider;
 
+interface DomainRuleFormRulesRequestOptions extends DomainRuleRequestOptions {
+    targetLayer?: string;
+    targetArtifactType?: string;
+    status?: string;
+}
+type DomainRuleMaterializedFormLayoutRule = FormLayoutRule & {
+    metadata?: Record<string, unknown>;
+};
+declare class DomainRuleFormRulesService {
+    private readonly domainRules;
+    constructor(domainRules: DomainRuleService);
+    listRulesForForm(targetArtifactKey: string, options?: DomainRuleFormRulesRequestOptions): Observable<DomainRuleMaterializedFormLayoutRule[]>;
+    materializationsToFormRules(materializations: DomainRuleMaterialization[] | null | undefined): DomainRuleMaterializedFormLayoutRule[];
+    materializationToFormRule(materialization: DomainRuleMaterialization): DomainRuleMaterializedFormLayoutRule | null;
+    private asDirectFormRule;
+    private visualBlockGuidanceToRule;
+    private withDomainMetadata;
+    private asRecord;
+    private asStringArray;
+    private resolveString;
+    static ɵfac: i0.ɵɵFactoryDeclaration<DomainRuleFormRulesService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<DomainRuleFormRulesService>;
+}
+
 declare function isRuleSatisfied(rule: FormLayoutRule, data: unknown): boolean;
 /**
  * Applies all visibility rules to the provided data and
@@ -1581,6 +2153,7 @@ type ActionCatalogOption = {
     id: string;
     label: string;
     description?: string;
+    payloadSchema?: GlobalActionCatalogEntry['payloadSchema'];
     param?: {
         required?: boolean;
         label?: string;
@@ -1634,7 +2207,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 +2226,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 +2265,7 @@ declare class SectionEditorComponent implements OnInit, AfterViewInit, OnDestroy
     private normalizeHeaderActions;
     private mapCatalogEntryToActionSpec;
     private getActionCatalogDescription;
+    private normalizeHeaderGlobalAction;
     private headerActionStyleValidator;
     private stringifyHeaderActionStyle;
     private parseHeaderActionStyle;
@@ -1881,7 +2454,8 @@ declare enum FormRuleTargetType {
     Section = "section",
     Action = "action",
     Row = "row",
-    Column = "column"
+    Column = "column",
+    VisualBlock = "visualBlock"
 }
 declare enum FormRuleContext {
     Visibility = "visibility",
@@ -1973,5 +2547,49 @@ 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, 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 };
+type DynamicFormRuleTargetType = NonNullable<FormLayoutRule['targetType']>;
+interface DynamicFormRuleAuthoringField {
+    name: string;
+    label?: string;
+    type?: string;
+    source?: string;
+    submitPolicy?: string;
+}
+interface DynamicFormRuleAuthoringTarget {
+    id: string;
+    label?: string;
+}
+interface DynamicFormRuleAuthoringVisualBlockNode {
+    id: string;
+    label: string;
+    kind: string;
+    roles: Array<'text' | 'title' | 'message'>;
+}
+type DynamicFormRuleAuthoringTargets = Record<DynamicFormRuleTargetType, string[]>;
+type DynamicFormRuleAuthoringTargetDetails = Record<DynamicFormRuleTargetType, DynamicFormRuleAuthoringTarget[]>;
+type DynamicFormAllowedRuleProperties = Record<DynamicFormRuleTargetType, string[]>;
+interface DynamicFormRuleAuthoringContext {
+    component: 'praxis-dynamic-form';
+    capabilityCatalogVersion: string;
+    fields: DynamicFormRuleAuthoringField[];
+    targets: DynamicFormRuleAuthoringTargets;
+    targetDetails: DynamicFormRuleAuthoringTargetDetails;
+    allowedRuleProperties: DynamicFormAllowedRuleProperties;
+    visualBlockNodes: Record<string, DynamicFormRuleAuthoringVisualBlockNode[]>;
+    existingRules: FormLayoutRule[];
+    diagnostics: FormRuleDiagnostics[];
+    guardrails: string[];
+}
+declare function buildDynamicFormRuleAuthoringContext(config: Pick<FormConfig, 'fieldMetadata' | 'sections' | 'actions' | 'formRules'>): DynamicFormRuleAuthoringContext;
+
+/**
+ * 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, DomainRuleFormRulesService, DynamicFormLayoutService, FORM_AI_CAPABILITIES, FORM_COMPONENT_AI_CAPABILITIES, FieldConfiguratorComponent, FieldEditorComponent, FormConfigService, FormContextService, FormLayoutService, FormRulesService, JsonConfigEditorComponent, LayoutColorToken, LayoutEditorComponent, LayoutPrefsService, PRAXIS_DYNAMIC_FORM_AUTHORING_MANIFEST, PRAXIS_DYNAMIC_FORM_COMPONENT_METADATA, PRAXIS_FILTER_FORM_COMPONENT_METADATA, PraxisDynamicForm, PraxisDynamicFormConfigEditor, PraxisDynamicFormWidgetConfigEditor, PraxisFilterForm, PraxisFilterFormWidgetConfigEditor, PraxisFormActionsComponent, RowConfiguratorComponent, RowEditorComponent, SETTINGS_PANEL_DYNAMIC_FORM_PROVIDER, SectionEditorComponent, TASK_PRESETS, applyVisibilityRules, buildDynamicFormApplyPlan, buildDynamicFormRuleAuthoringContext, 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, DomainRuleFormRulesRequestOptions, DomainRuleMaterializedFormLayoutRule, DynamicFieldRenderErrorEvent, DynamicFormAllowedRuleProperties, DynamicFormApplyPlan, DynamicFormAuthoringDocument, DynamicFormBindings, DynamicFormContextSnapshot, DynamicFormMode, DynamicFormPresentationSnapshot, DynamicFormProjectionContext, DynamicFormResolvedRuntimeContract, DynamicFormRuleAuthoringContext, DynamicFormRuleAuthoringField, DynamicFormRuleAuthoringTarget, DynamicFormRuleAuthoringTargetDetails, DynamicFormRuleAuthoringTargets, DynamicFormRuleAuthoringVisualBlockNode, DynamicFormRuleTargetType, DynamicFormRuntimeContext, DynamicFormRuntimeValueSource, DynamicFormSchemaPrefsSnapshot, DynamicFormValidationContext, EditorDiagnostic, EditorDocument, FieldPath, FieldPathContainer, FieldPathWithIndex, Capability as FormComponentCapability, CapabilityCatalog as FormComponentCapabilityCatalog, CapabilityCategory as FormComponentCapabilityCategory, ValueKind as FormComponentValueKind, FormConfigLike, IdPath, InsertLocalFieldOptions, InsertLocalFieldResult, JsonEditorEvent, JsonValidationResult, LayoutChange, LayoutResult, LocalFieldInsertionDiagnostic, LocalFieldInsertionDiagnosticCode, Operation, Path, PathWithIndex, PraxisDynamicFormDomainRulesOptions, PraxisDynamicFormWidgetEditorInputs, PraxisDynamicFormWidgetEditorValue, PraxisFilterFormWidgetEditorInputs, PraxisFilterFormWidgetEditorValue, PraxisFormActionEvent, RemovePolicy, RuleApplicationContext, RuleApplicationDiagnostic, RuleApplicationDiagnosticCode, RuleApplicationResult, RuleApplicationTargetIndex, RuleApplicationTargetType, ValidationReport, ValueKind$1 as ValueKind };