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

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';
@@ -1193,6 +1193,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 +1287,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;
@@ -1566,6 +1652,104 @@ declare class AXPActivityLogService {
     static ɵprov: i0.ɵɵInjectableDeclaration<AXPActivityLogService>;
 }
 
+/**
+ * Stable catalog scope registered by a module provider (integration contract).
+ */
+interface AXPCatalogScopeDefinition {
+    /** Unique key, e.g. `human-capital-management.hr`. */
+    name: string;
+    title: string | AXPMultiLanguageString;
+    description?: string | AXPMultiLanguageString;
+    /**
+     * Entity refs this scope may label, e.g. `AssessmentManagement.Questionnaire`.
+     */
+    targets: string[];
+    icon?: string;
+    /**
+     * Platform utility classes applied to the whole scope badge (surface, on-surface, border).
+     * Example: `ax-primary-surface ax-text-on-primary-surface ax-border-border-primary-surface`.
+     */
+    cssClass?: string;
+    order?: number;
+}
+
+interface AXPCatalogScopeDefinitionProvider {
+    items(): Promise<AXPCatalogScopeDefinition[]>;
+}
+declare const AXP_CATALOG_SCOPE_DEFINITION_PROVIDER: InjectionToken<AXPCatalogScopeDefinitionProvider[]>;
+
+/**
+ * Collects {@link AXPCatalogScopeDefinition} entries from all registered providers.
+ */
+declare class AXPCatalogScopeDefinitionProviderService {
+    private readonly providers;
+    private readonly translation;
+    items(): Promise<AXPCatalogScopeDefinition[]>;
+    get(name: string): Promise<AXPCatalogScopeDefinition | undefined>;
+    /**
+     * Scopes applicable to the given entity ref (`Module.Entity`).
+     */
+    byTarget(entityRef: string): Promise<AXPCatalogScopeDefinition[]>;
+    /**
+     * Resolves display title for a scope key (active locale).
+     */
+    resolveTitle(definition: AXPCatalogScopeDefinition): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AXPCatalogScopeDefinitionProviderService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<AXPCatalogScopeDefinitionProviderService>;
+}
+
+interface AXPDataSourceDataFieldDefinition {
+    name: string;
+    title: string;
+    datatype: string;
+    type: string;
+    options?: AXPOptionsData;
+}
+type AXPLazyDataSource<T = unknown> = AXPMaybePromise<AXDataSource<T>>;
+type AXPDataSourceArray<T = unknown> = AXPMaybePromise<Array<T>>;
+type AXPDataSourceValue<T = unknown> = AXPMaybePromise<T>;
+type AXPDataSourceType<T = any> = AXPLazyDataSource<T> | AXPDataSourceArray<T> | AXPDataSourceValue<T>;
+type AXPDataSourceSample<T = any> = AXPDataSourceArray<T> | AXPDataSourceValue<T>;
+interface AXPDataSourceDefinition<T = any> {
+    name: string;
+    title: string;
+    valueField?: {
+        name: string;
+        title: string;
+    };
+    textField?: {
+        name: string;
+        title: string;
+    };
+    columns: AXPDataSourceDataFieldDefinition[];
+    filters: AXPFilterDefinition[];
+    samples?: AXPDataSourceSample<T>;
+    visible?: boolean;
+    source: () => AXPDataSourceType<T>;
+}
+interface AXPDataSourceDefinitionProvider {
+    items(): Promise<AXPDataSourceDefinition[]>;
+}
+declare const AXP_DATASOURCE_DEFINITION_PROVIDER: InjectionToken<AXPDataSourceDefinitionProvider[]>;
+declare class AXPDataSourceDefinitionProviderService implements AXPDataSourceDefinitionProvider {
+    private providers;
+    items(): Promise<AXPDataSourceDefinition[]>;
+    get<T = any>(name: string): Promise<AXPDataSourceDefinition<T> | undefined>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AXPDataSourceDefinitionProviderService, never>;
+    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}.
+ */
+declare class AXPCatalogScopeDefinitionsDataSourceDefinition implements AXPDataSourceDefinitionProvider {
+    private readonly catalogScopeRegistry;
+    items(): Promise<AXPDataSourceDefinition[]>;
+    private readTargetFilter;
+}
+
 /**
  * Represents a color palette with a unique identifier and collection of colors
  */
@@ -1851,6 +2035,14 @@ declare const AXP_COLUMN_WIDTH_PROVIDER: InjectionToken<AXPColumnWidthProvider[]
 declare const defaultColumnWidthProvider: AXPColumnWidthProvider;
 
 type AXPContextState = 'initiated' | 'restored' | 'changed' | 'patch';
+type AXPContextUpdateOrigin = 'user' | 'system';
+interface AXPContextUpdateOptions {
+    origin?: AXPContextUpdateOrigin;
+}
+interface AXPContextPatchOptions {
+    /** When true, updates the saved snapshot together with live data. */
+    updateSaved?: boolean;
+}
 type AXPContextData = {
     [key: string]: any;
 };
