@acorex/platform 21.0.0-next.7 → 21.0.0-next.71

package/{layout/builder/index.d.ts → types/acorex-platform-layout-builder.d.ts}

@@ -3,13 +3,30 @@ import { OnInit, EventEmitter } from '@angular/core';
 import * as i1 from '@angular/common';
 import { AXFormComponent } from '@acorex/components/form';
 import { AXValidationSummary } from '@acorex/core/validation';
-import { AXPWidgetNode, AXPWidgetRenderMode, AXPWidgetCoreContextChangeEvent, AXPWidgetContainerComponent, AXPWidgetCoreElementAction } from '@acorex/platform/layout/widget-core';
-import { AXDataSource } from '@acorex/cdk/common';
+import { AXPWidgetNode, AXPWidgetRenderMode, AXPWidgetContainerComponent, AXPWidgetCoreElementAction } from '@acorex/platform/layout/widget-core';
+import { AXDataSource, AXComponentClosing } from '@acorex/cdk/common';
 import { AXPopupSizeType } from '@acorex/components/popup';
 import { AXStepWizardLook } from '@acorex/components/step-wizard';
-import { AXPGridLayoutOptions, AXPExpression, AXPValidationRules, AXPOptionsData, AXPActionMenuItem } from '@acorex/platform/core';
+import { AXPActionMenuItem, AXPMultiLanguageString, AXPMetaData, AXPGridLayoutOptions, AXPExpression, AXPValidationRules, AXPOptionsData, AXPContextChangeEvent, AXPExecuteCommandResult } from '@acorex/platform/core';
 import { AXBasePageComponent } from '@acorex/components/page';
+import { AXPCommand } from '@acorex/platform/runtime';
+
+type AXPDialogActionShortcut = string;
+declare const DEFAULT_CANCEL_DIALOG_ACTION_SHORTCUTS: readonly AXPDialogActionShortcut[];
+declare const DEFAULT_SUBMIT_DIALOG_ACTION_SHORTCUTS: readonly AXPDialogActionShortcut[];
+interface AXPDialogActionOptions {
+    /**
+     * Additional keyboard shortcuts for this action (e.g. `'ctrl+s'`).
+     * Merged with built-in defaults for `cancel` / `submit`. Pass `[]` to disable all shortcuts.
+     */
+    shortcuts?: AXPDialogActionShortcut[];
+}
 
+/**
+ * Extended widget node properties (excluding type, path, name, options, children)
+ * These properties can be passed as a third parameter to customWidget method
+ */
+type AXPWidgetNodeExtendedProperties = Omit<AXPWidgetNode, 'type' | 'path' | 'name' | 'options'>;
 /**
  * Form appearance and density styling (using fieldset widget look)
  */
