@praxisui/dynamic-form 8.0.0-beta.17 → 8.0.0-beta.19

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, FormLayoutItem, FormActionButton, AiCapability, BackConfig, ApiEndpoint, ApiUrlEntry, FormHooksLayout, EndpointConfig, FormSubmitEvent, FormReadyEvent, FormValueChangeEvent, SyncResult, FormInitializationError, LoadingState, FormCustomActionEvent, FormActionConfirmationEvent, RichContentDocument, JsonLogicRecord, GenericCrudService, ConnectionStorage, DynamicFormService, ErrorMessageService, SchemaNormalizerService, ComponentMetadataRegistry, GlobalConfigService, ComponentKeyService, LoadingOrchestrator, ApiUrlConfig, PraxisLoadingRenderer, FormHooksRegistry, FormHookPreset, LoggerService, FormSectionHeaderAction, FormSectionHeaderConfig, FormConfigState, GlobalActionCatalogEntry, FieldDefinition, ComponentDocMeta, Breakpoint, IconPickerService, GlobalActionRef, SurfaceOpenPayload, AiCapabilityCategory, AiValueKind, AiCapabilityCatalog, ComponentAuthoringManifest } from '@praxisui/core';
+import { AsyncConfigStorage, FormLayout, FieldMetadata, FormLayoutRule, FormRuleTargetType as FormRuleTargetType$1, PraxisJsonLogicService, FormSection, FormRow, FormColumn, FormConfig, FormLayoutItem, FormActionButton, AiCapability, BackConfig, ApiEndpoint, ApiUrlEntry, FormHooksLayout, EndpointConfig, FormSubmitEvent, FormReadyEvent, FormValueChangeEvent, SyncResult, FormInitializationError, LoadingState, FormCustomActionEvent, FormActionConfirmationEvent, RichContentDocument, JsonLogicRecord, GenericCrudService, ConnectionStorage, DynamicFormService, ErrorMessageService, SchemaNormalizerService, ComponentMetadataRegistry, GlobalConfigService, ComponentKeyService, LoadingOrchestrator, ApiUrlConfig, PraxisLoadingRenderer, FormHooksRegistry, FormHookPreset, LoggerService, FormSectionHeaderAction, FormSectionHeaderConfig, FormConfigState, GlobalActionCatalogEntry, FieldDefinition, ComponentDocMeta, Breakpoint, 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.
  */
@@ -54,6 +63,12 @@ interface RuleApplicationResult {
     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;
@@ -65,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>;
@@ -159,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>;
@@ -246,11 +281,18 @@ 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;
@@ -417,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;
 }
 
@@ -524,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;
@@ -595,6 +656,7 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     private hookPresets?;
     private logger?;
     private readonly i18n;
+    private readonly injector;
     private readonly DEBUG;
     private effectiveActionsCache?;
     private effectiveActionsCacheBase?;
@@ -675,6 +737,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;
@@ -707,6 +771,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;
@@ -726,6 +792,10 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     private rowRuleProps;
     private columnRuleProps;
     private visualBlockRuleProps;
+    private materializedFormRules;
+    private materializedFormRulesLoadSignature;
+    ruleApplicationDiagnostics: RuleApplicationDiagnostic[];
+    private ruleApplicationDiagnosticsSignature;
     private pendingEntityId;
     private loadedEntityId;
     private hydratedEntityId;
@@ -888,7 +958,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;
@@ -1139,7 +1214,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 {
@@ -1217,6 +1292,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;
@@ -1227,6 +1334,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;
@@ -1295,6 +1411,18 @@ declare class PraxisDynamicFormConfigEditor implements SettingsValueProvider, On
     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;
@@ -1307,8 +1435,14 @@ 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;
@@ -1433,6 +1567,17 @@ interface AddApiFieldEvent {
     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;
 }
@@ -1452,6 +1597,7 @@ declare class LayoutEditorComponent implements OnInit {
     private readonly settingsPanel;
     private readonly i18n;
     private visualBlockIdSequence;
+    private localFieldSequence;
     protected readonly colorTokens: typeof LayoutColorToken;
     selected: {
         type: 'section' | 'row' | 'column' | 'field' | 'visualBlock';
@@ -1505,6 +1651,11 @@ declare class LayoutEditorComponent implements OnInit {
     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;
@@ -1556,6 +1707,15 @@ declare class RowConfiguratorComponent implements OnChanges {
         columnIndex: number;
         fieldName: string;
     }>;
+    addLocalField: EventEmitter<{
+        rowIndex: number;
+        columnIndex: number;
+    }>;
+    editField: EventEmitter<{
+        rowIndex: number;
+        columnIndex: number;
+        fieldName: string;
+    }>;
     editVisualBlock: EventEmitter<{
         rowIndex: number;
         columnIndex: number;
@@ -1612,7 +1772,8 @@ declare class RowConfiguratorComponent implements OnChanges {
     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;
@@ -1628,6 +1789,7 @@ declare class RowConfiguratorComponent implements OnChanges {
     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;
@@ -1651,7 +1813,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; }; "availableFields": { "alias": "availableFields"; "required": false; }; "sectionIndex": { "alias": "sectionIndex"; "required": false; }; "rowIndex": { "alias": "rowIndex"; "required": false; }; "isLastRow": { "alias": "isLastRow"; "required": false; }; "selected": { "alias": "selected"; "required": false; }; "availableFieldsListId": { "alias": "availableFieldsListId"; "required": false; }; "connectedDropListIds": { "alias": "connectedDropListIds"; "required": false; }; "gapGlobal": { "alias": "gapGlobal"; "required": false; }; }, { "rowChange": "rowChange"; "remove": "remove"; "applyRowGapAll": "applyRowGapAll"; "fieldDrop": "fieldDrop"; "addVisualBlock": "addVisualBlock"; "addApiField": "addApiField"; "editVisualBlock": "editVisualBlock"; "moveVisualBlock": "moveVisualBlock"; "moveVisualBlockToColumn": "moveVisualBlockToColumn"; "removeVisualBlock": "removeVisualBlock"; "select": "select"; }, never, never, true, never>;
+    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 {
@@ -1674,6 +1836,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
@@ -2159,6 +2345,41 @@ declare const FORM_COMPONENT_AI_CAPABILITIES: CapabilityCatalog;
  */
 declare function getFormAiCatalog(formConfig?: FormConfig): AiCapabilityCatalog;
 
+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.
@@ -2168,5 +2389,5 @@ declare function getFormAiCatalog(formConfig?: FormConfig): AiCapabilityCatalog;
  */
 declare const PRAXIS_DYNAMIC_FORM_AUTHORING_MANIFEST: ComponentAuthoringManifest;
 
-export { ActionsEditorComponent, CanvasStateService, CanvasToolbarComponent, ColumnEditorComponent, DynamicFormLayoutService, FORM_AI_CAPABILITIES, FORM_COMPONENT_AI_CAPABILITIES, FieldConfiguratorComponent, FieldEditorComponent, FormConfigService, FormContextService, FormLayoutService, JsonConfigEditorComponent, LayoutColorToken, LayoutEditorComponent, LayoutPrefsService, PRAXIS_DYNAMIC_FORM_AUTHORING_MANIFEST, PRAXIS_DYNAMIC_FORM_COMPONENT_METADATA, PRAXIS_FILTER_FORM_COMPONENT_METADATA, PraxisDynamicForm, PraxisDynamicFormConfigEditor, PraxisFilterForm, PraxisFormActionsComponent, RowConfiguratorComponent, RowEditorComponent, SETTINGS_PANEL_DYNAMIC_FORM_PROVIDER, SectionEditorComponent, TASK_PRESETS, applyVisibilityRules, buildDynamicFormApplyPlan, createDynamicFormAuthoringDocument, formLayoutRulesToBuilderState, getFormAiCatalog, getFormCapabilities, getFormEnum, isRuleSatisfied, normalizeDateArrays, normalizeDynamicFormAuthoringDocument, parseLegacyOrDynamicFormDocument, providePraxisDynamicFormMetadata, providePraxisFilterFormMetadata, provideSettingsPanelDynamicForm, ruleBuilderStateToFormLayoutRules, serializeDynamicFormAuthoringDocument, stripLegacyFieldMetadata, toCanonicalDynamicFormConfig, validateDynamicFormAuthoringDocument, validateDynamicFormAuthoringInput };
-export type { CanvasElement, CanvasElementType, CanvasPathPart, Capability$1 as Capability, CapabilityCatalog$1 as CapabilityCatalog, CapabilityCategory$1 as CapabilityCategory, DynamicFieldRenderErrorEvent, DynamicFormApplyPlan, DynamicFormAuthoringDocument, DynamicFormBindings, DynamicFormContextSnapshot, DynamicFormMode, DynamicFormPresentationSnapshot, DynamicFormProjectionContext, DynamicFormResolvedRuntimeContract, DynamicFormRuntimeContext, DynamicFormRuntimeValueSource, DynamicFormSchemaPrefsSnapshot, DynamicFormValidationContext, EditorDiagnostic, EditorDocument, FieldPath, FieldPathContainer, FieldPathWithIndex, Capability as FormComponentCapability, CapabilityCatalog as FormComponentCapabilityCatalog, CapabilityCategory as FormComponentCapabilityCategory, ValueKind as FormComponentValueKind, FormConfigLike, IdPath, JsonEditorEvent, JsonValidationResult, LayoutChange, LayoutResult, Operation, Path, PathWithIndex, PraxisFormActionEvent, RemovePolicy, ValidationReport, ValueKind$1 as ValueKind };
+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 };

package/package.json

@@ -1,16 +1,16 @@
 {
   "name": "@praxisui/dynamic-form",
-  "version": "8.0.0-beta.17",
+  "version": "8.0.0-beta.19",
   "description": "Angular dynamic form engine for Praxis UI: metadata-driven forms, hooks, and services integrating @praxisui/* packages.",
   "peerDependencies": {
     "@angular/common": "^20.0.0",
     "@angular/core": "^20.0.0",
     "@angular/cdk": "^20.0.0",
-    "@praxisui/rich-content": "^8.0.0-beta.17",
-    "@praxisui/settings-panel": "^8.0.0-beta.17",
-    "@praxisui/visual-builder": "^8.0.0-beta.17",
-    "@praxisui/core": "^8.0.0-beta.17",
-    "@praxisui/cron-builder": "^8.0.0-beta.17"
+    "@praxisui/rich-content": "^8.0.0-beta.19",
+    "@praxisui/settings-panel": "^8.0.0-beta.19",
+    "@praxisui/visual-builder": "^8.0.0-beta.19",
+    "@praxisui/core": "^8.0.0-beta.19",
+    "@praxisui/cron-builder": "^8.0.0-beta.19"
   },
   "dependencies": {
     "tslib": "^2.3.0",