@praxisui/dynamic-form 9.0.0-beta.7 → 9.0.0-beta.71

package/types/praxisui-dynamic-form.d.ts

@@ -7,13 +7,15 @@ 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, JsonLogicExpression, GlobalActionCatalogEntry, PraxisRuntimeConditionalEffectRule, PraxisRuntimeGlobalActionEffect, GlobalActionField, FieldDefinition, ComponentDocMeta, Breakpoint, DomainRuleRequestOptions, DomainRuleService, DomainRuleMaterialization, IconPickerService, GlobalActionRef, SurfaceOpenPayload, AiCapabilityCategory, AiCapabilityCatalog, AiValueKind, ComponentAuthoringManifest } from '@praxisui/core';
+import { AsyncConfigStorage, FormLayout, FieldMetadata, FormLayoutRule, FormRuleTargetType as FormRuleTargetType$1, PraxisJsonLogicService, FormSection, FormRow, FormColumn, FormConfig, FormConfigWithSections, FormLayoutItem, FormActionButton, AiCapability, BackConfig, FormPresentationConfig, RichBlockHostCapabilities, ApiEndpoint, ApiUrlEntry, DynamicFormLayoutPolicy, 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, EnterpriseRuntimeContextService, FormSectionHeaderAction, FormSectionHeaderConfig, FormConfigState, JsonLogicExpression, FormHelpPresentationConfig, GlobalActionCatalogEntry, PraxisRuntimeConditionalEffectRule, PraxisRuntimeGlobalActionEffect, SurfaceOpenPayload, GlobalActionField, PraxisEffectPolicy, FieldDefinition, ComponentDocMeta, Breakpoint, DomainRuleRequestOptions, DomainRuleService, DomainRuleMaterialization, TableConfig, IconPickerService, GlobalActionRef, AiCapabilityCategory, AiCapabilityCatalog, AiValueKind, 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 { RuleBuilderConfig, RuleBuilderState } from '@praxisui/visual-builder';
+import { CascadeManagerTabComponent } from '@praxisui/metadata-editor';
+import * as _praxisui_dynamic_form from '@praxisui/dynamic-form';
 
 declare class FormLayoutService {
     private storage?;
@@ -146,7 +148,7 @@ interface Operation {
     [key: string]: any;
 }
 interface LayoutResult {
-    config: FormConfig;
+    config: FormConfigWithSections;
     op: Operation;
 }
 interface LayoutChange {
@@ -200,16 +202,20 @@ interface InsertLocalFieldResult extends LayoutResult {
     applied: boolean;
     diagnostics: LocalFieldInsertionDiagnostic[];
 }
+type DynamicFormGeneratedLayoutPreset = 'default' | 'compactPresentation';
+interface GenerateFormConfigFromMetadataOptions {
+    fieldsPerRow?: number;
+    defaultSectionTitle?: string;
+    layoutPreset?: DynamicFormGeneratedLayoutPreset;
+    presentationRoleMap?: Record<string, string>;
+}
 declare class DynamicFormLayoutService {
     private readonly changesSubject;
     readonly changes$: rxjs.Observable<LayoutChange>;
     private emit;
-    normalizeConfig(config: FormConfig): FormConfig;
+    normalizeConfig(config: FormConfig): FormConfigWithSections;
     validateConfig(config: FormConfig): ValidationReport;
-    generateFormConfigFromMetadata(fields: FieldMetadata[], options?: {
-        fieldsPerRow?: number;
-        defaultSectionTitle?: string;
-    }): FormConfig;
+    generateFormConfigFromMetadata(fields: FieldMetadata[], options?: GenerateFormConfigFromMetadataOptions): FormConfigWithSections;
     getElementPath(config: FormConfig, element: HTMLElement): CanvasPathPart[];
     updateElement(config: FormConfig, path: CanvasPathPart[], updatedData: any, options?: {
         correlationId?: string;
@@ -218,6 +224,15 @@ declare class DynamicFormLayoutService {
     private resolvePath;
     resolvePathByIds(config: FormConfig, ids: IdPath): FieldPath;
     private createRowsFromFields;
+    private createCompactPresentationRowsFromFields;
+    private resolveCompactPresentationSpan;
+    private inferCompactPresentationSpan;
+    private clampGridSpan;
+    private resolveGroupOrder;
+    private withCompactPresentationFieldDefaults;
+    private resolveFieldPresentationRole;
+    private resolvePresentationRole;
+    private normalizePresentationRole;
     private genId;
     private capitalizeFirstLetter;
     private assertIndex;
@@ -520,16 +535,7 @@ type DynamicFormMode = 'create' | 'edit' | 'view';
 interface DynamicFormBindings {
     mode?: DynamicFormMode;
 }
-interface DynamicFormPresentationSnapshot {
-    labelPosition?: 'above' | 'left';
-    labelFontSize?: number | null;
-    valueFontSize?: number | null;
-    compact?: boolean;
-    density?: 'comfortable' | 'cozy' | 'compact';
-    labelWidth?: number | null;
-    labelAlign?: 'start' | 'center' | 'end';
-    valueAlign?: 'start' | 'center' | 'end';
-}
+type DynamicFormPresentationSnapshot = FormPresentationConfig;
 interface DynamicFormSchemaPrefsSnapshot {
     notifyIfOutdated?: 'inline' | 'snackbar' | 'both' | 'none';
     snoozeMs?: number;
@@ -683,6 +689,7 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     private hooksRegistry?;
     private hookPresets?;
     private logger?;
+    private enterpriseRuntimeContext?;
     private readonly i18n;
     private readonly injector;
     private readonly aiApi;
@@ -697,7 +704,7 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     private effectiveActionsCacheOverride?;
     private invalidRequiredFieldLabelsCache;
     private invalidRequiredFieldLabelsSignature;
-    readonly richContentHostCapabilities: RichBlockHostCapabilities;
+    get richContentHostCapabilities(): RichBlockHostCapabilities;
     resourcePath?: string;
     resourceId?: string | number;
     initialValue?: Record<string, unknown> | null;
@@ -757,6 +764,10 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     configPersistenceStrategy: 'local-first' | 'input-first';
     /** Optional layout to use instead of generated one */
     layout?: FormLayout;
+    /** Metadata-driven layout preset used only when creating an initial config from schema. */
+    generatedLayoutPreset: DynamicFormGeneratedLayoutPreset;
+    /** Opt-in policy for schema-driven transient layout materialization. */
+    layoutPolicy?: DynamicFormLayoutPolicy | null;
     /** Optional navigation back config (from CRUD host) */
     backConfig?: BackConfig;
     /** Optional direct hooks declaration for testing/demo (overrides config.hooks) */
@@ -777,6 +788,7 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     disabledModeGlobal: boolean | null;
     presentationModeGlobal: boolean | null;
     visibleGlobal: boolean | null;
+    fieldIconPolicy: 'all' | 'presentation-only' | 'none';
     /** Opt-in loader for shared domain rule materializations persisted outside FormConfig. */
     domainRules: PraxisDynamicFormDomainRulesOptions | boolean | null;
     get effectivePresentation(): boolean;
@@ -786,6 +798,13 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     get invalidRequiredFieldLabels(): string[];
     /** Value propagated to DynamicFieldLoader; null allows per-field metadata */
     get presentationForLoader(): boolean | null;
+    getRenderableFieldsForLoader(fields: FieldMetadata[]): FieldMetadata[];
+    private materializeFieldPresentationPolicy;
+    private shouldMaterializeBooleanControl;
+    private materializeFieldHelpPolicy;
+    private shouldSuppressFieldIcons;
+    private resolveFieldHelpDisplay;
+    private normalizeFieldHelpControlToken;
     /** Custom endpoints for CRUD operations */
     private _customEndpoints;
     get customEndpoints(): EndpointConfig;
@@ -937,7 +956,8 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     private mountAnimationTimer;
     protected isMounting: boolean;
     private hasBuiltFormFromConfig;
-    constructor(crud: GenericCrudService<any>, http: HttpClient, fb: FormBuilder, cdr: ChangeDetectorRef, layoutService: FormLayoutService, contextService: FormContextService, rulesService: FormRulesService, settingsPanel: SettingsPanelService, dialog: MatDialog, asyncConfigStorage: AsyncConfigStorage, connectionStorage: ConnectionStorage, dynamicForm: DynamicFormService, snackBar: MatSnackBar, canvasState: CanvasStateService, dynamicLayout: DynamicFormLayoutService, errorMessages: ErrorMessageService, schemaNormalizer: SchemaNormalizerService, componentMetaRegistry: ComponentMetadataRegistry, global: GlobalConfigService, componentKeys: ComponentKeyService, loadingOrchestrator: LoadingOrchestrator, ngZone: NgZone, apiUrlConfig: ApiUrlConfig, loadingRenderer?: PraxisLoadingRenderer | undefined, router?: Router | undefined, route?: ActivatedRoute | undefined, hooksRegistry?: FormHooksRegistry | undefined, hookPresets?: FormHookPreset[] | null | undefined, logger?: LoggerService | undefined);
+    private runtimeFieldMetadata;
+    constructor(crud: GenericCrudService<any>, http: HttpClient, fb: FormBuilder, cdr: ChangeDetectorRef, layoutService: FormLayoutService, contextService: FormContextService, rulesService: FormRulesService, settingsPanel: SettingsPanelService, dialog: MatDialog, asyncConfigStorage: AsyncConfigStorage, connectionStorage: ConnectionStorage, dynamicForm: DynamicFormService, snackBar: MatSnackBar, canvasState: CanvasStateService, dynamicLayout: DynamicFormLayoutService, errorMessages: ErrorMessageService, schemaNormalizer: SchemaNormalizerService, componentMetaRegistry: ComponentMetadataRegistry, global: GlobalConfigService, componentKeys: ComponentKeyService, loadingOrchestrator: LoadingOrchestrator, ngZone: NgZone, apiUrlConfig: ApiUrlConfig, loadingRenderer?: PraxisLoadingRenderer | undefined, router?: Router | undefined, route?: ActivatedRoute | undefined, hooksRegistry?: FormHooksRegistry | undefined, hookPresets?: FormHookPreset[] | null | undefined, logger?: LoggerService | undefined, enterpriseRuntimeContext?: EnterpriseRuntimeContextService | undefined);
     private emitLoadingState;
     private buildLoadingContext;
     private beginLoading;
@@ -964,9 +984,9 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     private formInputsKey;
     private crudBackKey;
     private tryInitializeForm;
-    private hasExplicitSchemaUrl;
+    hasExplicitSchemaUrl(): boolean;
     private hasSchemaBackedRuntime;
-    private hasRenderableConfig;
+    hasRenderableConfig(config?: FormConfig | null | undefined): boolean;
     private initializeStandaloneConfig;
     private initializeDisconnectedEmptyState;
     private reloadForModeChange;
@@ -981,10 +1001,16 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     private persistFormConfig;
     private createDefaultConfig;
     private createConfigFromHostConfig;
+    private shouldUseSchemaLayoutPolicy;
+    private layoutPolicyRequestsPresentation;
+    private shouldPersistGeneratedConfig;
+    private createSchemaMaterializedConfig;
     private reconcileLoadedConfigWithServerSchema;
     private hostConfigHasAuthoredLocalFieldsNotInLocalConfig;
     private syncWithServer;
     private loadEntity;
+    private hydrateEntityFromInitialValue;
+    private flushEntityHydrationState;
     private buildFormFromConfig;
     private resetFormValueChangesSubscription;
     private resetDependencyPolicySubscription;
@@ -997,6 +1023,10 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     private setEntityLookupDependencyConflict;
     private clearEntityLookupDependencyConflict;
     private resolveEntityLookupDependencyValidationMessage;
+    private getRuntimeFieldMetadata;
+    private resolveFieldAccessAuthorities;
+    private normalizeAuthorityClaims;
+    private materializeFieldAccessState;
     private scheduleValueChangeBootstrapRelease;
     private hasInteractiveFormState;
     private captureFormRuntimeState;
@@ -1112,6 +1142,7 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
         items?: FormLayoutItem[];
         id?: string;
     }): FieldMetadata[];
+    private isFieldRenderableInLayout;
     getRichContentLayoutItemDocument(item: FormLayoutItem): RichContentDocument | null;
     getRichContentLayoutItemLayout(item: FormLayoutItem): 'block' | 'inline';
     private getVisualBlockRuleProps;
@@ -1136,6 +1167,7 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     private _showConfirmationDialog;
     onFormAction(event: PraxisFormActionEvent): void;
     private dispatchRichContentAction;
+    private emitRichContentCustomAction;
     private isRichContentActionAvailable;
     private hasRichContentCapability;
     private buildRichContentActionContext;
@@ -1337,8 +1369,8 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     private logRowGapsSnapshot;
     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; }; "readUrl": { "alias": "readUrl"; "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; }; "showAiAssistant": { "alias": "showAiAssistant"; "required": false; }; "formId": { "alias": "formId"; "required": false; }; "componentInstanceId": { "alias": "componentInstanceId"; "required": false; }; "configPersistenceStrategy": { "alias": "configPersistenceStrategy"; "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"; "configPatchChange": "configPatchChange"; "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>;
+    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; }, { 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; }; "readUrl": { "alias": "readUrl"; "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; }; "showAiAssistant": { "alias": "showAiAssistant"; "required": false; }; "formId": { "alias": "formId"; "required": false; }; "componentInstanceId": { "alias": "componentInstanceId"; "required": false; }; "configPersistenceStrategy": { "alias": "configPersistenceStrategy"; "required": false; }; "layout": { "alias": "layout"; "required": false; }; "generatedLayoutPreset": { "alias": "generatedLayoutPreset"; "required": false; }; "layoutPolicy": { "alias": "layoutPolicy"; "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; }; "fieldIconPolicy": { "alias": "fieldIconPolicy"; "required": false; }; "domainRules": { "alias": "domainRules"; "required": false; }; "customEndpoints": { "alias": "customEndpoints"; "required": false; }; }, { "formSubmit": "formSubmit"; "formCancel": "formCancel"; "formReset": "formReset"; "configChange": "configChange"; "configPatchChange": "configPatchChange"; "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 {
@@ -1393,6 +1425,7 @@ declare class JsonConfigEditorComponent implements OnInit, OnDestroy {
     diagnostics: EditorDiagnostic[];
     private destroy$;
     private jsonTextChanges$;
+    private readonly i18n;
     constructor(cdr: ChangeDetectorRef, configService: FormConfigService);
     ngOnInit(): void;
     ngOnDestroy(): void;
@@ -1412,6 +1445,9 @@ declare class JsonConfigEditorComponent implements OnInit, OnDestroy {
     private updateValidationState;
     insertHooksTemplate(): void;
     enableReactiveValidation(): void;
+    tx(key: string, fallback: string, params?: Record<string, string | number | boolean | null | undefined>): string;
+    private resolveI18n;
+    private interpolateFallback;
     static ɵfac: i0.ɵɵFactoryDeclaration<JsonConfigEditorComponent, never>;
     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>;
 }
@@ -1448,6 +1484,12 @@ interface FormRuleDiagnostics {
     runtimeOnlyReason?: string;
 }
 
+type ConfigEditorTabKey = 'general' | 'schema' | 'layout' | 'hooks' | 'presentation' | 'behavior' | 'hints' | 'actions' | 'rules' | 'cascades' | 'messages' | 'navigation' | 'json';
+interface ConfigEditorTabOption {
+    key: ConfigEditorTabKey;
+    index: number;
+    label: string;
+}
 interface CommandRulePreviewModel {
     state: 'ready' | 'invalid';
     executionMode: 'preview-only';
@@ -1456,11 +1498,11 @@ interface CommandRulePreviewModel {
     payload?: unknown;
     payloadExpr?: string;
     policy: {
-        trigger: 'on-condition-enter';
+        trigger: NonNullable<PraxisEffectPolicy['trigger']>;
         distinct: boolean;
         distinctBy?: string;
         runOnInitialEvaluation?: boolean;
-    };
+    } & Omit<PraxisEffectPolicy, 'trigger' | 'distinct' | 'distinctBy' | 'runOnInitialEvaluation'>;
     diagnostics: string[];
 }
 declare class PraxisDynamicFormConfigEditor implements SettingsValueProvider, OnInit, OnDestroy {
@@ -1469,10 +1511,12 @@ declare class PraxisDynamicFormConfigEditor implements SettingsValueProvider, On
     private settingsPanel;
     private cdr;
     jsonEditor?: JsonConfigEditorComponent;
+    cascadeManager?: CascadeManagerTabComponent;
     editedConfig: FormConfig;
     ruleBuilderConfig: RuleBuilderConfig;
     ruleBuilderState?: RuleBuilderState;
     currentRules: FormLayoutRule[];
+    selectedConfigTabIndex: number;
     selectedCommandRuleId: string;
     commandRuleCondition: JsonLogicExpression | null;
     commandRuleConditionJson: string;
@@ -1482,6 +1526,8 @@ declare class PraxisDynamicFormConfigEditor implements SettingsValueProvider, On
     commandRuleDistinct: boolean;
     commandRuleDistinctBy: string;
     commandRuleRunOnInitialEvaluation: boolean;
+    private commandRulePolicyTrigger;
+    private commandRuleAdvancedPolicy;
     commandRuleAuthoringError: string | null;
     commandRulePayloadFieldErrors: Record<string, string>;
     ruleDiagnostics: FormRuleDiagnostics[];
@@ -1507,10 +1553,10 @@ declare class PraxisDynamicFormConfigEditor implements SettingsValueProvider, On
     private readonly editorMode;
     isPresentationMode: boolean;
     truncatePreview: boolean;
-    previewItems: {
+    previewItems: Array<{
         label: string;
         value: string;
-    }[];
+    }>;
     presentationPrefs: {
         labelPosition: 'above' | 'left';
         labelFontSize?: number | null;
@@ -1523,6 +1569,12 @@ declare class PraxisDynamicFormConfigEditor implements SettingsValueProvider, On
     };
     /** Ensure hints object exists (normalized upstream) */
     private ensureHints;
+    get helpPresentationDraft(): Required<FormHelpPresentationConfig>;
+    onHelpPresentationDisplayChange(display: FormHelpPresentationConfig['display']): void;
+    onHelpPresentationInlineMaxLengthChange(inlineMaxLength: number | string | null): void;
+    private updateHelpPresentation;
+    getHelpPreferPopoverControlsText(): string;
+    onHelpPreferPopoverControlsChange(value: string): void;
     schemaPrefs: {
         notifyIfOutdated: 'inline' | 'snackbar' | 'both' | 'none';
         snoozeMs: number;
@@ -1538,13 +1590,19 @@ declare class PraxisDynamicFormConfigEditor implements SettingsValueProvider, On
     private hasProcessedInitialRuleState;
     private jsonEditorIsValid;
     private globalActionValidationIssues;
+    private readonly i18n;
     readonly globalActionCatalog: GlobalActionCatalogEntry[];
     isDirty$: BehaviorSubject<boolean>;
     isValid$: BehaviorSubject<boolean>;
     isBusy$: BehaviorSubject<boolean>;
     private lastRulesSignature;
+    private pendingRulePropertiesStateSignature;
     private readonly DEBUG;
     private debugLog;
+    get configTabOptions(): ConfigEditorTabOption[];
+    configTabLabel(key: ConfigEditorTabKey): string;
+    private buildPresentationPreviewItems;
+    getConfigTabIndex(key: ConfigEditorTabKey): number;
     constructor(storage: AsyncConfigStorage, configService: FormConfigService, settingsPanel: SettingsPanelService, cdr: ChangeDetectorRef, globalActionCatalogSource?: ReadonlyArray<GlobalActionCatalogEntry[]>, injectedData?: any);
     ngOnInit(): void;
     reset(): void;
@@ -1571,6 +1629,7 @@ declare class PraxisDynamicFormConfigEditor implements SettingsValueProvider, On
     applyCommandRule(): void;
     deleteCommandRule(): void;
     get commandRuleActionSchema(): _praxisui_core.GlobalActionUiSchema | undefined;
+    get commandRuleSurfaceOpenPayload(): SurfaceOpenPayload;
     shouldShowCommandActionField(field: GlobalActionField): boolean;
     isCommandActionFieldRequired(field: GlobalActionField): boolean;
     isCommandActionFieldMissing(field: GlobalActionField): boolean;
@@ -1579,12 +1638,15 @@ declare class PraxisDynamicFormConfigEditor implements SettingsValueProvider, On
     get commandRulePreview(): CommandRulePreviewModel;
     getCommandActionFieldValue(field: GlobalActionField): any;
     onCommandActionFieldChange(field: GlobalActionField, value: any): void;
+    onCommandSurfaceOpenPayloadChange(payload: SurfaceOpenPayload): void;
     private initializeCommandRuleEditor;
     private loadCommandRuleEditor;
+    private buildCommandRulePolicy;
     private updateCommandRules;
     private parseCommandRuleCondition;
     private parseOptionalJson;
     private parseCommandPayloadObject;
+    private getCommandRuleErrorMessage;
     private collectCommandActionFieldValues;
     private setCommandActionFieldError;
     private clearCommandActionFieldError;
@@ -1596,6 +1658,8 @@ declare class PraxisDynamicFormConfigEditor implements SettingsValueProvider, On
     getRuleStatusTone(diagnostic: FormRuleDiagnostics): 'ok' | 'warn' | 'error';
     canAcceptPendingLlmRule(diagnostic: FormRuleDiagnostics): boolean;
     canApplyRulePropertyFix(diagnostic: FormRuleDiagnostics): boolean;
+    canOpenRuleJsonReview(diagnostic: FormRuleDiagnostics): boolean;
+    openRuleJsonReview(ruleId: string): void;
     applyRulePropertyFix(ruleId: string): void;
     acceptPendingLlmRule(ruleId: string): void;
     getRuleDiagnosticDetails(diagnostic: FormRuleDiagnostics): string[];
@@ -1628,6 +1692,7 @@ declare class PraxisDynamicFormConfigEditor implements SettingsValueProvider, On
     onLayoutSelect(event: any): void;
     private openColumnEditor;
     onCascadeApply(patch: Record<string, Partial<FieldDefinition>>): void;
+    private syncCascadeManagerFields;
     private stripLegacy;
     private computeRulesSignature;
     restoreHintsDefaults(): void;
@@ -1641,6 +1706,9 @@ declare class PraxisDynamicFormConfigEditor implements SettingsValueProvider, On
     private toPresentationSnapshot;
     private toSchemaPrefsSnapshot;
     private toBackConfigSnapshot;
+    tx(key: string, fallback: string, params?: Record<string, string | number | boolean | null | undefined>): string;
+    private resolveI18n;
+    private interpolateFallback;
     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>;
 }
@@ -1829,6 +1897,7 @@ declare class LayoutEditorComponent implements OnInit {
     chromeToggles: string[];
     get borderEnabled(): boolean;
     get dividerEnabled(): boolean;
+    get layoutSections(): FormSection[];
     canApplyAll(): boolean;
     applyGapToAll(): void;
     ngOnInit(): void;
@@ -1953,6 +2022,7 @@ declare class RowConfiguratorComponent implements OnChanges {
     activeDropIndex: number | null;
     protected readonly visualBlockPresets: readonly VisualBlockPreset[];
     private readonly i18n;
+    private readonly dialog;
     private hoverTimer;
     protected readonly breakpoints: Breakpoint[];
     previewBreakpoint: Breakpoint;
@@ -2105,6 +2175,50 @@ declare class DomainRuleFormRulesService {
     static ɵprov: i0.ɵɵInjectableDeclaration<DomainRuleFormRulesService>;
 }
 
+declare class Ergadm00034CompactPresentationExampleComponent {
+    private readonly dynamicLayout;
+    readonly legacyFrequencyExample: _praxisui_dynamic_form.Ergadm00034CompactPresentationExample;
+    readonly legacyFrequencyPresentationConfig: _praxisui_core.FormConfig;
+    readonly legacyFrequencyInitialValue: Record<string, unknown>;
+    readonly legacyFrequencyRows: readonly _praxisui_dynamic_form.Ergadm00034LegacyFrequencyRow[];
+    readonly corporatePresentationExample: _praxisui_dynamic_form.CorporatePresentationExample;
+    readonly corporatePresentationConfig: _praxisui_core.FormConfig;
+    readonly corporatePresentationInitialValue: Record<string, unknown>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<Ergadm00034CompactPresentationExampleComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<Ergadm00034CompactPresentationExampleComponent, "praxis-ergadm00034-compact-presentation-example", never, {}, {}, never, never, true, never>;
+}
+
+interface Ergadm00034LegacyFrequencyRow {
+    tipo: string;
+    codigo: string;
+    nome: string;
+    preenchimento: string;
+    marcador: string;
+    selected?: boolean;
+}
+interface Ergadm00034CompactPresentationExample {
+    readonly id: 'ergadm00034-compact-presentation';
+    readonly title: string;
+    readonly resourcePath: string;
+    readonly layoutPreset: 'compactPresentation';
+    readonly rows: readonly Ergadm00034LegacyFrequencyRow[];
+    readonly tableConfig: TableConfig;
+    readonly metadata: readonly FieldMetadata[];
+    readonly initialValue: Record<string, unknown>;
+}
+interface CorporatePresentationExample {
+    readonly id: 'corporate-presentation-format-gallery';
+    readonly title: string;
+    readonly resourcePath: string;
+    readonly layoutPreset: 'compactPresentation';
+    readonly metadata: readonly FieldMetadata[];
+    readonly initialValue: Record<string, unknown>;
+}
+declare const ERGADM00034_COMPACT_PRESENTATION_EXAMPLE: Ergadm00034CompactPresentationExample;
+declare const CORPORATE_PRESENTATION_FORMAT_GALLERY: CorporatePresentationExample;
+declare function buildErgadm00034CompactPresentationConfig(layoutService: DynamicFormLayoutService): FormConfig;
+declare function buildCorporatePresentationFormatGalleryConfig(layoutService: DynamicFormLayoutService): FormConfig;
+
 declare function isRuleSatisfied(rule: FormLayoutRule, data: unknown): boolean;
 /**
  * Applies all visibility rules to the provided data and
@@ -2171,6 +2285,7 @@ declare class CanvasToolbarComponent {
     /** Estado interno para animar o fechamento. */
     closing: boolean;
     private readonly closeAnimMs;
+    private readonly i18n;
     toggleReadonly: EventEmitter<void>;
     toggleRequired: EventEmitter<void>;
     toggleHidden: EventEmitter<void>;
@@ -2188,6 +2303,7 @@ declare class CanvasToolbarComponent {
     onGlobalKeydown(ev: KeyboardEvent): void;
     /** Inicia animação de saída e emite o evento ao final. */
     triggerClose(): void;
+    tx(key: string, fallback: string, params?: Record<string, string | number>): string;
     static ɵfac: i0.ɵɵFactoryDeclaration<CanvasToolbarComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<CanvasToolbarComponent, "praxis-canvas-toolbar", never, { "selectedElement": { "alias": "selectedElement"; "required": false; }; }, { "editMetadata": "editMetadata"; "delete": "delete"; "moveUp": "moveUp"; "moveDown": "moveDown"; "selectPath": "selectPath"; "requestClose": "requestClose"; "toggleReadonly": "toggleReadonly"; "toggleRequired": "toggleRequired"; "toggleHidden": "toggleHidden"; "toggleDisabled": "toggleDisabled"; }, never, never, true, never>;
 }
@@ -2345,6 +2461,7 @@ declare class RowEditorComponent implements OnInit, OnDestroy, SettingsValueProv
     isBusy$: BehaviorSubject<boolean>;
     private destroy$;
     private initialValueSig;
+    private readonly i18n;
     constructor(fb: FormBuilder, data: {
         row: EditableFormRow;
     });
@@ -2353,10 +2470,12 @@ declare class RowEditorComponent implements OnInit, OnDestroy, SettingsValueProv
     getSettingsValue(): any;
     displayValue(value: number | null | undefined, fallback: string): string | number;
     displayPxValue(value: number | null | undefined): string;
+    visibilityStateLabel(bp: Breakpoint): string;
     private setColumns;
     applyPreset(preset: 'full' | 'half' | 'thirds' | 'thirdTwoThird' | 'twoThirdThird' | 'autoBalance'): void;
     private resolveHiddenMode;
     setHiddenMode(mode: 'none' | 'mobile' | 'desktop'): void;
+    tx(key: string, fallback: string, params?: Record<string, string | number>): string;
     static ɵfac: i0.ɵɵFactoryDeclaration<RowEditorComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<RowEditorComponent, "praxis-row-editor", never, {}, {}, never, never, true, never>;
 }
@@ -2373,6 +2492,7 @@ declare class ColumnEditorComponent implements OnInit, OnDestroy, SettingsValueP
     isBusy$: BehaviorSubject<boolean>;
     private destroy$;
     private _previewTimer;
+    private readonly i18n;
     constructor(fb: FormBuilder, data: {
         column: FormColumn;
     });
@@ -2396,6 +2516,7 @@ declare class ColumnEditorComponent implements OnInit, OnDestroy, SettingsValueP
     resetResponsive(): void;
     applyPreset(key: 'full' | 'half' | 'third' | 'twoThird' | 'centered' | 'narrowSidebar' | 'wideContent' | 'stackMobile' | 'hideMobile' | 'desktopOnly'): void;
     toggleHiddenBp(bp: Breakpoint): void;
+    tx(key: string, fallback: string, params?: Record<string, string | number>): string;
     static ɵfac: i0.ɵɵFactoryDeclaration<ColumnEditorComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<ColumnEditorComponent, "praxis-column-editor", never, {}, {}, never, never, true, never>;
 }
@@ -2634,5 +2755,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, 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, DynamicFormConfigPatchChangeEvent, 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 };
+export { ActionsEditorComponent, CORPORATE_PRESENTATION_FORMAT_GALLERY, CanvasStateService, CanvasToolbarComponent, ColumnEditorComponent, DomainRuleFormRulesService, DynamicFormLayoutService, ERGADM00034_COMPACT_PRESENTATION_EXAMPLE, Ergadm00034CompactPresentationExampleComponent, 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, buildCorporatePresentationFormatGalleryConfig, buildDynamicFormApplyPlan, buildDynamicFormRuleAuthoringContext, buildErgadm00034CompactPresentationConfig, 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, CorporatePresentationExample, DomainRuleFormRulesRequestOptions, DomainRuleMaterializedFormLayoutRule, DynamicFieldRenderErrorEvent, DynamicFormAllowedRuleProperties, DynamicFormApplyPlan, DynamicFormAuthoringDocument, DynamicFormBindings, DynamicFormConfigPatchChangeEvent, DynamicFormContextSnapshot, DynamicFormGeneratedLayoutPreset, DynamicFormMode, DynamicFormPresentationSnapshot, DynamicFormProjectionContext, DynamicFormResolvedRuntimeContract, DynamicFormRuleAuthoringContext, DynamicFormRuleAuthoringField, DynamicFormRuleAuthoringTarget, DynamicFormRuleAuthoringTargetDetails, DynamicFormRuleAuthoringTargets, DynamicFormRuleAuthoringVisualBlockNode, DynamicFormRuleTargetType, DynamicFormRuntimeContext, DynamicFormRuntimeValueSource, DynamicFormSchemaPrefsSnapshot, DynamicFormValidationContext, EditorDiagnostic, EditorDocument, Ergadm00034CompactPresentationExample, Ergadm00034LegacyFrequencyRow, FieldPath, FieldPathContainer, FieldPathWithIndex, Capability as FormComponentCapability, CapabilityCatalog as FormComponentCapabilityCatalog, CapabilityCategory as FormComponentCapabilityCategory, ValueKind as FormComponentValueKind, FormConfigLike, GenerateFormConfigFromMetadataOptions, 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 };