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

package/types/acorex-platform-contracts.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Address mode type - determines the display mode of the address widget
+ * - simple: single text input for full address (one line)
+ * - popup: readonly summary + button to edit in popup dialog
+ * - expandable: expandable panel — collapsed shows full address, expanded shows inline form
+ */
+type AXPAddressMode = 'simple' | 'popup' | 'expandable';
+/**
+ * Address label option
+ */
+interface AXPAddressLabel {
+    id: string;
+    name: string;
+}
+/**
+ * Address data structure
+ */
+interface AXPAddressData {
+    street1: string;
+    street2?: string;
+    postalCode?: string;
+    coordinates?: string;
+    full: string;
+    label?: string;
+    country?: {
+        id?: string;
+        title?: string;
+    };
+    state?: {
+        id?: string;
+        title?: string;
+    };
+    city?: {
+        id?: string;
+        title?: string;
+    };
+}
+
+export type { AXPAddressData, AXPAddressLabel, AXPAddressMode };

package/types/acorex-platform-core.d.ts

@@ -1,5 +1,5 @@
 import * as i0 from '@angular/core';
-import { Type, InjectionToken, OnInit, ViewContainerRef, ModuleWithProviders, ElementRef, EventEmitter, OnChanges, Renderer2, SimpleChanges, OnDestroy, Injector, PipeTransform, Provider } from '@angular/core';
+import { Type, InjectionToken, OnInit, ViewContainerRef, ModuleWithProviders, ElementRef, EventEmitter, OnChanges, Renderer2, SimpleChanges, OnDestroy, DestroyRef, Injector, PipeTransform, Provider } from '@angular/core';
 import { AXStyleColorType, AXDataSource, AXDataSourceSortOption, AXDataSourceFilterOption, AXStyleLookType, AXDataSourceQuery, AXDataSourceCallbackResult } from '@acorex/cdk/common';
 import { AXMultiLanguageString } from '@acorex/core/translation';
 import * as _ngrx_signals from '@ngrx/signals';
@@ -7,6 +7,12 @@ import * as _acorex_platform_core from '@acorex/platform/core';
 import { Observable } from 'rxjs';
 import { NavigationExtras } from '@angular/router';
 
