@acorex/platform 21.0.0-next.70 → 21.0.0-next.72

package/types/acorex-platform-layout-builder.d.ts

@@ -4,13 +4,25 @@ import * as i1 from '@angular/common';
 import { AXFormComponent } from '@acorex/components/form';
 import { AXValidationSummary } from '@acorex/core/validation';
 import { AXPWidgetNode, AXPWidgetRenderMode, AXPWidgetContainerComponent, AXPWidgetCoreElementAction } from '@acorex/platform/layout/widget-core';
-import { AXDataSource } from '@acorex/cdk/common';
+import { AXDataSource, AXComponentClosing } from '@acorex/cdk/common';
 import { AXPopupSizeType } from '@acorex/components/popup';
 import { AXStepWizardLook } from '@acorex/components/step-wizard';
-import { AXPMetaData, AXPGridLayoutOptions, AXPActionMenuItem, AXPMultiLanguageString, AXPExpression, AXPValidationRules, AXPOptionsData, AXPContextChangeEvent, AXPExecuteCommandResult } from '@acorex/platform/core';
+import { AXPKeyboardShortcut, AXPKeyboardShortcutChord, 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';
 
+/** Resolved chord string used by dialog footer shortcut matching. */
+type AXPDialogActionShortcut = AXPKeyboardShortcutChord;
+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'` or `{ keys: 'ctrl+s' }`).
+     * Merged with built-in defaults for `cancel` / `submit`. Pass `[]` to disable all shortcuts.
+     */
+    shortcuts?: AXPKeyboardShortcut[];
+}
+
 /**
  * Extended widget node properties (excluding type, path, name, options, children)
  * These properties can be passed as a third parameter to customWidget method
@@ -254,6 +266,14 @@ interface AXPFormFieldOptions extends LayoutWidgetOptions {
     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;
     message?: string;
@@ -261,6 +281,11 @@ interface AXPDialogContainerOptions extends LayoutWidgetOptions {
     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}.
@@ -277,6 +302,7 @@ interface AXPLayoutBuilderDialogConfig {
     metadata?: AXPMetaData;
     actions: NonNullable<DialogBuilderState['actions']>;
     onAction?: (dialogRef: AXPDialogRef) => unknown | Promise<unknown>;
+    confirmCloseWhenDirty?: AXPDialogCloseConfirmationOptions;
 }
 interface RichTextOptions extends ValueWidgetOptions {
     placeholder?: AXPMultiLanguageString;
@@ -436,22 +462,24 @@ type WidgetBuilderState = AXPWidgetNode & {
 type FormFieldBuilderState = AXPWidgetNode & {
     layout?: AXPGridLayoutOptions;
 };
+/** Dialog footer action item; extends menu actions with placement. */
+type AXPDialogActionMenuItem = AXPActionMenuItem & {
+    position?: 'prefix' | 'suffix';
+};
 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 & {
-        position?: 'prefix' | 'suffix';
-    }): 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;
@@ -626,6 +654,10 @@ interface IDialogBuilder<T = AXPDialogRef> {
      * 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<T>;
@@ -708,7 +740,7 @@ declare class AXPLayoutRendererComponent implements OnInit {
      * 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<"view" | "edit" | "column" | "designer" | "print" | "filter">;
+    protected effectiveRenderMode: _angular_core.Signal<"filter" | "view" | "edit" | "column" | "designer" | "print">;
     /**
      * Convert layout data to widget tree when inputs change
      */
@@ -911,9 +943,21 @@ declare class AXPDialogRendererComponent extends AXBasePageComponent implements
     private expressionEvaluator;
     private readonly commandService;
     private readonly hookService;
+    private readonly unsavedChangesConfirm;
+    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;
+    /** 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;
+    /** Blocks re-entrant {@link onClosing} while the first close gate is still resolving. */
+    private closeGateInProgress;
+    private readonly destroyRef;
     context: _angular_core.WritableSignal<any>;
     callBack: (result: unknown) => void;
     data: any;
@@ -924,7 +968,24 @@ declare class AXPDialogRendererComponent extends AXBasePageComponent implements
      * 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 getWidgetContainer;
     private layoutRenderer;
     private debounceTimer?;
     handleContextChanged(event: any): void;
@@ -935,6 +996,8 @@ declare class AXPDialogRendererComponent extends AXBasePageComponent implements
     isFormLoading(): boolean;
     isSubmitting(): boolean;
     executeAction(action: AXPWidgetCoreElementAction): Promise<void>;
+    private isDialogDirty;
+    private confirmDismissIfDirty;
     /** 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`). */
@@ -947,7 +1010,9 @@ declare class AXPDialogRendererComponent extends AXBasePageComponent implements
     private resolveActionCommandName;
     private parseWidgetCommand;
     private invokeWidget;
-    close(result?: DialogRendererResult): Promise<void>;
+    close(result?: DialogRendererResult, options?: {
+        skipDirtyConfirm?: boolean;
+    }): Promise<void>;
     private aggregateAndEvaluateActions;
     private collectWidgetActions;
     private collectDialogActionsFromConfig;
@@ -1001,5 +1066,5 @@ declare class AXPPreviewWidgetFieldCommand implements AXPCommand<AXPPreviewWidge
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPPreviewWidgetFieldCommand>;
 }
 
-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, LayoutBuilderModule, createDismissedDialogRef };
-export type { 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 };
+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 };