@@ -1860,33 +2052,43 @@ declare class AXPContextChangeEvent {
     path?: string;
     state: AXPContextState;
     data: any;
+    origin?: AXPContextUpdateOrigin;
+    /** 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<{}>;
+    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>;
     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) => void;
-    patch: (context: Record<string, any>, skipDirtyTracking?: boolean) => void;
+    update: (path: string, value: any, options?: AXPContextUpdateOptions) => void;
+    applyObjectPaths: (obj: Record<string, unknown>, options?: AXPContextUpdateOptions, prefix?: string) => 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;
+    commitSaved: () => void;
+    applyParentBind: (merged: AXPContextData) => void;
 } & _ngrx_signals.StateSource<{
     data: AXPContextData;
     state: AXPContextState;
-    initialSnapshot: {};
-    previousSnapshot: {};
+    savedSnapshot: AXPContextData;
+    previousSnapshot: AXPContextData;
     lastChange: AXPContextChangeEvent;
 }>>;
 
@@ -1920,29 +2122,36 @@ declare class AXPComponentSlotDirective implements OnInit {
     contextStore: {
         data: i0.Signal<AXPContextData>;
         state: i0.Signal<_acorex_platform_core.AXPContextState>;
-        initialSnapshot: i0.Signal<{}>;
-        previousSnapshot: i0.Signal<{}>;
+        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>;
         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) => void;
-        patch: (context: Record<string, any>, skipDirtyTracking?: boolean) => void;
+        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>, 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;
+        commitSaved: () => void;
+        applyParentBind: (merged: AXPContextData) => void;
     } & _ngrx_signals.StateSource<{
         data: AXPContextData;
         state: _acorex_platform_core.AXPContextState;
-        initialSnapshot: {};
-        previousSnapshot: {};
+        savedSnapshot: AXPContextData;
+        previousSnapshot: AXPContextData;
         lastChange: _acorex_platform_core.AXPContextChangeEvent;
     }>;
     isEmpty: i0.Signal<boolean>;
@@ -2074,47 +2283,6 @@ type AXPValueTransformerFunctions = {
 };
 declare function objectKeyValueTransforms(keyName: string): AXPValueTransformerFunctions;
 
-interface AXPDataSourceDataFieldDefinition {
-    name: string;
-    title: string;
-    datatype: string;
-    type: string;
-    options?: AXPOptionsData;
-}
-type AXPLazyDataSource<T = unknown> = AXPMaybePromise<AXDataSource<T>>;
-type AXPDataSourceArray<T = unknown> = AXPMaybePromise<Array<T>>;
-type AXPDataSourceValue<T = unknown> = AXPMaybePromise<T>;
-type AXPDataSourceType<T = any> = AXPLazyDataSource<T> | AXPDataSourceArray<T> | AXPDataSourceValue<T>;
-type AXPDataSourceSample<T = any> = AXPDataSourceArray<T> | AXPDataSourceValue<T>;
-interface AXPDataSourceDefinition<T = any> {
-    name: string;
-    title: string;
-    valueField?: {
-        name: string;
-        title: string;
-    };
-    textField?: {
-        name: string;
-        title: string;
-    };
-    columns: AXPDataSourceDataFieldDefinition[];
-    filters: AXPFilterDefinition[];
-    samples?: AXPDataSourceSample<T>;
-    visible?: boolean;
-    source: () => AXPDataSourceType<T>;
-}
-interface AXPDataSourceDefinitionProvider {
-    items(): Promise<AXPDataSourceDefinition[]>;
-}
-declare const AXP_DATASOURCE_DEFINITION_PROVIDER: InjectionToken<AXPDataSourceDefinitionProvider[]>;
-declare class AXPDataSourceDefinitionProviderService implements AXPDataSourceDefinitionProvider {
-    private providers;
-    items(): Promise<AXPDataSourceDefinition[]>;
-    get<T = any>(name: string): Promise<AXPDataSourceDefinition<T> | undefined>;
-    static ɵfac: i0.ɵɵFactoryDeclaration<AXPDataSourceDefinitionProviderService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<AXPDataSourceDefinitionProviderService>;
-}
-
 declare class AXPContentCheckerDirective {
     viewContainerRef: ViewContainerRef;
     elementRef: ElementRef<HTMLDivElement>;
@@ -2322,6 +2490,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.
@@ -2629,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
  */
@@ -2892,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.
@@ -2963,5 +3297,5 @@ declare function containsHtmlMarkup(value: string | null | undefined): boolean;
  */
 declare function generateKebabCase(title: string): string;
 
-export { AXHighlightService, AXPActivityLogProvider, AXPActivityLogService, AXPAppStartUpProvider, AXPAppStartUpService, AXPBroadcastEventService, 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_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, applyFilterArray, applyPagination, applyQueryArray, applySortArray, applySystemActionDefault, cleanDeep, coerceUnknownToBoolean, coerceUnknownToDate, coerceUnknownToFiniteNumber, coerceUnknownToTrimmedString, compareMultiLanguageStrings, containsHtmlMarkup, createProviderWithInjectionContext, defaultColumnWidthProvider, extractNestedFieldsWildcard, extractTextFromHtml, extractValue, generateKebabCase, getActionButton, getChangedPaths, getDetailedChanges, getEnumValues, getNestedKeys, getSmart, getSystemActions, normalizeDefinitionCategories, objectKeyValueTransforms, provideLazyProvider, resolveActionLook, resolvePlatformScopeKey, resolvePlatformScopeName, searchInMultiLanguageString, setSmart, sortByMultiLanguageString, unwrapValueProperty };
-export type { AXPActionMenuItem, AXPActivityLog, AXPActivityLogChange, AXPApplicationUserReference, AXPBackButton, AXPBadge, AXPBreadcrumbItem, AXPCategorizedEntity, AXPCategorizedEntityDto, AXPCategoryEntity, AXPCategoryEntityWithItems, AXPCategoryListItem, AXPColorPalette, AXPColorPaletteFilterOptions, AXPColumnQuery, AXPColumnWidthMatcher, AXPColumnWidthProvider, AXPCommandMessage, AXPComponentSlotConfig, AXPComponentSlotModuleConfigs, AXPContent, AXPContentDirection, AXPContentType, AXPContextData, AXPContextDefinition, AXPContextDefinitionAiHints, AXPContextDefinitionProvider, AXPContextState, 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, 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, MODULE_MANIFESTS_DATASOURCE_NAME, PLATFORM_CATALOG_SCOPES_DATASOURCE_NAME, 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 };