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

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, GlobalActionCatalogEntry, 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 { KeyboardShortcutService } from '@praxisui/dynamic-fields';
-import { BaseAiAdapter, PatchResult } from '@praxisui/ai';
+import { BaseAiAdapter, AiResponseCompileResult, 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' | '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,13 @@ 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>>;
+    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 +80,11 @@ 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 addUnsupportedPropertyDiagnostics;
     private setPath;
     private deletePath;
     static ɵfac: i0.ɵɵFactoryDeclaration<FormRulesService, never>;
@@ -96,6 +115,7 @@ interface Operation {
         sectionId?: string;
         rowId?: string;
         columnId?: string;
+        itemId?: string;
         fieldName?: string;
         sectionIndex?: number;
         rowIndex?: number;
@@ -106,6 +126,7 @@ interface Operation {
         sectionId?: string;
         rowId?: string;
         columnId?: string;
+        itemId?: string;
         fieldName?: string;
         sectionIndex?: number;
         rowIndex?: number;
@@ -156,6 +177,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 +216,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 +281,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 +433,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>;
@@ -374,13 +459,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 +578,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 +610,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 +656,15 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     private hookPresets?;
     private logger?;
     private readonly i18n;
+    private readonly injector;
+    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 +739,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 +773,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;
@@ -667,6 +793,11 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     actionRuleProps: Record<string, Record<string, any>>;
     private rowRuleProps;
     private columnRuleProps;
+    private visualBlockRuleProps;
+    private materializedFormRules;
+    private materializedFormRulesLoadSignature;
+    ruleApplicationDiagnostics: RuleApplicationDiagnostic[];
+    private ruleApplicationDiagnosticsSignature;
     private pendingEntityId;
     private loadedEntityId;
     private hydratedEntityId;
@@ -677,6 +808,7 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     private schemaRootHooks?;
     private destroy$;
     private formValueChangesSubscription;
+    private dependencyPolicySubscription;
     private formBuildCycleId;
     private suppressedValueChangeBuildId;
     private pendingBootstrapValueChangeBuildId;
@@ -804,10 +936,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 +961,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 +977,12 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     private saveConnection;
     disconnect(): void;
     onToolbarRequestClose(): void;
+    private getActiveFormRules;
+    private refreshMaterializedFormRules;
+    private resolveDomainRulesOptions;
     private evaluateAndApplyRules;
+    private buildRuleApplicationTargetIndex;
+    private setRuleApplicationDiagnostics;
     isSectionCollapsed(section?: FormSection): boolean;
     isSectionCollapsible(section?: FormSection): boolean;
     private getSectionRuleProps;
@@ -888,11 +1042,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 +1072,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;
@@ -978,6 +1145,7 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     private getControlTypeName;
     private applyNullDeletionPatch;
     private stripNullMarkersFromPatch;
+    private mergeMetadataObjectPatch;
     private deleteMetadataPath;
     private getMetadataPath;
     /**
@@ -1069,7 +1237,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 +1315,38 @@ 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;
+}
+
 declare class PraxisDynamicFormConfigEditor implements SettingsValueProvider, OnInit, OnDestroy {
     private storage;
     private configService;
@@ -1157,6 +1357,15 @@ declare class PraxisDynamicFormConfigEditor implements SettingsValueProvider, On
     ruleBuilderConfig: RuleBuilderConfig;
     ruleBuilderState?: RuleBuilderState;
     currentRules: FormLayoutRule[];
+    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 +1409,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,7 +1428,24 @@ 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;
+    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 +1458,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 +1485,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 +1560,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 +1616,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 +1653,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 +1664,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 +1700,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 +1720,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 +1777,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 +1810,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 +1836,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 {
@@ -1490,6 +1859,30 @@ 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 +1974,7 @@ type ActionCatalogOption = {
     id: string;
     label: string;
     description?: string;
+    payloadSchema?: GlobalActionCatalogEntry['payloadSchema'];
     param?: {
         required?: boolean;
         label?: string;
@@ -1634,7 +2028,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 +2047,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 +2086,7 @@ declare class SectionEditorComponent implements OnInit, AfterViewInit, OnDestroy
     private normalizeHeaderActions;
     private mapCatalogEntryToActionSpec;
     private getActionCatalogDescription;
+    private normalizeHeaderGlobalAction;
     private headerActionStyleValidator;
     private stringifyHeaderActionStyle;
     private parseHeaderActionStyle;
@@ -1881,7 +2275,8 @@ declare enum FormRuleTargetType {
     Section = "section",
     Action = "action",
     Row = "row",
-    Column = "column"
+    Column = "column",
+    VisualBlock = "visualBlock"
 }
 declare enum FormRuleContext {
     Visibility = "visibility",
@@ -1973,5 +2368,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, PraxisFilterForm, 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, PraxisFormActionEvent, RemovePolicy, RuleApplicationContext, RuleApplicationDiagnostic, RuleApplicationDiagnosticCode, RuleApplicationResult, RuleApplicationTargetIndex, RuleApplicationTargetType, ValidationReport, ValueKind$1 as ValueKind };