@@ -24,9 +41,9 @@ type AXPDynamicFormMode = 'view' | 'edit';
 type AXPDynamicFormDirection = 'vertical' | 'horizontal' | 'grid';
 interface AXPDynamicFormFieldDefinition {
     path: string;
-    title?: string;
+    title?: AXPMultiLanguageString;
     badge?: string;
-    description?: string;
+    description?: AXPMultiLanguageString;
     widget: AXPWidgetNode;
     /**
      * Optional per-field rendering mode. Takes precedence over section and form modes.
@@ -36,8 +53,8 @@ interface AXPDynamicFormFieldDefinition {
 }
 interface AXPDynamicFormGroupDefinition {
     name: string;
-    title?: string;
-    description?: string;
+    title?: AXPMultiLanguageString;
+    description?: AXPMultiLanguageString;
     parameters: AXPDynamicFormFieldDefinition[];
     /**
      * Optional per-section rendering mode. Takes precedence over form mode and is overridden by field mode.
@@ -59,7 +76,7 @@ interface AXPDialogRef {
     /**
      * Manually close the dialog (optional - dialog closes automatically after user interaction)
      */
-    close(): void;
+    close(result?: any): void;
     /**
      * Get the form data from the dialog
      */
@@ -72,7 +89,20 @@ interface AXPDialogRef {
      * Set the loading state of the dialog
      */
     setLoading(loading: boolean): void;
+    /**
+     * Deep-merge partial values into the dialog layout context (e.g. after create returns an id).
+     */
+    patchContext?(partial: Record<string, unknown>): void;
+    /**
+     * Invoke a registered widget's public `api()` method (e.g. step-wizard `next`).
+     */
+    invokeWidget?(widgetName: string, method: string, options?: {
+        setLoading?: (loading: boolean) => void;
+        close?: (result?: any) => void;
+    }): Promise<void>;
 }
+/** Fallback {@link AXPDialogRef} when the popup is dismissed without a footer action (e.g. header close). */
+declare function createDismissedDialogRef(context?: () => unknown): AXPDialogRef;
 interface LayoutWidgetOptions {
     name?: string;
 }
@@ -82,7 +112,7 @@ interface ValueWidgetOptions extends LayoutWidgetOptions {
     validations?: AXPValidationRules;
 }
 interface TextBoxOptions extends ValueWidgetOptions {
-    placeholder?: string;
+    placeholder?: AXPMultiLanguageString;
     maxLength?: number;
     minLength?: number;
     prefix?: string;
@@ -93,14 +123,14 @@ interface NumberBoxOptions extends ValueWidgetOptions {
     min?: number;
     max?: number;
     step?: number;
-    placeholder?: string;
+    placeholder?: AXPMultiLanguageString;
     format?: string;
 }
 interface SelectBoxOptions extends ValueWidgetOptions {
     dataSource: any[] | (() => any[]) | (() => Promise<any[]>) | AXDataSource<any>;
     valueField?: string;
     textField?: string;
-    placeholder?: string;
+    placeholder?: AXPMultiLanguageString;
     multiple?: boolean;
     searchable?: boolean;
     clearButton?: boolean;
@@ -111,7 +141,7 @@ interface DateTimeBoxOptions extends ValueWidgetOptions {
     format?: string;
     min?: Date | string;
     max?: Date | string;
-    placeholder?: string;
+    placeholder?: AXPMultiLanguageString;
     clearButton?: boolean;
 }
 interface ToggleSwitchOptions extends ValueWidgetOptions {
@@ -123,7 +153,7 @@ interface LargeTextBoxOptions extends ValueWidgetOptions {
     rows?: number;
     maxLength?: number;
     minLength?: number;
-    placeholder?: string;
+    placeholder?: AXPMultiLanguageString;
     resizable?: boolean;
 }
 interface ColorBoxOptions extends ValueWidgetOptions {
@@ -222,12 +252,26 @@ interface AXPFieldsetContainerOptions extends LayoutWidgetOptions {
     isOpen?: boolean;
     look?: 'fieldset' | 'card' | 'group' | 'container';
     disabled?: boolean;
+    showTitle?: boolean;
     showHeader?: boolean;
     cols?: number;
 }
+/** How optional `hint` text is rendered in `form-field` layout widgets. */
+type AXPFormFieldHintDisplayMode = 'icon' | 'note';
 interface AXPFormFieldOptions extends LayoutWidgetOptions {
     label?: string;
     showLabel?: boolean;
+    /** Translated/helper copy; pairing with {@link hintDisplayMode}. */
+    hint?: AXPMultiLanguageString;
+    hintDisplayMode?: AXPFormFieldHintDisplayMode;
+}
+interface AXPDialogCloseConfirmationOptions {
+    /** When false, dirty-close confirmation is disabled even if the builder flag is set. */
+    enabled?: boolean;
+    title?: AXPMultiLanguageString;
+    message?: AXPMultiLanguageString;
+    /** Custom dirty check; defaults to user-origin context paths plus composite widget `api().isDirty()`. */
+    isDirty?: (context: Record<string, unknown>, baseline: Record<string, unknown>) => boolean;
 }
 interface AXPDialogContainerOptions extends LayoutWidgetOptions {
     title?: string;
@@ -235,14 +279,41 @@ interface AXPDialogContainerOptions extends LayoutWidgetOptions {
     size?: AXPopupSizeType;
     closeButton?: boolean;
     context?: any;
+    metadata?: AXPMetaData;
+    /**
+     * When enabled, prompts before dismiss (cancel, Esc, header close) if dialog context is dirty.
+     * Set via {@link IDialogBuilder.confirmCloseWhenDirty}.
+     */
+    confirmCloseWhenDirty?: boolean | AXPDialogCloseConfirmationOptions;
+    /**
+     * When set, invoked on footer action with {@link AXPDialogRef}.
+     * Set via {@link IDialogBuilder.onAction}.
+     */
+    onAction?: (dialogRef: AXPDialogRef) => unknown | Promise<unknown>;
+}
+/**
+ * Popup payload for `AXPDialogRendererComponent` (`data.config`) and the `layout-builder.dialog.config` hook.
+ */
+interface AXPLayoutBuilderDialogConfig {
+    title: string;
+    context: Record<string, unknown>;
+    definition: AXPWidgetNode;
+    metadata?: AXPMetaData;
+    actions: NonNullable<DialogBuilderState['actions']>;
+    onAction?: (dialogRef: AXPDialogRef) => unknown | Promise<unknown>;
+    confirmCloseWhenDirty?: AXPDialogCloseConfirmationOptions;
 }
 interface RichTextOptions extends ValueWidgetOptions {
-    placeholder?: string;
+    placeholder?: AXPMultiLanguageString;
     toolbar?: string[];
     readonly?: boolean;
+    /** Max height (px) for scrollable full preview when `showFullContent` is true. */
+    height?: number;
+    /** When true, view mode renders full HTML in a scrollable area instead of a truncated snippet. */
+    showFullContent?: boolean;
 }
 interface PasswordBoxOptions extends ValueWidgetOptions {
-    placeholder?: string;
+    placeholder?: AXPMultiLanguageString;
     revealToggle?: boolean;
     maxLength?: number;
 }
@@ -264,7 +335,7 @@ interface SelectionListOptions extends ValueWidgetOptions {
     textField?: string;
     multiple?: boolean;
     searchable?: boolean;
-    placeholder?: string;
+    placeholder?: AXPMultiLanguageString;
 }
 interface AXPListWidgetColumn {
     name: string;
@@ -384,26 +455,31 @@ interface AXPWidgetConfiguration {
     options?: AXPOptionsData;
 }
 type LayoutBuilderState = AXPWidgetNode;
-type WidgetBuilderState = Omit<AXPWidgetNode, 'children'> & {
+type WidgetBuilderState = AXPWidgetNode & {
     layout?: AXPGridLayoutOptions;
 };
 type FormFieldBuilderState = AXPWidgetNode & {
     layout?: AXPGridLayoutOptions;
 };
+/** Dialog footer action item; extends menu actions with placement and keyboard shortcuts. */
+type AXPDialogActionMenuItem = AXPActionMenuItem & {
+    position?: 'prefix' | 'suffix';
+    shortcuts?: AXPDialogActionShortcut[];
+};
 type DialogBuilderState = AXPWidgetNode & {
     layout?: AXPGridLayoutOptions;
     dialogOptions?: AXPDialogContainerOptions;
     actions?: {
         footer?: {
-            prefix?: AXPActionMenuItem[];
-            suffix?: AXPActionMenuItem[];
+            prefix?: AXPDialogActionMenuItem[];
+            suffix?: AXPDialogActionMenuItem[];
         };
     };
 };
 interface IActionBuilder {
-    cancel(text?: string): IActionBuilder;
-    submit(text?: string): IActionBuilder;
-    custom(action: AXPActionMenuItem): IActionBuilder;
+    cancel(text?: string, options?: AXPDialogActionOptions): IActionBuilder;
+    submit(text?: string, options?: AXPDialogActionOptions): IActionBuilder;
+    custom(action: AXPDialogActionMenuItem, options?: AXPDialogActionOptions): IActionBuilder;
 }
 interface ILayoutBuilder {
     grid(delegate: (container: IGridContainerBuilder) => void): ILayoutBuilder;
@@ -412,7 +488,7 @@ interface ILayoutBuilder {
     page(delegate: (container: IPageContainerBuilder) => void): ILayoutBuilder;
     tabset(delegate: (container: ITabsetContainerBuilder) => void): ILayoutBuilder;
     fieldset(delegate: (container: IFieldsetContainerBuilder) => void): ILayoutBuilder;
-    dialog(delegate: (container: IDialogBuilder) => void): IDialogBuilder;
+    dialog<T = AXPDialogRef>(delegate: (container: IDialogBuilder<T>) => void): IDialogBuilder<T>;
     stepWizard(delegate: (wizard: IStepWizardBuilder) => void): ILayoutBuilder;
     build(): AXPWidgetNode;
     toJson(options?: {
@@ -503,6 +579,8 @@ interface IGridContainerBuilder extends IBaseContainerBuilder<IGridContainerBuil
     setBackgroundColor(color: string): IGridContainerBuilder;
     setPadding(padding: string): IGridContainerBuilder;
     setMargin(margin: string): IGridContainerBuilder;
+    /** Add a grid-item-layout child with optional placement; delegate builds the fieldset content. */
+    item(layoutOptions: Partial<AXPGridLayoutOptions> | null | undefined, delegate: (container: IFieldsetContainerBuilder) => void): IGridContainerBuilder;
 }
 interface IPanelContainerBuilder extends IBaseContainerBuilder<IPanelContainerBuilder>, ILayoutContainerBuilder<IPanelContainerBuilder>, IChildContainerBuilder<IPanelContainerBuilder>, IWidgetContainerBuilder<IPanelContainerBuilder> {
     setOptions(options: AXPPanelContainerOptions): IPanelContainerBuilder;
@@ -545,6 +623,7 @@ interface IFormFieldBuilder extends IBaseContainerBuilder<IFormFieldBuilder>, IL
     toggleSwitch(options?: Omit<ToggleSwitchOptions, 'path'>): IFormFieldBuilder;
     colorBox(options?: Omit<ColorBoxOptions, 'path'>): IFormFieldBuilder;
     customWidget<T>(type: string, options?: Omit<T, 'path'>): IFormFieldBuilder;
+    customWidget<T>(type: string, options?: Omit<T, 'path'> & Partial<AXPWidgetNodeExtendedProperties>): IFormFieldBuilder;
 }
 interface IFieldsetContainerBuilder extends IBaseContainerBuilder<IFieldsetContainerBuilder>, ILayoutContainerBuilder<IFieldsetContainerBuilder> {
     setOptions(options: AXPFieldsetContainerOptions): IFieldsetContainerBuilder;
@@ -558,20 +637,30 @@ interface IFieldsetContainerBuilder extends IBaseContainerBuilder<IFieldsetConta
     setCols(cols: number): IFieldsetContainerBuilder;
     formField(label: string, delegate?: (field: IFormFieldBuilder) => void): IFieldsetContainerBuilder;
 }
-interface IDialogBuilder {
-}
-interface IDialogBuilder {
-    setOptions(options: AXPDialogContainerOptions): IDialogBuilder;
-    setTitle(title: string): IDialogBuilder;
-    setMessage(message?: string): IDialogBuilder;
-    setSize(size: AXPopupSizeType): IDialogBuilder;
-    setCloseButton(closeButton: boolean): IDialogBuilder;
-    setContext(context: any): IDialogBuilder;
-    content(delegate: (layoutBuilder: IFlexContainerBuilder) => void): IDialogBuilder;
-    setActions(delegate?: (actions: IActionBuilder) => void): IDialogBuilder;
-    addCustomAction(action: AXPActionMenuItem): IDialogBuilder;
+interface IDialogBuilder<T = AXPDialogRef> {
+}
+interface IDialogBuilder<T = AXPDialogRef> {
+    setOptions(options: AXPDialogContainerOptions): IDialogBuilder<T>;
+    setTitle(title: string): IDialogBuilder<T>;
+    setMessage(message?: string): IDialogBuilder<T>;
+    setSize(size: AXPopupSizeType): IDialogBuilder<T>;
+    setCloseButton(closeButton: boolean): IDialogBuilder<T>;
+    setContext(context: any): IDialogBuilder<T>;
+    content(delegate: (layoutBuilder: IFlexContainerBuilder) => void): IDialogBuilder<T>;
+    setActions(delegate?: (actions: IActionBuilder) => void): IDialogBuilder<T>;
+    /**
+     * Handler invoked when user clicks an action. Receives AXPDialogRef (context, action, setLoading, close).
+     * If handler throws, dialog stays open for retry.
+     * If handler returns, dialog closes and show() resolves with the return value.
+     */
+    onAction(handler: (dialogRef: AXPDialogRef) => T | Promise<T>): IDialogBuilder<T>;
+    /**
+     * Prompts for confirmation before dismiss when the dialog context is dirty (cancel, Esc, header close).
+     */
+    confirmCloseWhenDirty(options?: boolean | AXPDialogCloseConfirmationOptions): IDialogBuilder<T>;
+    addCustomAction(action: AXPActionMenuItem): IDialogBuilder<T>;
     build(): AXPWidgetNode;
-    show(): Promise<AXPDialogRef>;
+    show(): Promise<T>;
 }
 interface IListWidgetBuilder extends IBaseContainerBuilder<IListWidgetBuilder>, ILayoutContainerBuilder<IListWidgetBuilder>, IChildContainerBuilder<IListWidgetBuilder>, IWidgetContainerBuilder<IListWidgetBuilder> {
     setOptions(options: AXPListWidgetOptions): IListWidgetBuilder;
@@ -647,6 +736,11 @@ declare class AXPLayoutRendererComponent implements OnInit {
      */
     mode: _angular_core.InputSignal<AXPDynamicFormMode>;
     protected widgetTree: _angular_core.WritableSignal<AXPWidgetNode | null>;
+    /**
+     * Prefer explicit {@link AXPWidgetNode.mode} on the root node (e.g. dialog flex `mode('view')`)
+     * so nested widgets resolve view vs edit correctly; fall back to the layout `mode` input.
+     */
+    protected effectiveRenderMode: _angular_core.Signal<"filter" | "view" | "edit" | "column" | "designer" | "print">;
     /**
      * Convert layout data to widget tree when inputs change
      */
@@ -673,7 +767,7 @@ declare class AXPLayoutRendererComponent implements OnInit {
     /**
      * Handle context change events from widget container (optimized with RxJS)
      */
-    protected handleContextChanged(event: AXPWidgetCoreContextChangeEvent): void;
+    protected handleContextChanged(event: AXPContextChangeEvent): void;
     /**
      * Get the form component instance
      */
@@ -728,8 +822,40 @@ declare class LayoutBuilderModule {
     static ɵinj: _angular_core.ɵɵInjectorDeclaration<LayoutBuilderModule>;
 }
 
+/**
+ * Runs after dialog options and context are prepared and **before** footer customization and popup open.
+ * Listeners may mutate {@link AXPLayoutBuilderDialogBeforeOpenPayload.context} by reference.
+ */
+declare const AXP_LAYOUT_BUILDER_DIALOG_BEFORE_OPEN_HOOK_KEY = "layout-builder.dialog.before-open";
+interface AXPLayoutBuilderDialogBeforeOpenPayload {
+    context: Record<string, unknown>;
+    dialogOptions: AXPDialogContainerOptions;
+}
+/**
+ * Runs after builder-defined footer actions exist and **before** the dialog opens.
+ * Listeners receive the live `actions.footer.prefix` / `suffix` arrays (same references as the dialog)
+ * so they may push, splice, filter, or replace items. They may also mutate {@link AXPLayoutBuilderDialogFooterPayload.context} by reference.
+ */
+declare const AXP_LAYOUT_BUILDER_DIALOG_CONFIG_HOOK_KEY = "layout-builder.dialog.config";
+/**
+ * Runs whenever the dialog layout builder context changes (debounced upstream), **after** the popup is visible.
+ * Use for side effects that depend on live context (for example values updated by widgets after render).
+ * Payload mirrors `AXPDialogRendererComponent` semantics: {@link AXPLayoutBuilderDialogContextChangedPayload.getContext},
+ * {@link AXPLayoutBuilderDialogContextChangedPayload.patchContext}, and optional loading state.
+ */
+declare const AXP_LAYOUT_BUILDER_DIALOG_CONTEXT_CHANGED_HOOK_KEY = "layout-builder.dialog.context-changed";
+interface AXPLayoutBuilderDialogContextChangedPayload {
+    /** Stable id for this dialog instance; lets listeners correlate repeated emissions or async follow-up work. */
+    sessionKey: string;
+    getContext: () => Record<string, unknown>;
+    metadata: Record<string, unknown> | undefined;
+    patchContext: (partial: Record<string, unknown>) => void;
+    setLoading: (loading: boolean) => void;
+}
+
 declare class AXPLayoutBuilderService {
     private popupService;
+    private readonly hookService;
     /**
      * Create a new layout builder
      */
@@ -804,18 +930,7 @@ declare class AXPLayoutConversionService {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPLayoutConversionService>;
 }
 
-interface DialogRendererConfig {
-    title: string;
-    message?: string;
-    context: any;
-    definition: AXPWidgetNode;
-    actions?: {
-        footer?: {
-            prefix?: any[];
-            suffix?: any[];
-        };
-    };
-}
+type DialogRendererConfig = AXPLayoutBuilderDialogConfig;
 interface DialogRendererResult {
     context: any;
     action?: string;
@@ -826,35 +941,142 @@ declare class AXPDialogRendererComponent extends AXBasePageComponent implements
     result: EventEmitter<DialogRendererResult>;
     private widgetCoreService;
     private expressionEvaluator;
+    private readonly commandService;
+    private readonly hookService;
+    private readonly dialogService;
+    private readonly overlayService;
+    private readonly translationService;
+    private readonly document;
+    private readonly host;
     private dialogResult?;
+    /** Ensures `show()` resolves once when the dialog closes (footer action or header close). */
+    private callbackInvoked;
+    /** Baseline snapshot for dirty detection (captured once after init settles). */
+    private dirtyBaseline?;
+    /** True after the post-init baseline snapshot has been captured. */
+    private dirtyBaselineCaptured;
+    private dirtyBaselineIdleTimer?;
+    /** Callback payload applied when a dismiss is allowed in {@link onClosing}. */
+    private pendingDismissResolvePayload?;
+    /** Skips dirty confirmation on the next {@link onClosing} (successful submit / programmatic close). */
+    private skipNextOnClosingDirtyCheck;
+    /** Prevents concurrent dismiss paths from opening multiple unsaved-changes confirms. */
+    private dismissConfirmPromise?;
+    private dirtyBaselineFallbackTimer?;
+    private readonly destroyRef;
     context: _angular_core.WritableSignal<any>;
-    callBack: (dialogRef: AXPDialogRef) => void;
+    callBack: (result: unknown) => void;
     data: any;
     private isDialogLoading;
     footerPrefix: _angular_core.WritableSignal<AXPWidgetCoreElementAction[]>;
     footerSuffix: _angular_core.WritableSignal<AXPWidgetCoreElementAction[]>;
+    /**
+     * Correlate layout context snapshots for distributed hooks (`layout-builder.dialog.context-changed`).
+     */
+    private readonly contextChangedHooksSessionKey;
+    /**
+     * Capture-phase footer shortcuts — runs before widget editors (select, date, text) that stop keydown bubbling.
+     */
+    private readonly onDialogShortcutCapture;
     ngOnInit(): void;
+    /**
+     * Popup shell hook — handles header **X** and **Esc** (when `closeButton` is enabled).
+     * This is the only place that prompts for unsaved changes.
+     */
+    onClosing(e: AXComponentClosing): Promise<void>;
+    /**
+     * Footer cancel and other in-app dismiss actions. Routes through `super.close()` so the
+     * popup shell invokes {@link onClosing} exactly once (same path as **X** / **Esc**).
+     */
+    private requestDismiss;
+    /** Invokes `show()` callback with the pending payload or a default cancel {@link AXPDialogRef}. */
+    private completeDismissResolve;
+    private getWidgetContextStore;
+    private scheduleDirtyBaselineCapture;
+    /**
+     * Captures a dialog-local baseline once after widget init/normalization goes idle.
+     */
+    private captureDirtyBaselineIfNeeded;
     private layoutRenderer;
     private debounceTimer?;
     handleContextChanged(event: any): void;
     handleContextInitiated(event: any): void;
+    private invokeLayoutContextChangedHooks;
     footerPrefixActions(): AXPWidgetCoreElementAction[];
     footerSuffixActions(): AXPWidgetCoreElementAction[];
     isFormLoading(): boolean;
     isSubmitting(): boolean;
     executeAction(action: AXPWidgetCoreElementAction): Promise<void>;
+    private isDialogDirty;
+    private confirmDismissIfDirty;
+    private promptUnsavedChangesConfirm;
+    /** Whether the layout form should be validated before running this footer command. */
+    private shouldValidateBeforeAction;
+    /** True when a footer handler or command result asks to leave the dialog open (`keepDialogOpen` on the result or `result.data`). */
+    private shouldKeepDialogOpenAfterCommandResult;
+    /** Resolves the dialog `show()` promise exactly once. */
+    private resolveDialog;
+    private createDialogRef;
+    private closeWithOptionalSkipValidate;
+    /** Resolves footer/widget action command to a string (e.g. `cancel`, `submit`, `widget:...`). */
+    private resolveActionCommandName;
     private parseWidgetCommand;
-    private executeWidgetApi;
-    close(result?: DialogRendererResult): Promise<void>;
+    private invokeWidget;
+    close(result?: DialogRendererResult, options?: {
+        skipDirtyConfirm?: boolean;
+    }): Promise<void>;
     private aggregateAndEvaluateActions;
     private collectWidgetActions;
     private collectDialogActionsFromConfig;
     private evaluatePredicates;
     private evalBool;
+    /** Resolves footer action title when it contains {{ ... }} (e.g. wizard labels from dialog context). */
+    private evalActionTitle;
     private resolveApi;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPDialogRendererComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPDialogRendererComponent, "axp-dialog-renderer", never, { "config": { "alias": "config"; "required": false; }; }, { "result": "result"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPDialogRendererComponent, "axp-dialog-renderer", never, {}, { "result": "result"; }, never, never, true, never>;
+}
+
+/** Registration key for {@link AXPPreviewWidgetFieldCommand}; lives alone so `LayoutBuilderModule` can reference it without static-importing the command implementation. */
+declare const AXP_PREVIEW_WIDGET_FIELD_COMMAND_KEY = "Widget:Preview";
+
+/** See `AXP_PREVIEW_WIDGET_FIELD_COMMAND_KEY` in `preview-widget-field.command.key.ts`. */
+interface AXPPreviewWidgetFieldCommandInput {
+    /** Widget node to render (same shape as `widget-field-configurator` model). */
+    widget?: AXPWidgetNode;
+    /**
+     * Alternate property name for the widget node (matches metadata definition `interface` field).
+     */
+    interface?: AXPWidgetNode | string;
+    fieldName?: string;
+    fieldTitle?: AXPMultiLanguageString;
+    name?: string;
+    title?: AXPMultiLanguageString;
+}
+type AXPPreviewWidgetFieldInvocation = AXPPreviewWidgetFieldCommandInput & {
+    __context__?: {
+        data?: Record<string, unknown>;
+        options?: Record<string, unknown>;
+    };
+};
+/**
+ * Opens a dialog that previews a widget configuration (same behavior as the preview button on
+ * `axp-widget-field-configurator`). Invoked from that component and from entity list actions.
+ */
+declare class AXPPreviewWidgetFieldCommand implements AXPCommand<AXPPreviewWidgetFieldCommandInput, void> {
+    private readonly formBuilderService;
+    private readonly widgetRegistry;
+    private readonly translationService;
+    private readonly crudService;
+    execute(input: AXPPreviewWidgetFieldInvocation): Promise<AXPExecuteCommandResult<void>>;
+    private mergeInvocation;
+    private normalizeWidget;
+    private resolveFieldTitleLabel;
+    private isCancelDialogOutcome;
+    private resolveWidgetDisplayTitle;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPPreviewWidgetFieldCommand, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPPreviewWidgetFieldCommand>;
 }
 
-export { AXPDialogRendererComponent, AXPLayoutBuilderService, AXPLayoutConversionService, AXPLayoutRendererComponent, LayoutBuilderModule };
-export type { AXPDialogContainerOptions, AXPDialogRef, AXPDynamicFormDefinition, AXPDynamicFormDirection, AXPDynamicFormFieldDefinition, AXPDynamicFormGroupDefinition, AXPDynamicFormLook, AXPDynamicFormMode, AXPFieldsetContainerOptions, AXPFlexContainerOptions, AXPFormFieldOptions, AXPGridContainerOptions, AXPListWidgetColumn, AXPListWidgetOptions, AXPListWidgetRowCommand, AXPPageContainerOptions, AXPPanelContainerOptions, AXPStepDefinition, AXPStepWizardContainerOptions, AXPStepWizardDefinition, AXPStepWizardGuardPayload, AXPStepWizardStatus, AXPTabsetContainerOptions, AXPWidgetConfiguration, AXPWizardActionDefinition, AXPWizardActions, ColorBoxOptions, DateTimeBoxOptions, DialogBuilderState, DialogRendererConfig, DialogRendererResult, FormFieldBuilderState, IActionBuilder, IBaseContainerBuilder, IChildContainerBuilder, IDialogBuilder, IFieldsetContainerBuilder, IFlexContainerBuilder, IFormFieldBuilder, IGridContainerBuilder, ILayoutBuilder, ILayoutContainerBuilder, IListWidgetBuilder, IPageContainerBuilder, IPanelContainerBuilder, IStepBuilder, IStepWizardBuilder, ITabsetContainerBuilder, IWidgetBuilder, IWidgetContainerBuilder, InheritanceContext, InheritedProperties, LargeTextBoxOptions, LayoutBuilderState, LayoutWidgetOptions, LookupBoxOptions, NumberBoxOptions, PasswordBoxOptions, RichTextOptions, SelectBoxOptions, SelectionListOptions, TextBoxOptions, ToggleSwitchOptions, ValueWidgetOptions, WidgetBuilderState };
+export { AXPDialogRendererComponent, AXPLayoutBuilderService, AXPLayoutConversionService, AXPLayoutRendererComponent, AXPPreviewWidgetFieldCommand, AXP_LAYOUT_BUILDER_DIALOG_BEFORE_OPEN_HOOK_KEY, AXP_LAYOUT_BUILDER_DIALOG_CONFIG_HOOK_KEY, AXP_LAYOUT_BUILDER_DIALOG_CONTEXT_CHANGED_HOOK_KEY, AXP_PREVIEW_WIDGET_FIELD_COMMAND_KEY, DEFAULT_CANCEL_DIALOG_ACTION_SHORTCUTS, DEFAULT_SUBMIT_DIALOG_ACTION_SHORTCUTS, LayoutBuilderModule, createDismissedDialogRef };
+export type { AXPDialogActionMenuItem, AXPDialogActionOptions, AXPDialogActionShortcut, AXPDialogCloseConfirmationOptions, AXPDialogContainerOptions, AXPDialogRef, AXPDynamicFormDefinition, AXPDynamicFormDirection, AXPDynamicFormFieldDefinition, AXPDynamicFormGroupDefinition, AXPDynamicFormLook, AXPDynamicFormMode, AXPFieldsetContainerOptions, AXPFlexContainerOptions, AXPFormFieldHintDisplayMode, AXPFormFieldOptions, AXPGridContainerOptions, AXPLayoutBuilderDialogBeforeOpenPayload, AXPLayoutBuilderDialogConfig, AXPLayoutBuilderDialogContextChangedPayload, AXPListWidgetColumn, AXPListWidgetOptions, AXPListWidgetRowCommand, AXPPageContainerOptions, AXPPanelContainerOptions, AXPPreviewWidgetFieldCommandInput, AXPStepDefinition, AXPStepWizardContainerOptions, AXPStepWizardDefinition, AXPStepWizardGuardPayload, AXPStepWizardStatus, AXPTabsetContainerOptions, AXPWidgetConfiguration, AXPWidgetNodeExtendedProperties, AXPWizardActionDefinition, AXPWizardActions, ColorBoxOptions, DateTimeBoxOptions, DialogBuilderState, DialogRendererConfig, DialogRendererResult, FormFieldBuilderState, IActionBuilder, IBaseContainerBuilder, IChildContainerBuilder, IDialogBuilder, IFieldsetContainerBuilder, IFlexContainerBuilder, IFormFieldBuilder, IGridContainerBuilder, ILayoutBuilder, ILayoutContainerBuilder, IListWidgetBuilder, IPageContainerBuilder, IPanelContainerBuilder, IStepBuilder, IStepWizardBuilder, ITabsetContainerBuilder, IWidgetBuilder, IWidgetContainerBuilder, InheritanceContext, InheritedProperties, LargeTextBoxOptions, LayoutBuilderState, LayoutWidgetOptions, LookupBoxOptions, NumberBoxOptions, PasswordBoxOptions, RichTextOptions, SelectBoxOptions, SelectionListOptions, TextBoxOptions, ToggleSwitchOptions, ValueWidgetOptions, WidgetBuilderState };