package/types/acorex-platform-layout-components.d.ts

@@ -1,5 +1,5 @@
 import * as _angular_core from '@angular/core';
-import { Signal, InjectionToken, InputSignal, TemplateRef, ElementRef, OnDestroy, OnInit, QueryList, OnChanges, Type, EventEmitter, WritableSignal } from '@angular/core';
+import { Signal, InjectionToken, InputSignal, TemplateRef, ElementRef, OnDestroy, OnInit, QueryList, Type, EventEmitter, WritableSignal } from '@angular/core';
 import { AXPActivityLog, AXPSystemActionType, AXPCategoryEntity, AXPColumnQuery, AXPContextData, AXPFilterClause, AXPFilterDefinition, AXPFilterQuery, AXPContextChangeEvent, AXPMultiLanguageString, AXPActionMenuItem, AXPExecuteCommand, AXPExecuteCommandResult, containsHtmlMarkup, AXPSortDefinition, AXPSortQuery, AXPMetaData, AXPViewQuery } from '@acorex/platform/core';
 import { AXHtmlEvent, AXValueChangedEvent, AXClickEvent, AXDataSource, AXDataSourceFilterOption, AXDataSourceOperator, AXFilterLogic, AXEvent, AXRange } from '@acorex/cdk/common';
 import * as _ngrx_signals from '@ngrx/signals';