+/** Platform core datasource registry names. */
+declare const AXPPlatformCoreDataSourceKeys: {
+    readonly ModuleManifests: "platform-module-manifests";
+    readonly CatalogScopes: "platform-catalog-scopes";
+};
+
 /**
  * Additional suggested generic actions for future consideration:
  *
@@ -1193,6 +1199,87 @@ interface AXPFilterQuery extends Pick<AXPFilterDefinition, 'field' | 'value' | '
     displayText?: string;
 }
 
+/**
+ * Normalized keyboard chord (e.g. `ctrl+f`, `arrowleft`, `f1`).
+ * Modifiers and key are joined with `+`.
+ */
+type AXPKeyboardShortcutChord = string;
+/** Priority tier — higher values win when multiple bindings match. */
+declare enum AXPKeyboardShortcutPriority {
+    Global = 0,
+    Page = 10,
+    Panel = 20,
+    Modal = 100
+}
+/**
+ * How horizontal directional keys behave in RTL locale profiles (`activeProfile().i18nMeta?.rtl`).
+ * - `physical`: arrow left always means left (grid navigation, etc.).
+ * - `semantic`: arrows and `[` / `]` mirror so next/previous follow reading direction.
+ */
+type AXPKeyboardShortcutDirectionBehavior = 'physical' | 'semantic';
+interface AXPKeyboardShortcutBinding {
+    /**
+     * One or more key chords that trigger this action.
+     * Example: `['arrowleft', 'pageup']` or `['ctrl+f']`.
+     */
+    keys: AXPKeyboardShortcutChord[];
+    /** i18n key (e.g. `@general:...`) or plain label for the help dialog. */
+    title: string;
+    /** Optional group label (i18n key or plain) for help dialog grouping. */
+    group?: string;
+    /** When true, fires even if focus is inside an editable field. Default false. */
+    allowInEditableFields?: boolean;
+    /** Optional runtime guard — binding is ignored when this returns false. */
+    when?: () => boolean;
+    /**
+     * RTL handling for horizontal direction keys (`←`/`→`, `[`/`]`).
+     * Omitted = auto (`semantic` for direction keys, `physical` otherwise). Set `physical` to opt out.
+     */
+    directionBehavior?: AXPKeyboardShortcutDirectionBehavior;
+    handler: (event: KeyboardEvent) => void | Promise<void>;
+}
+/**
+ * Declarative shortcut for menus, action items, and other config-driven bindings.
+ * Use a chord string for defaults, or an object to override binding options (e.g. `allowInEditableFields`).
+ */
+type AXPKeyboardShortcutConfig = Pick<AXPKeyboardShortcutBinding, 'allowInEditableFields' | 'when' | 'directionBehavior'> & {
+    keys: AXPKeyboardShortcutChord | readonly AXPKeyboardShortcutChord[];
+};
+type AXPKeyboardShortcut = AXPKeyboardShortcutChord | AXPKeyboardShortcutConfig;
+/** Normalized declarative shortcut used when registering keyboard bindings. */
+interface AXPResolvedKeyboardShortcut {
+    keys: AXPKeyboardShortcutChord[];
+    allowInEditableFields?: boolean;
+    when?: () => boolean;
+    directionBehavior?: AXPKeyboardShortcutDirectionBehavior;
+}
+interface AXPKeyboardShortcutRegistration {
+    /** Stable id for this registration scope (e.g. `task-board-navigator`). */
+    id: string;
+    /** Higher priority bindings win on conflict. */
+    priority?: AXPKeyboardShortcutPriority | number;
+    /** Scope label shown in the help dialog (i18n key or plain). */
+    scope?: string;
+    /** Default group for bindings without their own `group`. */
+    group?: string;
+    /** Optional runtime guard — registration is ignored when this returns false. */
+    when?: () => boolean;
+    shortcuts: AXPKeyboardShortcutBinding[];
+}
+/** Resolved entry for help UI. */
+interface AXPKeyboardShortcutHelpEntry {
+    registrationId: string;
+    bindingTitle: string;
+    /** Raw chords for `ax-kbd-item` rendering (canonical registration). */
+    chords: AXPKeyboardShortcutChord[];
+    /** Chords adjusted for RTL display when `directionBehavior` is `semantic`. */
+    displayChords: AXPKeyboardShortcutChord[];
+    displayKeys: string;
+    scope?: string;
+    group?: string;
+    priority: number;
+}
+
 type AXPActionMenuItem = {
     name?: string;
     title: AXPMultiLanguageString;
@@ -1206,6 +1293,11 @@ type AXPActionMenuItem = {
     disabled?: boolean | string;
     visible?: boolean | string;
     policy?: string;
+    /**
+     * Keyboard shortcuts for this action.
+     * Use a chord string or `{ keys, allowInEditableFields, ... }`. Pass `[]` to disable.
+     */
+    shortcuts?: AXPKeyboardShortcut[];
 };
 type AXPBackButton = {
     title: AXPMultiLanguageString;
@@ -1653,10 +1745,8 @@ declare class AXPDataSourceDefinitionProviderService implements AXPDataSourceDef
     static ɵprov: i0.ɵɵInjectableDeclaration<AXPDataSourceDefinitionProviderService>;
 }
 
-/** Data source name for select widgets listing registered catalog scopes. */
-declare const PLATFORM_CATALOG_SCOPES_DATASOURCE_NAME = "platform-catalog-scopes";
 /**
- * Registered catalog scopes for select / selection-list widgets via {@link PLATFORM_CATALOG_SCOPES_DATASOURCE_NAME}.
+ * Registered catalog scopes for select / selection-list widgets via {@link AXPPlatformCoreDataSourceKeys.CatalogScopes}.
  */
 declare class AXPCatalogScopeDefinitionsDataSourceDefinition implements AXPDataSourceDefinitionProvider {
     private readonly catalogScopeRegistry;
@@ -1954,8 +2044,8 @@ interface AXPContextUpdateOptions {
     origin?: AXPContextUpdateOrigin;
 }
 interface AXPContextPatchOptions {
-    skipDirtyTracking?: boolean;
-    origin?: AXPContextUpdateOrigin;
+    /** When true, updates the saved snapshot together with live data. */
+    updateSaved?: boolean;
 }
 type AXPContextData = {
     [key: string]: any;
@@ -1967,41 +2057,42 @@ declare class AXPContextChangeEvent {
     state: AXPContextState;
     data: any;
     origin?: AXPContextUpdateOrigin;
-    /** Aggregated form dirty flag (user context paths + composite widget dirty). */
+    /** Aggregated form dirty flag (context snapshot + composite widget dirty). */
     isFormDirty?: boolean;
 }
 declare const AXPContextStore: i0.Type<{
     data: i0.Signal<AXPContextData>;
     state: i0.Signal<AXPContextState>;
-    initialSnapshot: i0.Signal<{}>;
-    previousSnapshot: i0.Signal<{}>;
-    userDirtyPaths: i0.Signal<string[]>;
+    savedSnapshot: i0.Signal<AXPContextData>;
+    previousSnapshot: i0.Signal<AXPContextData>;
     lastChange: _ngrx_signals.DeepSignal<AXPContextChangeEvent>;
     isChanged: i0.Signal<boolean>;
     isReset: i0.Signal<boolean>;
     isInitiated: i0.Signal<boolean>;
     isEmpty: i0.Signal<boolean>;
+    isSavedCommitted: i0.Signal<boolean>;
     isDirty: i0.Signal<boolean>;
-    isUserDirty: i0.Signal<boolean>;
     snapshot: i0.Signal<AXPContextData>;
-    initial: i0.Signal<{}>;
-    previous: i0.Signal<{}>;
+    saved: i0.Signal<AXPContextData>;
+    initial: i0.Signal<AXPContextData>;
+    previous: i0.Signal<AXPContextData>;
     changeEvent: i0.Signal<AXPContextChangeEvent>;
     update: (path: string, value: any, options?: AXPContextUpdateOptions) => void;
     applyObjectPaths: (obj: Record<string, unknown>, options?: AXPContextUpdateOptions, prefix?: string) => void;
-    patch: (context: Record<string, any>, second?: boolean | AXPContextPatchOptions) => void;
+    patch: (context: Record<string, any>, options?: AXPContextPatchOptions) => void;
+    revertToSaved: () => void;
     reset: () => void;
     set: (initialData: any) => void;
     getValue: (path: string) => any;
+    getSavedValue: (path: string) => any;
     hasValue: (path: string) => boolean;
-    commitBaseline: () => void;
-    clearUserDirtyPaths: () => void;
+    commitSaved: () => void;
+    applyParentBind: (merged: AXPContextData) => void;
 } & _ngrx_signals.StateSource<{
     data: AXPContextData;
     state: AXPContextState;
-    initialSnapshot: {};
-    previousSnapshot: {};
-    userDirtyPaths: string[];
+    savedSnapshot: AXPContextData;
+    previousSnapshot: AXPContextData;
     lastChange: AXPContextChangeEvent;
 }>>;
 
@@ -2035,35 +2126,36 @@ declare class AXPComponentSlotDirective implements OnInit {
     contextStore: {
         data: i0.Signal<AXPContextData>;
         state: i0.Signal<_acorex_platform_core.AXPContextState>;
-        initialSnapshot: i0.Signal<{}>;
-        previousSnapshot: i0.Signal<{}>;
-        userDirtyPaths: i0.Signal<string[]>;
+        savedSnapshot: i0.Signal<AXPContextData>;
+        previousSnapshot: i0.Signal<AXPContextData>;
         lastChange: _ngrx_signals.DeepSignal<_acorex_platform_core.AXPContextChangeEvent>;
         isChanged: i0.Signal<boolean>;
         isReset: i0.Signal<boolean>;
         isInitiated: i0.Signal<boolean>;
         isEmpty: i0.Signal<boolean>;
+        isSavedCommitted: i0.Signal<boolean>;
         isDirty: i0.Signal<boolean>;
-        isUserDirty: i0.Signal<boolean>;
         snapshot: i0.Signal<AXPContextData>;
-        initial: i0.Signal<{}>;
-        previous: i0.Signal<{}>;
+        saved: i0.Signal<AXPContextData>;
+        initial: i0.Signal<AXPContextData>;
+        previous: i0.Signal<AXPContextData>;
         changeEvent: i0.Signal<_acorex_platform_core.AXPContextChangeEvent>;
         update: (path: string, value: any, options?: _acorex_platform_core.AXPContextUpdateOptions) => void;
         applyObjectPaths: (obj: Record<string, unknown>, options?: _acorex_platform_core.AXPContextUpdateOptions, prefix?: string) => void;
-        patch: (context: Record<string, any>, second?: boolean | _acorex_platform_core.AXPContextPatchOptions) => void;
+        patch: (context: Record<string, any>, options?: _acorex_platform_core.AXPContextPatchOptions) => void;
+        revertToSaved: () => void;
         reset: () => void;
         set: (initialData: any) => void;
         getValue: (path: string) => any;
+        getSavedValue: (path: string) => any;
         hasValue: (path: string) => boolean;
-        commitBaseline: () => void;
-        clearUserDirtyPaths: () => void;
+        commitSaved: () => void;
+        applyParentBind: (merged: AXPContextData) => void;
     } & _ngrx_signals.StateSource<{
         data: AXPContextData;
         state: _acorex_platform_core.AXPContextState;
-        initialSnapshot: {};
-        previousSnapshot: {};
-        userDirtyPaths: string[];
+        savedSnapshot: AXPContextData;
+        previousSnapshot: AXPContextData;
         lastChange: _acorex_platform_core.AXPContextChangeEvent;
     }>;
     isEmpty: i0.Signal<boolean>;
@@ -2402,6 +2494,142 @@ declare class AXPHookService {
     static ɵprov: i0.ɵɵInjectableDeclaration<AXPHookService>;
 }
 
+/** Acorex overlay root (modal shell, popup, dialog). */
+declare const AX_OVERLAY_CONTAINER_SELECTOR = ".ax-overlay-container";
+/** Anchored widget panel inside an overlay (select, date picker, dropdown). */
+declare const AX_OVERLAY_PANE_SELECTOR = ".ax-overlay-pane";
+/**
+ * True when a visible overlay layer is foreground (modal, popup, widget popover/picker).
+ */
+declare function hasForegroundOverlayLayer(document: Document): boolean;
+/**
+ * Returns visible anchored overlay panes (widget popovers/pickers).
+ */
+declare function getVisibleAnchoredOverlayPanes(document: Document): HTMLElement[];
+/**
+ * Visible anchored panes that are not contained by `excludeContainer` (e.g. dialog shell).
+ */
+declare function getNestedVisibleOverlayPanes(document: Document, excludeContainer: HTMLElement | null): HTMLElement[];
+/**
+ * Collects visible overlay containers in stacking order (later / higher z-index wins).
+ */
+declare function getVisibleOverlayContainers(document: Document): HTMLElement[];
+/** Topmost visible overlay container, if any. */
+declare function getTopVisibleOverlayContainer(document: Document): HTMLElement | null;
+/** Nearest overlay container ancestor of `element`. */
+declare function findOverlayContainerAncestor(element: HTMLElement): HTMLElement | null;
+/**
+ * Returns true when the overlay element is rendered and visible in the viewport.
+ */
+declare function isVisibleOverlayElement(element: Element): boolean;
+
+interface AXPKeyboardShortcutFormatOptions {
+    directionBehavior?: AXPKeyboardShortcutDirectionBehavior;
+    /** From `AXLocaleService.activeProfile().i18nMeta?.rtl`. */
+    isRtl?: boolean;
+    /** Chord was already passed through `resolveDisplayShortcutChord` (e.g. help `displayChords`). */
+    skipDirectionResolve?: boolean;
+}
+/** Maps a horizontal direction key to its RTL semantic counterpart. */
+declare function mirrorHorizontalDirectionalKey(key: string): string;
+/** True when the chord's primary key is a horizontal direction key (`←`/`→`, `[`/`]`). */
+declare function isHorizontalDirectionalShortcutKey(key: string): boolean;
+/**
+ * Resolves direction behavior for a chord.
+ * Horizontal direction keys default to `semantic`; others default to `physical`.
+ * An explicit binding value always wins.
+ */
+declare function resolveEffectiveDirectionBehavior(chord: AXPKeyboardShortcutChord, explicit?: AXPKeyboardShortcutDirectionBehavior): AXPKeyboardShortcutDirectionBehavior;
+/** Resolves the key the user presses for a semantically registered chord in RTL. */
+declare function resolveSemanticDirectionalKey(storedKey: string, rtl: boolean): string;
+/** Chord string with directional key mirrored for RTL display/matching when semantic. */
+declare function resolveDisplayShortcutChord(chord: AXPKeyboardShortcutChord, isRtl: boolean, explicitDirectionBehavior?: AXPKeyboardShortcutDirectionBehavior): string;
+interface ParsedShortcut {
+    ctrl: boolean;
+    shift: boolean;
+    alt: boolean;
+    meta: boolean;
+    key: string;
+}
+/**
+ * Parses a shortcut chord such as `Enter`, `Escape`, or `ctrl+shift+s`.
+ */
+declare function parseKeyboardShortcutChord(chord: AXPKeyboardShortcutChord): ParsedShortcut;
+/**
+ * Returns true when the keyboard event matches the given chord.
+ * On macOS, `ctrl+*` chords also match `meta+*` for common platform shortcuts.
+ */
+declare function matchesKeyboardShortcutChord(event: KeyboardEvent, chord: AXPKeyboardShortcutChord, options?: AXPKeyboardShortcutFormatOptions): boolean;
+/**
+ * Formats one chord for UI display (OS-aware modifier symbols).
+ */
+declare function formatKeyboardShortcutChord(chord: AXPKeyboardShortcutChord, options?: AXPKeyboardShortcutFormatOptions): string;
+/**
+ * Formats multiple chords as a single display string (e.g. `← / PgUp`).
+ */
+declare function formatKeyboardShortcutChords(chords: readonly AXPKeyboardShortcutChord[], options?: AXPKeyboardShortcutFormatOptions): string;
+/** Maps a chord to `ax-kbd-item` key parts (modifiers + display symbols). */
+declare function chordToKbdItemKeys(chord: AXPKeyboardShortcutChord, options?: AXPKeyboardShortcutFormatOptions): string[];
+/**
+ * When focus is in a native edit control, avoid stealing plain key shortcuts.
+ */
+declare function isKeyboardTargetInsideEditableField(target: EventTarget | null): boolean;
+/**
+ * Returns true when Esc should close an open widget overlay first (select, date picker, popover, modal).
+ * Used by the global shortcut registry so page-level Esc bindings do not swallow overlay dismiss.
+ */
+declare function shouldDeferEscapeToOpenOverlay(document: Document): boolean;
+declare function isMacPlatform(): boolean;
+
+/**
+ * Normalizes a declarative shortcut (`'ctrl+s'` or `{ keys: 'home', allowInEditableFields: false }`).
+ */
+declare function normalizeKeyboardShortcut(shortcut: AXPKeyboardShortcut): AXPResolvedKeyboardShortcut | undefined;
+/**
+ * Normalizes an array of declarative shortcuts. Empty or invalid entries are skipped.
+ */
+declare function normalizeKeyboardShortcuts(shortcuts?: readonly AXPKeyboardShortcut[]): AXPResolvedKeyboardShortcut[];
+/** Returns the first chord from declarative shortcuts (for UI hints such as `ax-kbd`). */
+declare function getPrimaryKeyboardShortcutChord(shortcuts?: readonly AXPKeyboardShortcut[]): AXPKeyboardShortcutChord | undefined;
+
+interface AXPKeyboardShortcutRegisterOptions extends AXPKeyboardShortcutRegistration {
+    /** Auto-unregister when the owner is destroyed. */
+    owner: DestroyRef;
+    /** When set, shortcuts are active only while the element is connected to the document. */
+    elementRef?: ElementRef<HTMLElement>;
+}
+declare class AXPKeyboardShortcutRegistry {
+    private readonly document;
+    private readonly localeService;
+    private readonly activeProfile;
+    private readonly registrations;
+    private helpDialogHandler;
+    private listenerAttached;
+    /** Active shortcut entries for the help dialog. */
+    readonly helpEntries: i0.Signal<AXPKeyboardShortcutHelpEntry[]>;
+    /**
+     * Registers a scope of shortcuts. Unregisters automatically when `owner` is destroyed.
+     */
+    register(options: AXPKeyboardShortcutRegisterOptions): void;
+    /**
+     * Wires the F1 help dialog opener (provided by platform/common).
+     */
+    setHelpDialogHandler(handler: () => void | Promise<void>): void;
+    /** OS-aware display string for UI hints. */
+    formatDisplayKeys(chords: readonly AXPKeyboardShortcutChord[]): string;
+    private ensureHelpShortcutRegistered;
+    private createRegistrationId;
+    private unregister;
+    private ensureListener;
+    private readonly onDocumentKeyDown;
+    private resolveActiveCandidates;
+    private isRegistrationActive;
+    private isRtlProfile;
+    private buildHelpEntries;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AXPKeyboardShortcutRegistry, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<AXPKeyboardShortcutRegistry>;
+}
+
 /**
  * Feature definition in module manifest.
  * Defines available features with default values.
@@ -2514,10 +2742,6 @@ interface AXPFeatureDefinition extends AXPModuleFeatureDefinition {
     key: string;
 }
 
-/**
- * Registered module manifests for select widgets via dataSource name {@link MODULE_MANIFESTS_DATASOURCE_NAME}.
- */
-declare const MODULE_MANIFESTS_DATASOURCE_NAME = "platform-module-manifests";
 /**
  * Data source definition for module names/titles from {@link AXPModuleManifestRegistry}.
  */
@@ -2709,6 +2933,16 @@ declare function sortByMultiLanguageString<T>(items: readonly T[], getValue: (it
  */
 declare function searchInMultiLanguageString(value: AXPMultiLanguageString | null | undefined, query: string, locale: string): boolean;
 
+/** Per-locale string map (`{ 'en-US': '...', 'fa-IR': '...' }`). */
+declare function isLocaleStringMap(value: unknown): value is Record<string, string>;
+/**
+ * Use locale-map read/write when the option is on or live/saved data is already a map.
+ * Auto-enables when API data is a map but the editor option was left off.
+ */
+declare function shouldUseLocaleMapShape(localeMapOptionEnabled: boolean, current: unknown, saved: unknown): boolean;
+/** Updates one locale entry; preserves sibling locales from current or saved map. */
+declare function buildLocaleTextMapValue(current: unknown, saved: unknown, lang: string, input: string): Record<string, string> | null;
+
 /**
  * Represents a tag with text, color, and metadata
  */
@@ -2909,16 +3143,6 @@ declare class AXPDeviceService {
     static ɵprov: i0.ɵɵInjectableDeclaration<AXPDeviceService>;
 }
 
-/**
- * Returns whether `current` differs from the saved/clean `baseline` snapshot.
- * Used by entity details pages, layout-builder dialogs, and {@link AXPContextStore}.
- */
-declare function isFormContextDirty(current: Record<string, unknown>, baseline: Record<string, unknown>): boolean;
-/**
- * Clones a context object for use as a dirty-tracking baseline.
- */
-declare function captureFormContextBaseline(context: Record<string, unknown>): Record<string, unknown>;
-
 /**
  * Service for applying and resetting text highlighting within specified HTML elements.
  */
@@ -2982,6 +3206,26 @@ declare function getEnumValues(enumType: any): {
     id: string;
     title: string;
 }[];
+/**
+ * Semantic equality for lookup/select values when restoring saved baseline shape.
+ * Compares by selection identity (id), including two full items with the same id.
+ */
+declare function isSelectionValueEqual(a: unknown, b: unknown): boolean;
+/**
+ * Semantic equality for dirty-state and baseline checks.
+ * Prefer over lodash `isEqual` when comparing user-edited form/context data to a saved baseline.
+ *
+ * Arrays: `[]`, `null`, and all-empty lists are equivalent; non-empty arrays compare as multisets (order ignored).
+ */
+declare function isFormValueEqual(a: unknown, b: unknown): boolean;
+/**
+ * Returns whether `current` differs from the saved/clean `baseline` snapshot.
+ */
+declare function isFormContextDirty(current: Record<string, unknown>, baseline: Record<string, unknown>): boolean;
+/**
+ * Clones a context object for use as a dirty-tracking baseline.
+ */
+declare function captureFormContextBaseline(context: Record<string, unknown>): Record<string, unknown>;
 
 /**
  * Creates a provider instance within an injection context.
@@ -3053,5 +3297,5 @@ declare function containsHtmlMarkup(value: string | null | undefined): boolean;
  */
 declare function generateKebabCase(title: string): string;
 
-export { AXHighlightService, AXPActivityLogProvider, AXPActivityLogService, AXPAppStartUpProvider, AXPAppStartUpService, AXPBroadcastEventService, AXPCatalogScopeDefinitionProviderService, AXPCatalogScopeDefinitionsDataSourceDefinition, AXPColorPaletteProvider, AXPColorPaletteService, AXPColumnWidthService, AXPComponentLogoConfig, AXPComponentSlot, AXPComponentSlotDirective, AXPComponentSlotModule, AXPComponentSlotRegistryService, AXPContentCheckerDirective, AXPContextChangeEvent, AXPContextDefinitionProviderService, AXPContextStore, AXPCountdownPipe, AXPDataGenerator, AXPDataSourceDefinitionProviderService, AXPDblClickDirective, AXPDefaultColorPalettesProvider, AXPDeviceService, AXPDeviceType, AXPDistributedEventListenerService, AXPElementDataDirective, AXPExportTemplateToken, AXPExpressionEvaluatorScopeProviderContext, AXPExpressionEvaluatorScopeProviderService, AXPExpressionEvaluatorService, AXPFeatureDefinitionProviderContext, AXPGridLayoutDirective, AXPHookService, AXPIconLogoConfig, AXPImageUrlLogoConfig, AXPModuleManifestModule, AXPModuleManifestRegistry, AXPModuleManifestsDataSourceDefinition, AXPPlatformScope, AXPScreenSize, AXPSystemActionType, AXPSystemActions, AXPTagProvider, AXPTagService, AXP_ACTIVITY_LOG_PROVIDER, AXP_CATALOG_SCOPE_DEFINITION_PROVIDER, AXP_COLOR_PALETTE_PROVIDER, AXP_COLUMN_WIDTH_PROVIDER, AXP_CONTEXT_DEFINITION_PROVIDER, AXP_DATASOURCE_DEFINITION_PROVIDER, AXP_DISTRIBUTED_EVENT_LISTENER_PROVIDER, AXP_EXPRESSION_EVALUATOR_SCOPE_PROVIDER, AXP_FEATURE_DEFINITION_PROVIDER, AXP_MODULE_MANIFEST_PROVIDER, AXP_SESSION_SERVICE, AXP_TAG_PROVIDER, MODULE_MANIFESTS_DATASOURCE_NAME, PLATFORM_CATALOG_SCOPES_DATASOURCE_NAME, applyFilterArray, applyPagination, applyQueryArray, applySortArray, applySystemActionDefault, captureFormContextBaseline, cleanDeep, coerceUnknownToBoolean, coerceUnknownToDate, coerceUnknownToFiniteNumber, coerceUnknownToTrimmedString, compareMultiLanguageStrings, containsHtmlMarkup, createProviderWithInjectionContext, defaultColumnWidthProvider, extractNestedFieldsWildcard, extractTextFromHtml, extractValue, generateKebabCase, getActionButton, getChangedPaths, getDetailedChanges, getEnumValues, getNestedKeys, getSmart, getSystemActions, isFormContextDirty, normalizeDefinitionCategories, objectKeyValueTransforms, provideLazyProvider, resolveActionLook, resolvePlatformScopeKey, resolvePlatformScopeName, searchInMultiLanguageString, setSmart, sortByMultiLanguageString, unwrapValueProperty };
-export type { AXPActionMenuItem, AXPActivityLog, AXPActivityLogChange, AXPApplicationUserReference, AXPBackButton, AXPBadge, AXPBreadcrumbItem, AXPCatalogScopeDefinition, AXPCatalogScopeDefinitionProvider, AXPCategorizedEntity, AXPCategorizedEntityDto, AXPCategoryEntity, AXPCategoryEntityWithItems, AXPCategoryListItem, AXPColorPalette, AXPColorPaletteFilterOptions, AXPColumnQuery, AXPColumnWidthMatcher, AXPColumnWidthProvider, AXPCommandMessage, AXPComponentSlotConfig, AXPComponentSlotModuleConfigs, AXPContent, AXPContentDirection, AXPContentType, AXPContextData, AXPContextDefinition, AXPContextDefinitionAiHints, AXPContextDefinitionProvider, AXPContextPatchOptions, AXPContextState, AXPContextUpdateOptions, AXPContextUpdateOrigin, AXPDataSource, AXPDataSourceArray, AXPDataSourceDataFieldDefinition, AXPDataSourceDefinition, AXPDataSourceDefinitionProvider, AXPDataSourceSample, AXPDataSourceType, AXPDataSourceValue, AXPDataType, AXPDefinitionCategory, AXPDistributedEventListenerProvider, AXPDistributedEventListenerProviderToken, AXPEntityOp, AXPEntityReference, AXPEqualValidationRule, AXPExecuteCommand, AXPExecuteCommandResult, AXPExportCsvOptions, AXPExportExcelOptions, AXPExportOptions, AXPExportPdfOptions, AXPExportPrintOptions, AXPExpression, AXPExpressionEvaluatorScope, AXPExpressionEvaluatorScopeProvider, AXPExpressionEvaluatorScopeProviders, AXPFeatureDefinition, AXPFeatureDefinitionProvider, AXPFeatureName, AXPFileListItem, AXPFileSource, AXPFileStatus, AXPFilterClause, AXPFilterDefinition, AXPFilterQuery, AXPFilterTriggerDefinition, AXPFlowDirection, AXPGridLayoutOptions, AXPGridPlacement, AXPISessionService, AXPLazyDataSource, AXPLogoConfig, AXPMaxLengthValidationRule, AXPMaybePromise, AXPMetaData, AXPMiddlewareErrorResponse, AXPMinLengthValidationRule, AXPModuleFeatureDefinition, AXPModuleFeatureDefinitionWithKey, AXPModuleManifest, AXPMultiLanguageString, AXPNavigateActionCommand, AXPNavigateActionOptions, AXPOptionsData, AXPPageStatus, AXPPagedListResult, AXPPartialNested, AXPPlatformScopeKey, AXPProperty, AXPPropertyGroup, AXPPropertyInterface, AXPQueryFetchResult, AXPQueryRequest, AXPReqexValidationRule, AXPRequiredValidationRule, AXPSortDefinition, AXPSortQuery, AXPStartUpTask, AXPStringValidationRules, AXPSystemAction, AXPTag, AXPTagFilterOptions, AXPUserReference, AXPValidationRule, AXPValidationRules, AXPValueTransformerFunction, AXPValueTransformerFunctions, AXPValueUnit, AXPValueUnits, AXPViewBlockDefinition, AXPViewDefinition, AXPViewFieldDefinition, AXPViewQuery, AXPWidgetTrigger, AXPWidgetTriggers, ColumnNameMatcher, ColumnWidthValue, IColumnWithWidth, WidgetTypeMatcher };
+export { AXHighlightService, AXPActivityLogProvider, AXPActivityLogService, AXPAppStartUpProvider, AXPAppStartUpService, AXPBroadcastEventService, AXPCatalogScopeDefinitionProviderService, AXPCatalogScopeDefinitionsDataSourceDefinition, AXPColorPaletteProvider, AXPColorPaletteService, AXPColumnWidthService, AXPComponentLogoConfig, AXPComponentSlot, AXPComponentSlotDirective, AXPComponentSlotModule, AXPComponentSlotRegistryService, AXPContentCheckerDirective, AXPContextChangeEvent, AXPContextDefinitionProviderService, AXPContextStore, AXPCountdownPipe, AXPDataGenerator, AXPDataSourceDefinitionProviderService, AXPDblClickDirective, AXPDefaultColorPalettesProvider, AXPDeviceService, AXPDeviceType, AXPDistributedEventListenerService, AXPElementDataDirective, AXPExportTemplateToken, AXPExpressionEvaluatorScopeProviderContext, AXPExpressionEvaluatorScopeProviderService, AXPExpressionEvaluatorService, AXPFeatureDefinitionProviderContext, AXPGridLayoutDirective, AXPHookService, AXPIconLogoConfig, AXPImageUrlLogoConfig, AXPKeyboardShortcutPriority, AXPKeyboardShortcutRegistry, AXPModuleManifestModule, AXPModuleManifestRegistry, AXPModuleManifestsDataSourceDefinition, AXPPlatformCoreDataSourceKeys, AXPPlatformScope, AXPScreenSize, AXPSystemActionType, AXPSystemActions, AXPTagProvider, AXPTagService, AXP_ACTIVITY_LOG_PROVIDER, AXP_CATALOG_SCOPE_DEFINITION_PROVIDER, AXP_COLOR_PALETTE_PROVIDER, AXP_COLUMN_WIDTH_PROVIDER, AXP_CONTEXT_DEFINITION_PROVIDER, AXP_DATASOURCE_DEFINITION_PROVIDER, AXP_DISTRIBUTED_EVENT_LISTENER_PROVIDER, AXP_EXPRESSION_EVALUATOR_SCOPE_PROVIDER, AXP_FEATURE_DEFINITION_PROVIDER, AXP_MODULE_MANIFEST_PROVIDER, AXP_SESSION_SERVICE, AXP_TAG_PROVIDER, AX_OVERLAY_CONTAINER_SELECTOR, AX_OVERLAY_PANE_SELECTOR, applyFilterArray, applyPagination, applyQueryArray, applySortArray, applySystemActionDefault, buildLocaleTextMapValue, captureFormContextBaseline, chordToKbdItemKeys, cleanDeep, coerceUnknownToBoolean, coerceUnknownToDate, coerceUnknownToFiniteNumber, coerceUnknownToTrimmedString, compareMultiLanguageStrings, containsHtmlMarkup, createProviderWithInjectionContext, defaultColumnWidthProvider, extractNestedFieldsWildcard, extractTextFromHtml, extractValue, findOverlayContainerAncestor, formatKeyboardShortcutChord, formatKeyboardShortcutChords, generateKebabCase, getActionButton, getChangedPaths, getDetailedChanges, getEnumValues, getNestedKeys, getNestedVisibleOverlayPanes, getPrimaryKeyboardShortcutChord, getSmart, getSystemActions, getTopVisibleOverlayContainer, getVisibleAnchoredOverlayPanes, getVisibleOverlayContainers, hasForegroundOverlayLayer, isFormContextDirty, isFormValueEqual, isHorizontalDirectionalShortcutKey, isKeyboardTargetInsideEditableField, isLocaleStringMap, isMacPlatform, isSelectionValueEqual, isVisibleOverlayElement, matchesKeyboardShortcutChord, mirrorHorizontalDirectionalKey, normalizeDefinitionCategories, normalizeKeyboardShortcut, normalizeKeyboardShortcuts, objectKeyValueTransforms, parseKeyboardShortcutChord, provideLazyProvider, resolveActionLook, resolveDisplayShortcutChord, resolveEffectiveDirectionBehavior, resolvePlatformScopeKey, resolvePlatformScopeName, resolveSemanticDirectionalKey, searchInMultiLanguageString, setSmart, shouldDeferEscapeToOpenOverlay, shouldUseLocaleMapShape, sortByMultiLanguageString, unwrapValueProperty };
+export type { AXPActionMenuItem, AXPActivityLog, AXPActivityLogChange, AXPApplicationUserReference, AXPBackButton, AXPBadge, AXPBreadcrumbItem, AXPCatalogScopeDefinition, AXPCatalogScopeDefinitionProvider, AXPCategorizedEntity, AXPCategorizedEntityDto, AXPCategoryEntity, AXPCategoryEntityWithItems, AXPCategoryListItem, AXPColorPalette, AXPColorPaletteFilterOptions, AXPColumnQuery, AXPColumnWidthMatcher, AXPColumnWidthProvider, AXPCommandMessage, AXPComponentSlotConfig, AXPComponentSlotModuleConfigs, AXPContent, AXPContentDirection, AXPContentType, AXPContextData, AXPContextDefinition, AXPContextDefinitionAiHints, AXPContextDefinitionProvider, AXPContextPatchOptions, AXPContextState, AXPContextUpdateOptions, AXPContextUpdateOrigin, AXPDataSource, AXPDataSourceArray, AXPDataSourceDataFieldDefinition, AXPDataSourceDefinition, AXPDataSourceDefinitionProvider, AXPDataSourceSample, AXPDataSourceType, AXPDataSourceValue, AXPDataType, AXPDefinitionCategory, AXPDistributedEventListenerProvider, AXPDistributedEventListenerProviderToken, AXPEntityOp, AXPEntityReference, AXPEqualValidationRule, AXPExecuteCommand, AXPExecuteCommandResult, AXPExportCsvOptions, AXPExportExcelOptions, AXPExportOptions, AXPExportPdfOptions, AXPExportPrintOptions, AXPExpression, AXPExpressionEvaluatorScope, AXPExpressionEvaluatorScopeProvider, AXPExpressionEvaluatorScopeProviders, AXPFeatureDefinition, AXPFeatureDefinitionProvider, AXPFeatureName, AXPFileListItem, AXPFileSource, AXPFileStatus, AXPFilterClause, AXPFilterDefinition, AXPFilterQuery, AXPFilterTriggerDefinition, AXPFlowDirection, AXPGridLayoutOptions, AXPGridPlacement, AXPISessionService, AXPKeyboardShortcut, AXPKeyboardShortcutBinding, AXPKeyboardShortcutChord, AXPKeyboardShortcutConfig, AXPKeyboardShortcutDirectionBehavior, AXPKeyboardShortcutFormatOptions, AXPKeyboardShortcutHelpEntry, AXPKeyboardShortcutRegisterOptions, AXPKeyboardShortcutRegistration, AXPLazyDataSource, AXPLogoConfig, AXPMaxLengthValidationRule, AXPMaybePromise, AXPMetaData, AXPMiddlewareErrorResponse, AXPMinLengthValidationRule, AXPModuleFeatureDefinition, AXPModuleFeatureDefinitionWithKey, AXPModuleManifest, AXPMultiLanguageString, AXPNavigateActionCommand, AXPNavigateActionOptions, AXPOptionsData, AXPPageStatus, AXPPagedListResult, AXPPartialNested, AXPPlatformScopeKey, AXPProperty, AXPPropertyGroup, AXPPropertyInterface, AXPQueryFetchResult, AXPQueryRequest, AXPReqexValidationRule, AXPRequiredValidationRule, AXPResolvedKeyboardShortcut, AXPSortDefinition, AXPSortQuery, AXPStartUpTask, AXPStringValidationRules, AXPSystemAction, AXPTag, AXPTagFilterOptions, AXPUserReference, AXPValidationRule, AXPValidationRules, AXPValueTransformerFunction, AXPValueTransformerFunctions, AXPValueUnit, AXPValueUnits, AXPViewBlockDefinition, AXPViewDefinition, AXPViewFieldDefinition, AXPViewQuery, AXPWidgetTrigger, AXPWidgetTriggers, ColumnNameMatcher, ColumnWidthValue, IColumnWithWidth, WidgetTypeMatcher };

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

@@ -7,19 +7,20 @@ import { AXPWidgetNode, AXPWidgetRenderMode, AXPWidgetContainerComponent, AXPWid
 import { AXDataSource, AXComponentClosing } from '@acorex/cdk/common';
 import { AXPopupSizeType } from '@acorex/components/popup';
 import { AXStepWizardLook } from '@acorex/components/step-wizard';
-import { AXPActionMenuItem, AXPMultiLanguageString, AXPMetaData, AXPGridLayoutOptions, 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';
 
-type AXPDialogActionShortcut = string;
+/** 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'`).
+     * 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?: AXPDialogActionShortcut[];
+    shortcuts?: AXPKeyboardShortcut[];
 }
 
 /**
@@ -461,10 +462,9 @@ type WidgetBuilderState = AXPWidgetNode & {
 type FormFieldBuilderState = AXPWidgetNode & {
     layout?: AXPGridLayoutOptions;
 };
-/** Dialog footer action item; extends menu actions with placement and keyboard shortcuts. */
+/** Dialog footer action item; extends menu actions with placement. */
 type AXPDialogActionMenuItem = AXPActionMenuItem & {
     position?: 'prefix' | 'suffix';
-    shortcuts?: AXPDialogActionShortcut[];
 };
 type DialogBuilderState = AXPWidgetNode & {
     layout?: AXPGridLayoutOptions;
@@ -943,7 +943,7 @@ declare class AXPDialogRendererComponent extends AXBasePageComponent implements
     private expressionEvaluator;
     private readonly commandService;
     private readonly hookService;
-    private readonly dialogService;
+    private readonly unsavedChangesConfirm;
     private readonly overlayService;
     private readonly translationService;
     private readonly document;
@@ -951,18 +951,12 @@ declare class AXPDialogRendererComponent extends AXBasePageComponent implements
     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?;
+    /** 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;
@@ -991,12 +985,7 @@ declare class AXPDialogRendererComponent extends AXBasePageComponent implements
     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 getWidgetContainer;
     private layoutRenderer;
     private debounceTimer?;
     handleContextChanged(event: any): void;
@@ -1009,7 +998,6 @@ declare class AXPDialogRendererComponent extends AXBasePageComponent implements
     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`). */