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

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, 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 { 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, AiResponseCompileResult, PatchResult } from '@praxisui/ai';
 import { RuleBuilderConfig, RuleBuilderState } from '@praxisui/visual-builder';
 
 declare class FormLayoutService {
@@ -44,7 +44,7 @@ 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';
+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;
@@ -63,6 +63,8 @@ interface RuleApplicationResult {
     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']>;
@@ -84,6 +86,10 @@ declare class FormRulesService {
     private ruleTargetExists;
     private normalizeRuleTargetId;
     private evaluateCondition;
+    private evaluateRuleValue;
+    private evaluateJsonLogicValue;
+    private resolveComputedRuleFormData;
+    private areRuleValuesEqual;
     private addUnsupportedPropertyDiagnostics;
     private setPath;
     private deletePath;
@@ -446,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;
 }
 
@@ -657,6 +667,11 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     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?;
@@ -785,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;
     };
@@ -796,6 +818,7 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     private visualBlockRuleProps;
     private materializedFormRules;
     private materializedFormRulesLoadSignature;
+    private readonly formCommandRuleStates;
     ruleApplicationDiagnostics: RuleApplicationDiagnostic[];
     private ruleApplicationDiagnosticsSignature;
     private pendingEntityId;
@@ -981,6 +1004,13 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     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;
@@ -1000,6 +1030,8 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     getSectionHeaderAlign(section: FormSection): 'start' | 'center' | undefined;
     getSectionGapBottom(section: FormSection): number | null;
     getSectionTitleGapBottom(section: FormSection): number | null;
+    getEffectiveSectionTitleGapBottom(section: FormSection): number;
+    isSectionHeaderTitleOnly(section: FormSection): boolean;
     getSectionDescriptionGapBottom(section: FormSection): number | null;
     getSectionHeaderActionColor(action: FormSectionHeaderAction): 'primary' | 'accent' | 'warn' | undefined;
     getSectionHeaderActionTooltip(action: FormSectionHeaderAction): string;
@@ -1091,6 +1123,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;
@@ -1347,6 +1408,21 @@ interface FormRuleDiagnostics {
     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;
@@ -1357,6 +1433,17 @@ 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: {
@@ -1411,7 +1498,7 @@ declare class PraxisDynamicFormConfigEditor implements SettingsValueProvider, On
     private hasProcessedInitialRuleState;
     private jsonEditorIsValid;
     private globalActionValidationIssues;
-    private readonly globalActionCatalog;
+    readonly globalActionCatalog: GlobalActionCatalogEntry[];
     isDirty$: BehaviorSubject<boolean>;
     isValid$: BehaviorSubject<boolean>;
     isBusy$: BehaviorSubject<boolean>;
@@ -1435,6 +1522,35 @@ declare class PraxisDynamicFormConfigEditor implements SettingsValueProvider, On
     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';
@@ -1523,6 +1639,7 @@ declare class PraxisFilterForm implements OnChanges, OnDestroy {
     private hasExplicitDefaultValue;
     onFormSubmit(): void;
     getColumnFields(column: FormColumn): FieldMetadata[];
+    getColumnClasses(column: FormColumn): string | null;
     get fieldMetadata(): FieldMetadata[];
     get hasLayout(): boolean;
     trackBySection(i: number, section: FormSection): string;
@@ -1537,6 +1654,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",
@@ -1854,6 +2002,40 @@ 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. */
@@ -2412,5 +2594,5 @@ declare function buildDynamicFormRuleAuthoringContext(config: Pick<FormConfig, '
  */
 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 };
+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 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@praxisui/dynamic-form",
-  "version": "8.0.0-beta.20",
+  "version": "8.0.0-beta.22",
   "description": "Angular dynamic form engine for Praxis UI: metadata-driven forms, hooks, and services integrating @praxisui/* packages.",
   "peerDependencies": {
     "@angular/common": "^20.0.0",
@@ -9,13 +9,13 @@
     "@angular/forms": "^20.0.0",
     "@angular/material": "^20.0.0",
     "@angular/router": "^20.0.0",
-    "@praxisui/ai": "^8.0.0-beta.20",
-    "@praxisui/dynamic-fields": "^8.0.0-beta.20",
-    "@praxisui/metadata-editor": "^8.0.0-beta.20",
-    "@praxisui/rich-content": "^8.0.0-beta.20",
-    "@praxisui/settings-panel": "^8.0.0-beta.20",
-    "@praxisui/visual-builder": "^8.0.0-beta.20",
-    "@praxisui/core": "^8.0.0-beta.20",
+    "@praxisui/ai": "^8.0.0-beta.22",
+    "@praxisui/dynamic-fields": "^8.0.0-beta.22",
+    "@praxisui/metadata-editor": "^8.0.0-beta.22",
+    "@praxisui/rich-content": "^8.0.0-beta.22",
+    "@praxisui/settings-panel": "^8.0.0-beta.22",
+    "@praxisui/visual-builder": "^8.0.0-beta.22",
+    "@praxisui/core": "^8.0.0-beta.22",
     "rxjs": "^7.8.0"
   },
   "dependencies": {

package/src/lib/config-editor/praxis-dynamic-form-config-editor.json-api.md

@@ -58,6 +58,7 @@ Este documento e a referencia canonica da API JSON de praxis-dynamic-form-config
 - O editor visual e o editor JSON operam sobre `DynamicFormAuthoringDocument`.
 - O editor JSON aceita apenas o envelope canônico; payloads legados pertencem aos caminhos de compatibilidade do runtime.
 - `Apply` e `Save` emitem um snapshot canonico completo com semantica `replace-all`.
+- Em comandos condicionais, o editor visual autora `globalAction.payload` estruturado; `globalAction.payloadExpr` fica reservado ao JSON avancado e e preservado no round-trip quando nenhum payload estruturado e definido.
 - `config`, `bindings` e `contextSnapshot` substituem integralmente o estado autoral anterior.
 - Ausencia de `bindings.mode` limpa o binding persistido e restaura o modo default efetivo do host.
 - Ausencia de `contextSnapshot.backConfig`, `contextSnapshot.presentation` ou `contextSnapshot.schemaPrefs` significa remocao explicita do bloco ausente.

package/src/lib/praxis-dynamic-form.json-api.md

@@ -20,6 +20,10 @@ owner: "praxis-ui"
 source_of_truth:
   - "projects/praxis-dynamic-form/src/lib/praxis-dynamic-form.ts"
   - "projects/praxis-dynamic-form/src/lib/praxis-dynamic-form.html"
+  - "projects/praxis-dynamic-form/src/lib/ai/dynamic-form-agentic-authoring-turn-flow.ts"
+  - "projects/praxis-dynamic-form/src/lib/ai/form-ai.adapter.ts"
+  - "projects/praxis-ai/src/lib/core/models/assistant-context.models.ts"
+  - "projects/praxis-ai/src/lib/core/services/assistant-session-registry.service.ts"
   - "projects/praxis-dynamic-form/src/lib/config-editor/praxis-dynamic-form-config-editor.ts"
   - "projects/praxis-dynamic-form/src/lib/utils/prepare-submit-payload.ts"
   - "projects/praxis-dynamic-fields/src/lib/directives/dynamic-field-loader.directive.ts"
@@ -30,8 +34,8 @@ source_of_truth:
   - "projects/praxis-core/src/lib/services/dynamic-form.service.ts"
   - "projects/praxis-core/src/lib/models/form/rule-property.schema.ts"
   - "projects/praxis-dynamic-form/docs/layout-items-visual-blocks.md"
-source_of_truth_last_verified: "2026-04-18"
-last_updated: "2026-04-22"
+source_of_truth_last_verified: "2026-05-02"
+last_updated: "2026-05-02"
 toc: true
 sidebar: true
 tags:
@@ -68,6 +72,23 @@ Este documento e a referencia canonica da API JSON de praxis-dynamic-form.
 - `backConfig`, `presentation` e `schemaPrefs` permanecem fora de `FormConfig`, mas fazem parte oficialmente do documento autoral persistivel em `contextSnapshot`.
 - APIs de compatibilidade como `applyConfigFromAdapter(...)` continuam aceitando payloads legados/parciais com semantica `merge-compat`, preservando campos nao informados.
 
+## AI assistant and semantic authoring boundary
+
+`praxis-dynamic-form` usa o copiloto semantico Praxis como superficie assistiva contextual, nao como fonte primaria de regra de negocio. O componente pode abrir o assistente a partir de controles de configuracao, floating help ou selecao do canvas, mas a presenca global, minimizacao e retomada da sessao pertencem ao `PraxisAssistantSessionRegistryService`.
+
+Contrato operacional:
+
+- a integracao nova deve abrir `PraxisAiAssistantShellComponent`; `PraxisAiAssistantComponent` permanece legado para novos fluxos inteligentes;
+- a identidade canonica da sessao segue `form:{routeKey}:{componentInstanceId || formId || 'form'}`;
+- o contexto assistivel publico e `PraxisAssistantContextSnapshot`, com `identity`, `target`, `contextItems`, `authoringManifestRef`, `resourcePath`, `schemaFields`, digests seguros e hints de governanca;
+- o snapshot pode apontar para `field`, `schemaBackedField`, `localField`, `section`, `row`, `column`, `visualBlock`, `formAction`, `message` ou `rule`, mas nao deve transportar `form.value`, `rawFormData`, config completa, notas privadas, estado runtime bruto, diagnostics arbitrarios, `pendingPatch`, `File`, `Blob`, bytes, base64 ou `previewUrl`;
+- edicao local so pode ser aplicada quando a resposta for compilada para `componentEditPlan` validado pelo manifesto autoral do componente;
+- patches livres retornados por backend/LLM sem plano compilado sao rejeitados pelo turn flow;
+- pedidos sobre regra de negocio compartilhada, elegibilidade, compliance, LGPD, politica, acesso, aprovacao, publicacao, materializacao ou enforcement devem virar handoff governado para `domain-rules`, nao patch local de formulario;
+- em `mode="view"` sem customizacao, ou quando o host estiver readonly, o assistente opera apenas em `inline-help`, `explain` e `diagnose`; `local-apply` e `manifest-compile` ficam bloqueados.
+
+Essa fronteira preserva a premissa de plataforma: o formulario materializa e explica decisoes governadas, mas nao redefine sozinho a semantica canonica da decisao.
+
 ## Scope and positioning
 
 - Escopo: contrato JSON publico e limites de comportamento observavel.
@@ -107,6 +128,7 @@ Este documento e a referencia canonica da API JSON de praxis-dynamic-form.
 | `api` | not-specified | not-specified | n/a | Declared-only | Declarado no modelo; sem binding operacional direto no runtime atual. |
 | `messages` | not-specified | not-specified | n/a | Partial | Chaves principais de submit/confirmacao usadas; contrato e mais amplo. |
 | `formRules` | not-specified | not-specified | n/a | Active | Aplicadas no pipeline de regras do runtime. |
+| `formCommandRules` | not-specified | not-specified | n/a | Active | Regras condicionais de comando avaliadas sobre `formData` estabilizado depois de `formRules`; primeiro corte suporta `global-action`. |
 | `formRulesState` | not-specified | not-specified | n/a | Active | Persistido para round-trip do builder visual. |
 | `hooks` | not-specified | not-specified | n/a | Active | Integracao de ciclo (before/after) via runtime de hooks. |
 | `hints` | not-specified | not-specified | n/a | Declared-only | Mantido no contrato/editor; sem render dedicado no template principal. |
@@ -155,6 +177,7 @@ Este arquivo foi adaptado para o padrao canonico atual sem remover conteudo tecn
 | `behavior` | Regras de UX/validação/edição | No | deep-merge | Inclui confirmação em dirty, validação reativa e overlays. |
 | `messages` | Mensagens de UX e feedback | No | deep-merge | Fallback para mensagens default quando ausente. |
 | `formRules` | Regras declarativas de runtime | No | replace-array | Aplicadas no pipeline de `rulesService`. |
+| `formCommandRules` | Comandos condicionais governados | No | replace-array | Executa `GlobalActionRef` estruturado depois que valores calculados de `formRules` estabilizam. |
 | `hooks` | Hooks before/after por estágio | No | replace-array per stage | `@Input() hooks` pode sobrescrever `config.hooks`. |
 
 ### Nested configuration blocks
@@ -261,6 +284,39 @@ the canonical remote entity loaded through `resourcePath` and `resourceId`.
 - Em `formRules`, `targets` usam IDs canônicos do alvo. Para ações globais de formulário isso continua sendo o ID lógico da action; para ações de header de seção, o ID canônico é `section:<sectionId>:header-action:<actionLogicalId>`, evitando colisão com actions globais do form e entre seções.
 - Se a seção ainda não tiver `id`, o runtime aceita o fallback `header-action:<actionLogicalId>` por compatibilidade; para contratos persistidos, prefira sempre materializar `section.id`.
 
+### Field rule computed value contract
+
+Regras com `targetType: "field"` podem usar `effect.properties.value` e `effect.propertiesWhenFalse.value` para escrever declarativamente o valor do `FormControl` alvo. O envelope canônico é fechado e exclusivo: exatamente `{ "expression": <JsonLogic> }` para valores calculados ou exatamente `{ "literal": <valor> }` para valores literais estruturados. Primitivos, `null` e arrays continuam aceitos como literais; objetos JSON Logic legados de operador único continuam aceitos para compatibilidade no runtime. O authoring visual e o editor JSON rejeitam objetos literais ambíguos sem envelope, como `{ "startDate": "...", "endDate": "..." }`, e envelopes com chaves extras, como `{ "literal": 1, "expression": { "var": "age" } }`. Valores calculados são resolvidos em uma fase anterior à aplicação das demais propriedades, com iteração limitada até estabilização, para que regras dependentes não fiquem acopladas à ordem do array.
+
+### Conditional command rule contract
+
+Politica de erro do runtime: falhas de `GlobalActionService.executeRef(...)` em comandos condicionais sao fail-closed. Resultado `success: false` ou excecao assincrona gera diagnostico e nao reexecuta em loop enquanto a condicao continuar verdadeira. Quando `GlobalActionService` nao esta disponivel, acoes mutaveis (`api.post`, `api.put`, `api.patch`, `api.delete`) nao caem para `customAction`.
+
+`formCommandRules` separa comandos com side effect das regras de propriedade. A regra é avaliada depois de `formRules` estabilizar `fieldValues`, então casos como `birthDate -> age -> dialog.alert` não dependem da ordem do array. O primeiro corte suporta apenas `effects[].kind: "global-action"` e executa `globalAction` via `GlobalActionService.executeRef(...)`. Por padrão, comandos usam `trigger: "on-condition-enter"` e `runOnInitialEvaluation: false`; `trigger: "while-true"` não executa `global-action` nesta versão. `distinct` usa chave composta por componente, regra, efeito, action, contexto e valor de `distinctBy`, e a memória é limpa quando a condição volta a falso. No editor visual, `payloadExpr` permanece escape hatch de JSON avancado: o editor preserva `payloadExpr` existente quando nenhum payload estruturado e definido, mas campos estruturados authoram `payload` literal.
+
+Exemplo:
+
+```json
+{
+  "formRules": [
+    {
+      "id": "birth-date-computes-age",
+      "targetType": "field",
+      "targets": ["age"],
+      "effect": {
+        "condition": { "!": [{ "isBlank": [{ "var": "birthDate" }] }] },
+        "properties": {
+          "value": { "expression": { "yearsSince": [{ "var": "birthDate" }] } }
+        },
+        "propertiesWhenFalse": {
+          "value": { "literal": null }
+        }
+      }
+    }
+  ]
+}
+```
+
 ### Visual block rule contract
 
 Itens de layout `kind: "richContent"` podem ser alvo de `formRules` com `targetType: "visualBlock"`. O `target` é sempre o `id` do item em `sections[].rows[].columns[].items[]`; o bloco visual não recebe entrada em `fieldMetadata[]`, não cria `FormControl` e não entra em `formSubmit.formData` nem no payload HTTP.