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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@acorex/platform",
-  "version": "21.0.0-next.70",
+  "version": "21.0.0-next.71",
   "peerDependencies": {
     "@acorex/cdk": "^19.0.0 || ^20.0.0 || ^21.0.0-next.0 || ^21.0.2-next.0",
     "@acorex/core": "^19.0.0 || ^20.0.0 || ^21.0.0-next.0 || ^21.0.2-next.0",

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

@@ -2642,6 +2642,7 @@ declare enum AXPSystemStatusType {
     Draft = "draft",
     PendingReview = "pending-review",
     WaitingSignOff = "waiting-sign-off",
+    WaitingApproval = "waiting-approval",
     Approved = "approved",
     Published = "published",
     Archived = "archived",
@@ -2771,6 +2772,16 @@ declare const AXPSystemStatuses: Readonly<{
         readonly isInitial: false;
         readonly isFinal: false;
     };
+    readonly WaitingApproval: {
+        readonly name: AXPSystemStatusType.WaitingApproval;
+        readonly title: string;
+        readonly icon: "fa-light fa-clock";
+        readonly color: "warning";
+        readonly description: string;
+        readonly order: 1;
+        readonly isInitial: true;
+        readonly isFinal: false;
+    };
     readonly Approved: {
         readonly name: AXPSystemStatusType.Approved;
         readonly title: string;

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

@@ -1566,6 +1566,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 +1949,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 {
+    skipDirtyTracking?: boolean;
+    origin?: AXPContextUpdateOrigin;
+}
 type AXPContextData = {
     [key: string]: any;
 };
@@ -1860,33 +1966,42 @@ declare class AXPContextChangeEvent {
     path?: string;
     state: AXPContextState;
     data: any;
+    origin?: AXPContextUpdateOrigin;
+    /** Aggregated form dirty flag (user context paths + 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[]>;
     lastChange: _ngrx_signals.DeepSignal<AXPContextChangeEvent>;
     isChanged: i0.Signal<boolean>;
     isReset: i0.Signal<boolean>;
     isInitiated: i0.Signal<boolean>;
     isEmpty: i0.Signal<boolean>;
     isDirty: i0.Signal<boolean>;
+    isUserDirty: i0.Signal<boolean>;
     snapshot: i0.Signal<AXPContextData>;
     initial: i0.Signal<{}>;
     previous: i0.Signal<{}>;
     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>, second?: boolean | AXPContextPatchOptions) => void;
     reset: () => void;
     set: (initialData: any) => void;
     getValue: (path: string) => any;
     hasValue: (path: string) => boolean;
+    commitBaseline: () => void;
+    clearUserDirtyPaths: () => void;
 } & _ngrx_signals.StateSource<{
     data: AXPContextData;
     state: AXPContextState;
     initialSnapshot: {};
     previousSnapshot: {};
+    userDirtyPaths: string[];
     lastChange: AXPContextChangeEvent;
 }>>;
 
@@ -1922,27 +2037,33 @@ declare class AXPComponentSlotDirective implements OnInit {
         state: i0.Signal<_acorex_platform_core.AXPContextState>;
         initialSnapshot: i0.Signal<{}>;
         previousSnapshot: i0.Signal<{}>;
+        userDirtyPaths: i0.Signal<string[]>;
         lastChange: _ngrx_signals.DeepSignal<_acorex_platform_core.AXPContextChangeEvent>;
         isChanged: i0.Signal<boolean>;
         isReset: i0.Signal<boolean>;
         isInitiated: i0.Signal<boolean>;
         isEmpty: i0.Signal<boolean>;
         isDirty: i0.Signal<boolean>;
+        isUserDirty: i0.Signal<boolean>;
         snapshot: i0.Signal<AXPContextData>;
         initial: i0.Signal<{}>;
         previous: i0.Signal<{}>;
         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>, second?: boolean | _acorex_platform_core.AXPContextPatchOptions) => void;
         reset: () => void;
         set: (initialData: any) => void;
         getValue: (path: string) => any;
         hasValue: (path: string) => boolean;
+        commitBaseline: () => void;
+        clearUserDirtyPaths: () => void;
     } & _ngrx_signals.StateSource<{
         data: AXPContextData;
         state: _acorex_platform_core.AXPContextState;
         initialSnapshot: {};
         previousSnapshot: {};
+        userDirtyPaths: string[];
         lastChange: _acorex_platform_core.AXPContextChangeEvent;
     }>;
     isEmpty: i0.Signal<boolean>;
@@ -2074,47 +2195,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>;
@@ -2829,6 +2909,16 @@ 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.
  */
@@ -2963,5 +3053,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, 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 };

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

@@ -4,13 +4,24 @@ 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 { AXPActionMenuItem, AXPMultiLanguageString, AXPMetaData, AXPGridLayoutOptions, AXPExpression, AXPValidationRules, AXPOptionsData, AXPContextChangeEvent, AXPExecuteCommandResult } from '@acorex/platform/core';
 import { AXBasePageComponent } from '@acorex/components/page';
 import { AXPCommand } from '@acorex/platform/runtime';
 
+type AXPDialogActionShortcut = string;
+declare const DEFAULT_CANCEL_DIALOG_ACTION_SHORTCUTS: readonly AXPDialogActionShortcut[];
+declare const DEFAULT_SUBMIT_DIALOG_ACTION_SHORTCUTS: readonly AXPDialogActionShortcut[];
+interface AXPDialogActionOptions {
+    /**
+     * Additional keyboard shortcuts for this action (e.g. `'ctrl+s'`).
+     * Merged with built-in defaults for `cancel` / `submit`. Pass `[]` to disable all shortcuts.
+     */
+    shortcuts?: AXPDialogActionShortcut[];
+}
+
 /**
  * Extended widget node properties (excluding type, path, name, options, children)
  * These properties can be passed as a third parameter to customWidget method
@@ -254,6 +265,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 +280,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 +301,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 +461,25 @@ type WidgetBuilderState = AXPWidgetNode & {
 type FormFieldBuilderState = AXPWidgetNode & {
     layout?: AXPGridLayoutOptions;
 };
+/** Dialog footer action item; extends menu actions with placement and keyboard shortcuts. */
+type AXPDialogActionMenuItem = AXPActionMenuItem & {
+    position?: 'prefix' | 'suffix';
+    shortcuts?: AXPDialogActionShortcut[];
+};
 type DialogBuilderState = AXPWidgetNode & {
     layout?: AXPGridLayoutOptions;
     dialogOptions?: AXPDialogContainerOptions;
     actions?: {
         footer?: {
-            prefix?: AXPActionMenuItem[];
-            suffix?: AXPActionMenuItem[];
+            prefix?: AXPDialogActionMenuItem[];
+            suffix?: AXPDialogActionMenuItem[];
         };
     };
 };
 interface IActionBuilder {
-    cancel(text?: string): IActionBuilder;
-    submit(text?: string): IActionBuilder;
-    custom(action: AXPActionMenuItem & {
-        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,27 @@ declare class AXPDialogRendererComponent extends AXBasePageComponent implements
     private expressionEvaluator;
     private readonly commandService;
     private readonly hookService;
+    private readonly dialogService;
+    private readonly overlayService;
+    private readonly translationService;
+    private readonly document;
+    private readonly host;
     private dialogResult?;
     /** Ensures `show()` resolves once when the dialog closes (footer action or header close). */
     private callbackInvoked;
+    /** Baseline snapshot for dirty detection (captured once after init settles). */
+    private dirtyBaseline?;
+    /** True after the post-init baseline snapshot has been captured. */
+    private dirtyBaselineCaptured;
+    private dirtyBaselineIdleTimer?;
+    /** Callback payload applied when a dismiss is allowed in {@link onClosing}. */
+    private pendingDismissResolvePayload?;
+    /** Skips dirty confirmation on the next {@link onClosing} (successful submit / programmatic close). */
+    private skipNextOnClosingDirtyCheck;
+    /** Prevents concurrent dismiss paths from opening multiple unsaved-changes confirms. */
+    private dismissConfirmPromise?;
+    private dirtyBaselineFallbackTimer?;
+    private readonly destroyRef;
     context: _angular_core.WritableSignal<any>;
     callBack: (result: unknown) => void;
     data: any;
@@ -924,7 +974,29 @@ 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 getWidgetContextStore;
+    private scheduleDirtyBaselineCapture;
+    /**
+     * Captures a dialog-local baseline once after widget init/normalization goes idle.
+     */
+    private captureDirtyBaselineIfNeeded;
     private layoutRenderer;
     private debounceTimer?;
     handleContextChanged(event: any): void;
@@ -935,6 +1007,9 @@ declare class AXPDialogRendererComponent extends AXBasePageComponent implements
     isFormLoading(): boolean;
     isSubmitting(): boolean;
     executeAction(action: AXPWidgetCoreElementAction): Promise<void>;
+    private isDialogDirty;
+    private confirmDismissIfDirty;
+    private promptUnsavedChangesConfirm;
     /** Whether the layout form should be validated before running this footer command. */
     private shouldValidateBeforeAction;
     /** True when a footer handler or command result asks to leave the dialog open (`keepDialogOpen` on the result or `result.data`). */
@@ -947,7 +1022,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 +1078,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;
@@ -979,6 +982,10 @@ 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;
@@ -1229,24 +1236,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';