@@ -155,6 +155,7 @@ declare class AXPTaskBadgeDirective {
         overlayLoadingTaskCount: _angular_core.Signal<number>;
         navigationLoadingTaskCount: _angular_core.Signal<number>;
         sideMenuState: _angular_core.Signal<_acorex_platform_themes_shared.AXPSideMenuState>;
+        overlaySideMenuOpen: _angular_core.Signal<boolean>;
         sideMenuWidth: _angular_core.Signal<number>;
         sideMenuCompactWidth: _angular_core.Signal<number>;
         menuVerticalMode: _angular_core.Signal<_acorex_platform_themes_shared.AXPMenuVerticalMode>;
@@ -167,6 +168,7 @@ declare class AXPTaskBadgeDirective {
         isOverlayLoading: _angular_core.Signal<boolean>;
         isNavigationLoading: _angular_core.Signal<boolean>;
         isMenuHorizontal: _angular_core.Signal<boolean>;
+        effectiveMenuVerticalMode: _angular_core.Signal<_acorex_platform_themes_shared.AXPMenuVerticalMode>;
         sideMenuDrawerWidth: _angular_core.Signal<number>;
         changeThemeMode: (theme: _acorex_platform_themes_shared.AXPThemeMode) => void;
         openSideMenu: () => void;
@@ -191,6 +193,7 @@ declare class AXPTaskBadgeDirective {
         overlayLoadingTaskCount: number;
         navigationLoadingTaskCount: number;
         sideMenuState: _acorex_platform_themes_shared.AXPSideMenuState;
+        overlaySideMenuOpen: boolean;
         sideMenuWidth: number;
         sideMenuCompactWidth: number;
         menuVerticalMode: _acorex_platform_themes_shared.AXPMenuVerticalMode;
@@ -934,6 +937,11 @@ declare class AXPQueryFiltersComponent {
     private filterOperatorMiddleware;
     private settingsService;
     private readonly expressionEvaluator;
+    private readonly shortcutRegistry;
+    private readonly destroyRef;
+    private readonly elementRef;
+    protected readonly filterFocusShortcutKeys: string[];
+    constructor();
     filtersDefinitions: _angular_core.InputSignal<AXPFilterDefinition[]>;
     initialFilters: _angular_core.InputSignal<AXPFilterQuery[]>;
     onFiltersChanged: _angular_core.OutputEmitterRef<AXPFilterQuery[]>;
@@ -979,13 +987,16 @@ declare class AXPQueryFiltersComponent {
     protected onPopoverOpened(e: AXEvent): void;
     protected deactivateAllListItems(): void;
     protected isFilterDisabled(definition: AXPFilterDefinition): boolean;
+    /**
+     * Resolves filter chip labels; translates i18n keys stored in select `displayText` or datasource titles.
+     */
+    private formatFilterDisplayValue;
     private createExpressionScope;
     private isObservableLike;
     private buildFilterTriggerScope;
     private getFilterEventScope;
     private getFilterWidgetScopeForDefinition;
     private removeFilterFieldByName;
-    protected handleKeyboardEvent(event: KeyboardEvent): Promise<void>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPQueryFiltersComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPQueryFiltersComponent, "axp-query-filters", never, { "filtersDefinitions": { "alias": "filtersDefinitions"; "required": false; "isSignal": true; }; "initialFilters": { "alias": "initialFilters"; "required": false; "isSignal": true; }; }, { "onFiltersChanged": "onFiltersChanged"; }, never, never, true, never>;
 }
@@ -1229,24 +1240,21 @@ declare class AXPLayoutSideDetailPanelComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPLayoutSideDetailPanelComponent, "axp-layout-side-detail-panel", never, { "multiSelectLabel": { "alias": "multiSelectLabel"; "required": false; "isSignal": true; }; "header": { "alias": "header"; "required": false; "isSignal": true; }; "sections": { "alias": "sections"; "required": false; "isSignal": true; }; "rows": { "alias": "rows"; "required": false; "isSignal": true; }; "rowsSectionTitle": { "alias": "rowsSectionTitle"; "required": false; "isSignal": true; }; "noRowsMessage": { "alias": "noRowsMessage"; "required": false; "isSignal": true; }; "emptyState": { "alias": "emptyState"; "required": false; "isSignal": true; }; }, { "panelClose": "panelClose"; }, ["projectedSections"], never, true, never>;
 }
 
-declare class AXPLogoComponent implements OnInit, OnChanges {
-    source: any;
-    protected activeSource: any;
-    protected logoType: string;
-    protected isCompactLogo: boolean;
+declare class AXPLogoComponent {
+    source: _angular_core.InputSignal<any>;
+    private readonly themeStore;
+    private readonly platformConfig;
+    private readonly deviceService;
     protected readonly compactLogoSize = 32;
-    private inputSource;
-    private platform;
-    private themeStore;
-    private platformConfig;
-    private cdr;
-    constructor();
-    ngOnInit(): void;
-    ngOnChanges(): void;
-    private updateActiveSource;
-    private setLogoType;
+    /**
+     * Resolves menu mode with mobile overlay viewports forcing full logo display.
+     */
+    private readonly resolvedMenuMode;
+    protected readonly activeSource: _angular_core.Signal<any>;
+    protected readonly isCompactLogo: _angular_core.Signal<boolean>;
+    protected readonly logoType: _angular_core.Signal<"icon" | "url" | "component" | undefined>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPLogoComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPLogoComponent, "axp-logo", never, { "source": { "alias": "source"; "required": false; }; }, {}, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPLogoComponent, "axp-logo", never, { "source": { "alias": "source"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 type MarkdownSegmentType = 'markdown' | 'code';
@@ -2470,6 +2478,9 @@ interface AXPSpreadsheetConfig {
 
 declare class AXPSpreadsheetComponent {
     protected readonly translationService: AXTranslationService;
+    private readonly shortcutRegistry;
+    private readonly destroyRef;
+    private readonly elementRef;
     /**
      * Translated column titles
      */
@@ -2643,10 +2654,6 @@ declare class AXPSpreadsheetComponent {
      * Handle blur event to stop editing (when user clicks away from cell)
      */
     protected handleCellBlur(rowId: string, columnName: string): void;
-    /**
-     * Handle Escape key to cancel editing
-     */
-    protected handleKeyDown(event: KeyboardEvent): void;
     /**
      * Commit cell edit (save changes and close editing mode)
      */
@@ -3005,8 +3012,7 @@ declare class AXPUserAvatarComponent implements OnInit, OnDestroy {
     ngOnDestroy(): void;
     private loadUserData;
     /**
-     * Generate avatar image source
-     * This is a placeholder - implement based on your actual requirements
+     * Resolves avatar image URL from user data and resets load state.
      */
     private generateAvatarSrc;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPUserAvatarComponent, never>;