@acorex/platform 21.0.0-next.65 → 21.0.0-next.67

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@acorex/platform",
-  "version": "21.0.0-next.65",
+  "version": "21.0.0-next.67",
   "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

@@ -4,7 +4,7 @@ import { AXDataSourceOperator, AXStyleColorType, AXDataSourceFilterOption } from
 import * as i2 from '@acorex/components/popup';
 import { AXPopupSizeType, AXPopupService } from '@acorex/components/popup';
 import * as i5 from '@acorex/platform/core';
-import { AXPValueTransformerFunctions, AXPMultiLanguageString, AXPOptionsData, AXPExpression, AXPFilterDefinition, AXPMetaData, AXPSystemActionType, AXPValidationRules, AXPGridLayoutOptions, AXPLogoConfig, AXPFileListItem, AXPDataSourceDefinitionProvider, AXPDataSourceDefinition, AXPNavigateActionCommand, AXPExecuteCommand, AXPApplicationUserReference, AXPEntityReference, AXPPlatformScopeKey, AXPWidgetTriggers, AXPPlatformScope, AXPExpressionEvaluatorScopeProvider, AXPExpressionEvaluatorScopeProviderContext } from '@acorex/platform/core';
+import { AXPValueTransformerFunctions, AXPMultiLanguageString, AXPOptionsData, AXPExpression, AXPFilterDefinition, AXPMetaData, AXPSystemActionType, AXPValidationRules, AXPGridLayoutOptions, AXPLogoConfig, AXPExpressionEvaluatorScopeProvider, AXPExpressionEvaluatorScopeProviderContext, AXPFileListItem, AXPDataSourceDefinitionProvider, AXPDataSourceDefinition, AXPNavigateActionCommand, AXPExecuteCommand, AXPApplicationUserReference, AXPEntityReference, AXPPlatformScopeKey, AXPWidgetTriggers, AXPPlatformScope } from '@acorex/platform/core';
 import { AXPWidgetTypesMap, AXPMetaDataDefinition, AXPWidgetNode, AXPWidgetProperty } from '@acorex/platform/layout/widget-core';
 import * as i3 from '@acorex/core/date-time';
 import { AXCalendarService } from '@acorex/core/date-time';
@@ -247,10 +247,10 @@ type AXPColumnAlign = AXPColumnContentAlign | {
     header?: AXPColumnContentAlign;
     cell?: AXPColumnContentAlign;
 };
-interface AXPEntityTableColumn {
+/** Shared field definition for list layouts (table columns, card fields, etc.). */
+interface AXPEntityDisplayField {
     name: string;
     title?: string;
-    hidden?: boolean;
     showAs?: {
         type: AXPWidgetTypesMap[keyof AXPWidgetTypesMap] | string;
         options?: Record<string, any>;
@@ -258,13 +258,50 @@ interface AXPEntityTableColumn {
     options?: {
         /** When string, evaluate against parent detail context (e.g. related list). */
         visible?: boolean | string;
+        /** Optional dataPath override for field binding. */
+        dataPath?: string;
+        [name: string]: any;
+    };
+}
+/** Card layout field presentation in master list card view. */
+type AXPCardFieldDisplay = 'simple' | 'badge';
+/** Badge color: semantic token or per-row expression (`{{ context.eval(...) }}`). */
+type AXPCardBadgeColor = AXStyleColorType | AXPExpression;
+interface AXPCardBadgeDisplayOptions {
+    /** Semantic color or expression evaluated against row context. */
+    color?: AXPCardBadgeColor;
+}
+interface AXPCardBadgeDisplay {
+    type: 'badge';
+    options?: AXPCardBadgeDisplayOptions;
+}
+/** Shorthand (`badge` / `simple`) or structured badge config with optional per-row color. */
+type AXPCardFieldDisplayConfig = AXPCardFieldDisplay | AXPCardBadgeDisplay;
+/** Card layout field in master list view. */
+type AXPCardField = AXPEntityDisplayField & {
+    layout?: AXPEntityPropertyLayoutConfig;
+    /**
+     * Field presentation. Default: `simple` (card body).
+     * Use `badge` or `{ type: 'badge', options: { color } }` for header chips beside title.
+     */
+    display?: AXPCardFieldDisplayConfig;
+    /**
+     * Badge color when presentation is badge-shaped.
+     * Prefer `display: { type: 'badge', options: { color } }` for new definitions.
+     * Omit for status fields — color is resolved from the status definition per row.
+     */
+    badgeColor?: AXPCardBadgeColor;
+};
+/** Whether the card field is shown as a header badge (not in the card body). */
+declare function isCardFieldBadgeDisplay(display: AXPCardFieldDisplayConfig | undefined): display is 'badge' | AXPCardBadgeDisplay;
+/** Resolves static badge color config from {@link AXPCardField.display} and legacy {@link AXPCardField.badgeColor}. */
+declare function resolveCardFieldBadgeColor(field: Pick<AXPCardField, 'display' | 'badgeColor'>): AXPCardBadgeColor | undefined;
+interface AXPEntityTableColumn extends AXPEntityDisplayField {
+    options?: AXPEntityDisplayField['options'] & {
         /** Initial column width (overrides widget column width when set). */
         width?: string;
-        /** Optional dataPath override for column binding. */
-        dataPath?: string;
         /** Header/cell alignment (shorthand or per-side). */
         align?: AXPColumnAlign;
-        [name: string]: any;
     };
 }
 interface AXPEntityCommand {
@@ -569,11 +606,33 @@ interface AXPEntityMasterListView {
     views: AXPQueryView[];
     layouts?: {
         table?: {
+            enabled?: boolean;
             columns: AXPEntityTableColumn[];
         };
-        card?: {};
+        card?: {
+            enabled?: boolean;
+            header: {
+                /** Property path, expression (`{{ ... }}`), or literal — evaluated per row. */
+                title?: string;
+                description?: string;
+                icon?: string;
+            };
+            fields: AXPCardField[];
+        };
     };
 }
+type AXPEntityMasterListLayoutType = 'table' | 'card';
+/** Master list presentation: table or card with compact (collapsed) / expanded bodies. */
+type AXPEntityMasterListDisplayMode = 'table' | 'card-compact' | 'card-expanded';
+interface AXPEntityMasterListLayoutOption {
+    id: AXPEntityMasterListLayoutType;
+    title: string;
+    icon?: string;
+}
+/** Resolves master list layouts that are currently enabled. */
+declare function resolveEnabledMasterListLayouts(layouts?: AXPEntityMasterListView['layouts']): AXPEntityMasterListLayoutType[];
+/** First enabled layout; used as the default when no user preference is stored. */
+declare function resolveDefaultMasterListLayout(layouts?: AXPEntityMasterListView['layouts']): AXPEntityMasterListLayoutType;
 interface AXPEntityDetailListView {
     title?: string;
     description?: string;
@@ -1141,6 +1200,11 @@ declare abstract class AXPFileStorageService {
     static ɵprov: i0.ɵɵInjectableDeclaration<AXPFileStorageService>;
 }
 
+declare class AXPFileStorageEvaluatorScopeProvider implements AXPExpressionEvaluatorScopeProvider {
+    fileStorageService: AXPFileStorageService;
+    provide(context: AXPExpressionEvaluatorScopeProviderContext): Promise<void>;
+}
+
 /**
  * Capabilities API provided to file action providers.
  * These methods allow actions to interact with the file uploader widget.
@@ -3125,5 +3189,5 @@ declare class AXMWorkflowErrorHandler implements AXPErrorHandler {
     static ɵprov: i0.ɵɵInjectableDeclaration<AXMWorkflowErrorHandler>;
 }
 
-export { ALL_DEFAULT_OPERATORS, AXMWorkflowErrorHandler, AXPAppVersionService, AXPCleanNestedFilters, AXPClipBoardService, AXPCommonModule, AXPCommonSettings, AXPCustomOperatorService, AXPCustomOperatorServiceImpl, AXPDataProvider, AXPDebugService, AXPDefaultMultiLanguageConfigService, AXPDialogConfirmAction, AXPEntityCommandScope, AXPEntityQueryType, AXPEntityType, AXPErrorHandlerRegistryService, AXPExportService, AXPFileActionsService, AXPFileStorageService, AXPFileStorageStatus, AXPFileTypeProviderService, AXPFilterOperatorMiddlewareService, AXPFilterOperatorMiddlewareServiceImpl, AXPFooterTextSlotComponent, AXPGlobalErrorHandler, AXPHomePageModule, AXPHomePageService, AXPLockService, AXPMenuItemsDataSourceDefinition, AXPMenuMiddlewareRegistry, AXPMenuProviderService, AXPMenuSearchDefinitionProvider, AXPMenuSearchProvider, AXPMenuService, AXPMenuVisibilityService, AXPNavBarSlotComponent, AXPNavigateWorkflow, AXPOutputContractTranscriptSegmentService, AXPPlatformDefaultConfigs, AXPRedirectEvent, AXPRefreshEvent, AXPRegionalSetting, AXPRelationshipCardinality, AXPRelationshipKind, AXPReloadAction, AXPReloadEvent, AXPSearchCommandProvider, AXPSearchDefinitionActionBuilder, AXPSearchDefinitionBuilder, AXPSearchDefinitionProviderContext, AXPSearchDefinitionProviderService, AXPSearchService, AXPSettingDefaultValuesAggregatorService, AXPSettingDefinitionGroupBuilder, AXPSettingDefinitionProviderContext, AXPSettingDefinitionProviderService, AXPSettingDefinitionSectionBuilder, AXPSettingsEvaluatorScopeProvider, AXPSettingsService, AXPStatusDefinitionProviderService, AXPStatusProvider, AXPStickyDirective, AXPSystemStatusType, AXPSystemStatuses, AXPToastAction, AXPTokenDefinitionService, AXPTokenEvaluatorScopeProvider, AXPVersioningService, AXPWorkflowNavigateAction, AXPWorkflowRouterNavigateAction, AXP_AGENT_OUTPUT_CONTRACT_DEFAULT_STRUCTURED_RETRIES, AXP_APP_VERSION_PROVIDER, AXP_FILE_ACTION_PROVIDER, AXP_FILE_TYPE_INFO_PROVIDER, AXP_HOME_PAGES, AXP_HOME_PAGE_DEFAULT_KEY, AXP_LOCALE_MANAGEMENT_PORT, AXP_MENU_MIDDLEWARE, AXP_MENU_PROVIDER, AXP_OUTPUT_CONTRACT_TRANSCRIPT_SEGMENT_PROVIDER, AXP_PLATFORM_CONFIG_TOKEN, AXP_ROOT_CONFIG_TOKEN, AXP_SEARCH_DEFINITION_PROVIDER, AXP_SEARCH_PROVIDER, AXP_SETTING_DEFAULT_VALUES_PROVIDERS, AXP_SETTING_DEFINITION_PROVIDER, AXP_SETTING_VALUE_PROVIDER, AXP_STATUS_PROVIDERS, AXP_TOKEN_DEFINITION_PROVIDER, AXVChangeType, BETWEEN_OPER, BOOLEAN_OPERATORS, CONTAINS_OPER, DATE_OPERATORS, DEFAULT_DATE_FILTER_PRESETS, DEFAULT_MULTILANGUAGE_FIELD_NAMES, ENDS_WITH_OPER, ENVIRONMENT, EQ_OPER, GTE_OPER, GT_OPER, IN_OPER, IS_EMPTY_OPER, IS_NOT_EMPTY_OPER, LTE_OPER, LT_OPER, MENU_ITEMS_DATASOURCE_NAME, MULTILANGUAGE_CAPABLE_WIDGET_TYPES, NOT_CONTAINS_OPER, NOT_EQ_OPER, NUMBER_OPERATORS, STARTS_WITH_OPER, STRING_OPERATORS, UploadFromComputerActionProvider, applyDateFilterPreset, coerceAXPSettingRawValue, coerceAXPSettingRawValueByKind, configPlatform, createAllQueryView, createEntityCommandOptions, createEntitySearchCommand, createMenuContext, createMenuMiddleware, createQueryView, findManualPresetIdByOperation, getEntityInfo, getStatusInfo, getSystemStatus, inferSettingCoercionKind, peelSettingValueKey, provideDynamicHomePage, provideMenuMiddleware, resolveDateFilterPresets, resolveStatusLook, shouldApplyDefaultMultiLanguageToEntityProperty, shouldApplyDefaultMultiLanguageToWidgetNode, shouldApplyDefaultMultiLanguageToWidgetProperty, systemStatusToDefinition, withDefaultMultiLanguageOnWidgetNodeTree, withDefaultMultiLanguageOnWidgetProperty };
-export type { AXCFileUploaderAction, AXCFileUploaderActionsPayload, AXCFileUploaderCapabilities, AXEntityPropertyWidget, AXPAgentOutputContract, AXPAgentOutputKind, AXPAgentResponseFormat, AXPAggregate, AXPAppVersion, AXPAppVersionProvider, AXPApplication, AXPCategoryEntity, AXPColumnAlign, AXPColumnContentAlign, AXPCommandActionCallback, AXPCommandActionDisplay, AXPCommandActionLook, AXPCommandActionPriority, AXPCommandActionType, AXPCommonModuleConfigs, AXPCurrency, AXPDateTimeFilterPreset, AXPDateTimeFilterPresetKind, AXPDateTimeFilterValue, AXPDomToImageOptions, AXPEntity, AXPEntityAction, AXPEntityCommand, AXPEntityDetailListView, AXPEntityMasterCreateLayoutView, AXPEntityMasterLayoutView, AXPEntityMasterListView, AXPEntityMasterSingleLayoutView, AXPEntityMasterUpdateLayoutView, AXPEntityPage, AXPEntityProperty, AXPEntityPropertyCreateView, AXPEntityPropertyGroup, AXPEntityPropertyLayoutConfig, AXPEntityPropertyUpdateView, AXPEntityPropertyView, AXPEntityQuery, AXPEntityQuickCreate, AXPEntitySectionView, AXPEntityTableColumn, AXPEntityV2, AXPEntityVersionHistory, AXPErrorHandler, AXPFileActionProvider, AXPFileActionProviderToken, AXPFileExtension, AXPFileManyStorageInfo, AXPFileStorageCreateRequest, AXPFileStorageFindRequest, AXPFileStorageInfo, AXPFileStorageUpdateRequest, AXPFileType, AXPFileTypeInfoProvider, AXPFilterOperator, AXPGeoLocation, AXPGroupSearchResult, AXPHomePageDefinition, AXPJsonSchemaLike, AXPLanguage, AXPLocaleManagementPort, AXPLocaleProfile, AXPLockGetInfoRequest, AXPLockInfo, AXPLockRequest, AXPLockType, AXPMenuFinderResult, AXPMenuInsertion, AXPMenuItem, AXPMenuItemCommand, AXPMenuItemFinder, AXPMenuItemWithParent, AXPMenuMiddleware, AXPMenuMiddlewareContext, AXPMenuMiddlewareProvider, AXPMenuProvider, AXPMenuProviderContext, AXPMenuType, AXPModule, AXPOutputContractTranscriptSegmentDefinition, AXPOutputContractTranscriptSegmentProvider, AXPOutputContractTranscriptSegmentProviderToken, AXPOutputTranscriptSegmentId, AXPPlatformConfigs, AXPQueryFilter, AXPQuerySort, AXPQueryView, AXPRelatedEntity, AXPRelationship, AXPRootConfigs, AXPSearchAction, AXPSearchDefinition, AXPSearchDefinitionDisplayFormat, AXPSearchDefinitionProvider, AXPSearchDisplayGroupResult, AXPSearchDisplayResult, AXPSearchDisplayResultForSave, AXPSearchParentResult, AXPSearchProvider, AXPSearchResult, AXPSettingChangedEvent, AXPSettingCoercionKind, AXPSettingDefaultValuesProvider, AXPSettingDefinition, AXPSettingDefinitionGroup, AXPSettingDefinitionProvider, AXPSettingDefinitionSection, AXPSettingLayoutOptions, AXPSettingMergedDefaults, AXPSettingValue, AXPSettingValueProvider, AXPSettingsServiceInterface, AXPStatusDefinition, AXPStatusTransition, AXPTimeZone, AXPTokenDefinition, AXPTokenDefinitionProvider, AXPTokenDefinitionProviderToken, AXPUnLockRequest, AXPVersionChange, AXPVersionEntry, AXPVersionStream, CanonicalChange, CanonicalChangeOp, VersionedFileInfo };
+export { ALL_DEFAULT_OPERATORS, AXMWorkflowErrorHandler, AXPAppVersionService, AXPCleanNestedFilters, AXPClipBoardService, AXPCommonModule, AXPCommonSettings, AXPCustomOperatorService, AXPCustomOperatorServiceImpl, AXPDataProvider, AXPDebugService, AXPDefaultMultiLanguageConfigService, AXPDialogConfirmAction, AXPEntityCommandScope, AXPEntityQueryType, AXPEntityType, AXPErrorHandlerRegistryService, AXPExportService, AXPFileActionsService, AXPFileStorageEvaluatorScopeProvider, AXPFileStorageService, AXPFileStorageStatus, AXPFileTypeProviderService, AXPFilterOperatorMiddlewareService, AXPFilterOperatorMiddlewareServiceImpl, AXPFooterTextSlotComponent, AXPGlobalErrorHandler, AXPHomePageModule, AXPHomePageService, AXPLockService, AXPMenuItemsDataSourceDefinition, AXPMenuMiddlewareRegistry, AXPMenuProviderService, AXPMenuSearchDefinitionProvider, AXPMenuSearchProvider, AXPMenuService, AXPMenuVisibilityService, AXPNavBarSlotComponent, AXPNavigateWorkflow, AXPOutputContractTranscriptSegmentService, AXPPlatformDefaultConfigs, AXPRedirectEvent, AXPRefreshEvent, AXPRegionalSetting, AXPRelationshipCardinality, AXPRelationshipKind, AXPReloadAction, AXPReloadEvent, AXPSearchCommandProvider, AXPSearchDefinitionActionBuilder, AXPSearchDefinitionBuilder, AXPSearchDefinitionProviderContext, AXPSearchDefinitionProviderService, AXPSearchService, AXPSettingDefaultValuesAggregatorService, AXPSettingDefinitionGroupBuilder, AXPSettingDefinitionProviderContext, AXPSettingDefinitionProviderService, AXPSettingDefinitionSectionBuilder, AXPSettingsEvaluatorScopeProvider, AXPSettingsService, AXPStatusDefinitionProviderService, AXPStatusProvider, AXPStickyDirective, AXPSystemStatusType, AXPSystemStatuses, AXPToastAction, AXPTokenDefinitionService, AXPTokenEvaluatorScopeProvider, AXPVersioningService, AXPWorkflowNavigateAction, AXPWorkflowRouterNavigateAction, AXP_AGENT_OUTPUT_CONTRACT_DEFAULT_STRUCTURED_RETRIES, AXP_APP_VERSION_PROVIDER, AXP_FILE_ACTION_PROVIDER, AXP_FILE_TYPE_INFO_PROVIDER, AXP_HOME_PAGES, AXP_HOME_PAGE_DEFAULT_KEY, AXP_LOCALE_MANAGEMENT_PORT, AXP_MENU_MIDDLEWARE, AXP_MENU_PROVIDER, AXP_OUTPUT_CONTRACT_TRANSCRIPT_SEGMENT_PROVIDER, AXP_PLATFORM_CONFIG_TOKEN, AXP_ROOT_CONFIG_TOKEN, AXP_SEARCH_DEFINITION_PROVIDER, AXP_SEARCH_PROVIDER, AXP_SETTING_DEFAULT_VALUES_PROVIDERS, AXP_SETTING_DEFINITION_PROVIDER, AXP_SETTING_VALUE_PROVIDER, AXP_STATUS_PROVIDERS, AXP_TOKEN_DEFINITION_PROVIDER, AXVChangeType, BETWEEN_OPER, BOOLEAN_OPERATORS, CONTAINS_OPER, DATE_OPERATORS, DEFAULT_DATE_FILTER_PRESETS, DEFAULT_MULTILANGUAGE_FIELD_NAMES, ENDS_WITH_OPER, ENVIRONMENT, EQ_OPER, GTE_OPER, GT_OPER, IN_OPER, IS_EMPTY_OPER, IS_NOT_EMPTY_OPER, LTE_OPER, LT_OPER, MENU_ITEMS_DATASOURCE_NAME, MULTILANGUAGE_CAPABLE_WIDGET_TYPES, NOT_CONTAINS_OPER, NOT_EQ_OPER, NUMBER_OPERATORS, STARTS_WITH_OPER, STRING_OPERATORS, UploadFromComputerActionProvider, applyDateFilterPreset, coerceAXPSettingRawValue, coerceAXPSettingRawValueByKind, configPlatform, createAllQueryView, createEntityCommandOptions, createEntitySearchCommand, createMenuContext, createMenuMiddleware, createQueryView, findManualPresetIdByOperation, getEntityInfo, getStatusInfo, getSystemStatus, inferSettingCoercionKind, isCardFieldBadgeDisplay, peelSettingValueKey, provideDynamicHomePage, provideMenuMiddleware, resolveCardFieldBadgeColor, resolveDateFilterPresets, resolveDefaultMasterListLayout, resolveEnabledMasterListLayouts, resolveStatusLook, shouldApplyDefaultMultiLanguageToEntityProperty, shouldApplyDefaultMultiLanguageToWidgetNode, shouldApplyDefaultMultiLanguageToWidgetProperty, systemStatusToDefinition, withDefaultMultiLanguageOnWidgetNodeTree, withDefaultMultiLanguageOnWidgetProperty };
+export type { AXCFileUploaderAction, AXCFileUploaderActionsPayload, AXCFileUploaderCapabilities, AXEntityPropertyWidget, AXPAgentOutputContract, AXPAgentOutputKind, AXPAgentResponseFormat, AXPAggregate, AXPAppVersion, AXPAppVersionProvider, AXPApplication, AXPCardBadgeColor, AXPCardBadgeDisplay, AXPCardBadgeDisplayOptions, AXPCardField, AXPCardFieldDisplay, AXPCardFieldDisplayConfig, AXPCategoryEntity, AXPColumnAlign, AXPColumnContentAlign, AXPCommandActionCallback, AXPCommandActionDisplay, AXPCommandActionLook, AXPCommandActionPriority, AXPCommandActionType, AXPCommonModuleConfigs, AXPCurrency, AXPDateTimeFilterPreset, AXPDateTimeFilterPresetKind, AXPDateTimeFilterValue, AXPDomToImageOptions, AXPEntity, AXPEntityAction, AXPEntityCommand, AXPEntityDetailListView, AXPEntityDisplayField, AXPEntityMasterCreateLayoutView, AXPEntityMasterLayoutView, AXPEntityMasterListDisplayMode, AXPEntityMasterListLayoutOption, AXPEntityMasterListLayoutType, AXPEntityMasterListView, AXPEntityMasterSingleLayoutView, AXPEntityMasterUpdateLayoutView, AXPEntityPage, AXPEntityProperty, AXPEntityPropertyCreateView, AXPEntityPropertyGroup, AXPEntityPropertyLayoutConfig, AXPEntityPropertyUpdateView, AXPEntityPropertyView, AXPEntityQuery, AXPEntityQuickCreate, AXPEntitySectionView, AXPEntityTableColumn, AXPEntityV2, AXPEntityVersionHistory, AXPErrorHandler, AXPFileActionProvider, AXPFileActionProviderToken, AXPFileExtension, AXPFileManyStorageInfo, AXPFileStorageCreateRequest, AXPFileStorageFindRequest, AXPFileStorageInfo, AXPFileStorageUpdateRequest, AXPFileType, AXPFileTypeInfoProvider, AXPFilterOperator, AXPGeoLocation, AXPGroupSearchResult, AXPHomePageDefinition, AXPJsonSchemaLike, AXPLanguage, AXPLocaleManagementPort, AXPLocaleProfile, AXPLockGetInfoRequest, AXPLockInfo, AXPLockRequest, AXPLockType, AXPMenuFinderResult, AXPMenuInsertion, AXPMenuItem, AXPMenuItemCommand, AXPMenuItemFinder, AXPMenuItemWithParent, AXPMenuMiddleware, AXPMenuMiddlewareContext, AXPMenuMiddlewareProvider, AXPMenuProvider, AXPMenuProviderContext, AXPMenuType, AXPModule, AXPOutputContractTranscriptSegmentDefinition, AXPOutputContractTranscriptSegmentProvider, AXPOutputContractTranscriptSegmentProviderToken, AXPOutputTranscriptSegmentId, AXPPlatformConfigs, AXPQueryFilter, AXPQuerySort, AXPQueryView, AXPRelatedEntity, AXPRelationship, AXPRootConfigs, AXPSearchAction, AXPSearchDefinition, AXPSearchDefinitionDisplayFormat, AXPSearchDefinitionProvider, AXPSearchDisplayGroupResult, AXPSearchDisplayResult, AXPSearchDisplayResultForSave, AXPSearchParentResult, AXPSearchProvider, AXPSearchResult, AXPSettingChangedEvent, AXPSettingCoercionKind, AXPSettingDefaultValuesProvider, AXPSettingDefinition, AXPSettingDefinitionGroup, AXPSettingDefinitionProvider, AXPSettingDefinitionSection, AXPSettingLayoutOptions, AXPSettingMergedDefaults, AXPSettingValue, AXPSettingValueProvider, AXPSettingsServiceInterface, AXPStatusDefinition, AXPStatusTransition, AXPTimeZone, AXPTokenDefinition, AXPTokenDefinitionProvider, AXPTokenDefinitionProviderToken, AXPUnLockRequest, AXPVersionChange, AXPVersionEntry, AXPVersionStream, CanonicalChange, CanonicalChangeOp, VersionedFileInfo };

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

@@ -1977,6 +1977,67 @@ declare class AXPComponentSlotModule {
     static ɵinj: i0.ɵɵInjectorDeclaration<AXPComponentSlotModule>;
 }
 
+/**
+ * Compact hints for assembling platform context into LLM system prompts.
+ * Mirrors fields used by {@link AXPAiPlatformRuntimeContext} and the mock engine runtime prompt
+ * formatter — keep labels short and values bounded.
+ */
+interface AXPContextDefinitionAiHints {
+    /**
+     * Short English label for bullet lists (e.g. `UI locale`, `Current instant (UTC, ISO 8601)`).
+     */
+    promptLabel?: string;
+    /**
+     * One-line guidance for the model (when to use this value, what not to ask the user).
+     */
+    usageHint?: string;
+    /**
+     * When `false`, this definition is omitted from AI system-prompt assembly. Default `true`.
+     */
+    includeInSystemPrompt?: boolean;
+    /**
+     * How to stringify the value compactly in prompts.
+     */
+    valueKind?: 'string' | 'number' | 'boolean' | 'instant' | 'locale' | 'dateTime' | 'object';
+    /**
+     * When `true`, the value must not be sent to the model (PII, secrets, tokens).
+     */
+    sensitive?: boolean;
+    /**
+     * Sort order when rendering the AI context block (lower first).
+     */
+    order?: number;
+}
+/**
+ * Describes a named platform context key (e.g. `currentDate`, `language`).
+ */
+interface AXPContextDefinition {
+    /** Stable identifier used as the context key and in expressions. */
+    name: string;
+    /** Human-readable title for designers and tooling. */
+    title: string;
+    /** What this context represents and when consumers should use it. */
+    description: string;
+    /** Optional metadata for AI system-prompt assembly. */
+    ai?: AXPContextDefinitionAiHints;
+}
+
+interface AXPContextDefinitionProvider {
+    items(): Promise<AXPContextDefinition[]>;
+}
+declare const AXP_CONTEXT_DEFINITION_PROVIDER: InjectionToken<AXPContextDefinitionProvider[]>;
+
+/**
+ * Collects {@link AXPContextDefinition} entries from all registered {@link AXPContextDefinitionProvider} instances.
+ */
+declare class AXPContextDefinitionProviderService implements AXPContextDefinitionProvider {
+    private readonly providers;
+    items(): Promise<AXPContextDefinition[]>;
+    get(name: string): Promise<AXPContextDefinition | undefined>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AXPContextDefinitionProviderService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<AXPContextDefinitionProviderService>;
+}
+
 declare class AXPDataGenerator {
     static uuid(): string;
     static number(max: number): number;
@@ -2902,5 +2963,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, 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_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, 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, 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 };

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

@@ -90,6 +90,8 @@ interface AXPDialogRef {
         close?: (result?: any) => void;
     }): Promise<void>;
 }
+/** Fallback {@link AXPDialogRef} when the popup is dismissed without a footer action (e.g. header close). */
+declare function createDismissedDialogRef(context?: () => unknown): AXPDialogRef;
 interface LayoutWidgetOptions {
     name?: string;
 }
@@ -910,6 +912,8 @@ declare class AXPDialogRendererComponent extends AXBasePageComponent implements
     private readonly commandService;
     private readonly hookService;
     private dialogResult?;
+    /** Ensures `show()` resolves once when the dialog closes (footer action or header close). */
+    private callbackInvoked;
     context: _angular_core.WritableSignal<any>;
     callBack: (result: unknown) => void;
     data: any;
@@ -935,6 +939,8 @@ declare class AXPDialogRendererComponent extends AXBasePageComponent implements
     private shouldValidateBeforeAction;
     /** True when a footer handler or command result asks to leave the dialog open (`keepDialogOpen` on the result or `result.data`). */
     private shouldKeepDialogOpenAfterCommandResult;
+    /** Resolves the dialog `show()` promise exactly once. */
+    private resolveDialog;
     private createDialogRef;
     private closeWithOptionalSkipValidate;
     /** Resolves footer/widget action command to a string (e.g. `cancel`, `submit`, `widget:...`). */
@@ -995,5 +1001,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 };
+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 };

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

@@ -2,13 +2,15 @@ import * as _angular_core from '@angular/core';
 import { Signal, InjectionToken, InputSignal, TemplateRef, ElementRef, OnDestroy, OnInit, QueryList, OnChanges, 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';
+import * as _acorex_platform_themes_shared from '@acorex/platform/themes/shared';
 import { AXPMenuItem } from '@acorex/platform/common';
 import { AXTreeViewLegacyComponent, AXTreeItemClickBaseEventLegacy } from '@acorex/components/tree-view-legacy';
 import { AXPopoverComponent } from '@acorex/components/popover';
 import { CdkDragDrop } from '@angular/cdk/drag-drop';
 import * as _acorex_platform_layout_widget_core from '@acorex/platform/layout/widget-core';
 import { AXPWidgetNode, AXPWidgetRendererDirective, AXPWidgetProperty, AXPWidgetConfig } from '@acorex/platform/layout/widget-core';
-import { AXDataTableComponent, AXDataTableRowDbClick, AXDataTableRowClick } from '@acorex/components/data-table';
+import { AXDataTableComponent, AXRowCommandItem, AXDataTableRowDbClick, AXDataTableRowClick, AXRowCommandItemClickEvent } from '@acorex/components/data-table';
 import { AXBasePageComponent } from '@acorex/components/page';
 import { AXDropListDroppedEvent } from '@acorex/cdk/drag-drop';
 import { AXTagBoxComponent } from '@acorex/components/tag-box';
@@ -140,9 +142,65 @@ declare class AXPTaskBadgeDirective {
     private badgeService;
     private host;
     private hostElement;
+    protected themeStore: {
+        currentMode: _angular_core.Signal<_acorex_platform_themes_shared.AXPThemeMode>;
+        currentPalette: _angular_core.Signal<string>;
+        systemThemeMode: _angular_core.Signal<_acorex_platform_themes_shared.AXPThemeMode>;
+        font: _ngrx_signals.DeepSignal<{
+            family: string;
+            size: string;
+        }>;
+        overlayLoading: _angular_core.Signal<boolean>;
+        navigationLoading: _angular_core.Signal<boolean>;
+        overlayLoadingTaskCount: _angular_core.Signal<number>;
+        navigationLoadingTaskCount: _angular_core.Signal<number>;
+        sideMenuState: _angular_core.Signal<_acorex_platform_themes_shared.AXPSideMenuState>;
+        sideMenuWidth: _angular_core.Signal<number>;
+        sideMenuCompactWidth: _angular_core.Signal<number>;
+        menuVerticalMode: _angular_core.Signal<_acorex_platform_themes_shared.AXPMenuVerticalMode>;
+        menuOrientation: _angular_core.Signal<_acorex_platform_themes_shared.AXPMenuOrientation>;
+        isPrinting: _angular_core.Signal<boolean>;
+        isDarkMode: _angular_core.Signal<boolean>;
+        isLightMode: _angular_core.Signal<boolean>;
+        isSystemMode: _angular_core.Signal<boolean>;
+        isSideMenuOpen: _angular_core.Signal<boolean>;
+        isOverlayLoading: _angular_core.Signal<boolean>;
+        isNavigationLoading: _angular_core.Signal<boolean>;
+        isMenuHorizontal: _angular_core.Signal<boolean>;
+        sideMenuDrawerWidth: _angular_core.Signal<number>;
+        changeThemeMode: (theme: _acorex_platform_themes_shared.AXPThemeMode) => void;
+        openSideMenu: () => void;
+        closeSideMenu: () => void;
+        setSideMenuWidth: (width: number) => void;
+        setSideMenuCompactWidth: (width: number) => void;
+        setSideMenuDrawerWidth: (width: number) => void;
+        toggleSideMenu: () => void;
+        setNavigationLoading: (value: boolean, delay?: number) => void;
+        setOverlayLoading: (value: boolean, delay?: number) => void;
+        loadSettings: () => Promise<void>;
+    } & _ngrx_signals.StateSource<{
+        currentMode: _acorex_platform_themes_shared.AXPThemeMode;
+        currentPalette: string;
+        systemThemeMode: _acorex_platform_themes_shared.AXPThemeMode;
+        font: {
+            family: string;
+            size: string;
+        };
+        overlayLoading: boolean;
+        navigationLoading: boolean;
+        overlayLoadingTaskCount: number;
+        navigationLoadingTaskCount: number;
+        sideMenuState: _acorex_platform_themes_shared.AXPSideMenuState;
+        sideMenuWidth: number;
+        sideMenuCompactWidth: number;
+        menuVerticalMode: _acorex_platform_themes_shared.AXPMenuVerticalMode;
+        menuOrientation: _acorex_platform_themes_shared.AXPMenuOrientation;
+        isPrinting: boolean;
+    }>;
     badgeKey: InputSignal<string | undefined>;
     count: InputSignal<number>;
-    private readonly displayCount;
+    private readonly actualCount;
+    private readonly badgeText;
     private setValueOfInputSignal;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPTaskBadgeDirective, never>;
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<AXPTaskBadgeDirective, "[axp-task-badge]", never, { "badgeKey": { "alias": "badgeKey"; "required": false; "isSignal": true; }; "count": { "alias": "axp-task-badge"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
@@ -480,29 +538,69 @@ interface AXPDataSelectorColumn {
         options: any;
     };
 }
-interface AXPDataSelectorConfig {
+interface AXPDataSelectorRowActionItem {
+    name: string;
+    text: string;
+    icon?: string;
+    color?: string;
+    disabled?: boolean | string;
+    default?: boolean;
+    divided?: boolean;
+}
+interface AXPDataSelectorRowActionsHandler {
+    hasPrimary: () => boolean;
+    hasDropdown: () => boolean;
+    getPrimaryItems: () => AXPDataSelectorRowActionItem[];
+    getDropdownItems: (rowData: unknown) => Promise<AXPDataSelectorRowActionItem[]>;
+    execute: (commandName: string, rowData: unknown) => Promise<void>;
+}
+interface AXPDataSelectorSearchField {
+    name: string;
     title: string;
-    dataSource: AXDataSource<any>;
+}
+interface AXPDataSelectorSelectionConfig {
+    mode?: 'single' | 'multiple';
+    selectedItemIds?: string[] | number[];
+    /** When true, Select stays enabled with no selection so the user can confirm clearing. Default: true. */
+    allowUnselect?: boolean;
+}
+interface AXPDataSelectorGridConfig {
     columns: AXPDataSelectorColumn[];
-    selectionMode: 'single' | 'multiple';
-    searchFields?: {
-        name: string;
-        title: string;
-    }[];
-    initialSearchTerm?: string;
     parentField?: string;
-    allowCreate?: AXPDataSelectorAllowCreate;
+}
+interface AXPDataSelectorFilterConfig {
+    value?: AXDataSourceFilterOption;
+}
+interface AXPDataSelectorSearchConfig {
+    fields?: AXPDataSelectorSearchField[];
+    initial?: string;
+}
+interface AXPDataSelectorCategoryFilterConfig {
+    field: string;
+    operator?: 'equal' | 'contains' | 'in';
+}
+interface AXPDataSelectorCategoryConfig {
+    enabled?: boolean;
+    title: string;
+    dataSource: AXPCategoryTreeDataSource;
+    filter: AXPDataSelectorCategoryFilterConfig;
+    width?: string;
+}
+interface AXPDataSelectorCreateConfig {
+    mode?: AXPDataSelectorAllowCreate;
     onCreate?: (mode: 'full' | 'quick') => Promise<any | null>;
-    filters?: AXDataSourceFilterOption;
-    selectedItemIds?: string[] | number[];
-    categoryFilter?: {
-        enabled: boolean;
-        title: string;
-        dataSource: AXPCategoryTreeDataSource;
-        filterField: string;
-        filterOperator?: 'equal' | 'contains' | 'in';
-        width?: string;
-    };
+}
+interface AXPDataSelectorConfig {
+    title: string;
+    dataSource: AXDataSource<any>;
+    grid: AXPDataSelectorGridConfig;
+    selection?: AXPDataSelectorSelectionConfig;
+    filter?: AXPDataSelectorFilterConfig;
+    search?: AXPDataSelectorSearchConfig;
+    category?: AXPDataSelectorCategoryConfig;
+    create?: AXPDataSelectorCreateConfig;
+    /** Optional entity row actions (preview, edit, etc.) shown in the grid. */
+    rowActions?: AXPDataSelectorRowActionsHandler;
 }
 declare class AXPDataSelectorComponent extends AXBasePageComponent {
     protected config: _angular_core.WritableSignal<AXPDataSelectorConfig>;
@@ -514,6 +612,8 @@ declare class AXPDataSelectorComponent extends AXBasePageComponent {
     private initialSelectionApplied;
     private userHasInteracted;
     private isApplyingInitialSelection;
+    /** Suppresses stale grid selection events while a single-mode row click is being applied. */
+    private rowClickSelectionSync;
     private initialSelectedItems;
     protected activeCategoryFilter: _angular_core.WritableSignal<{
         node: AXPCategoryEntity;
@@ -523,9 +623,12 @@ declare class AXPDataSelectorComponent extends AXBasePageComponent {
     private initialSearchApplied;
     private readonly translationService;
     constructor();
+    protected allowUnselect: _angular_core.Signal<boolean>;
     protected allowSelect: _angular_core.Signal<boolean>;
     protected selectedCount: _angular_core.Signal<number>;
     protected hasSearch: _angular_core.Signal<boolean | undefined>;
+    protected selectionMode: _angular_core.Signal<"single" | "multiple">;
+    protected categoryEnabled: _angular_core.Signal<boolean>;
     protected categoryTreeConfig: _angular_core.Signal<{
         textField: string;
         valueField: string;
@@ -542,6 +645,10 @@ declare class AXPDataSelectorComponent extends AXBasePageComponent {
         canDelete: boolean;
         canCreateChild: boolean;
     }>;
+    protected hasRowActionPrimary: _angular_core.Signal<boolean>;
+    protected hasRowActionDropdown: _angular_core.Signal<boolean>;
+    protected primaryRowActionItems: _angular_core.Signal<AXRowCommandItem[]>;
+    protected primaryRowActionColumnWidth: _angular_core.Signal<string>;
     protected ngOnInit(): void;
     protected ngAfterViewInit(): Promise<void>;
     protected handleRowDbClick(e: AXDataTableRowDbClick): void;
@@ -552,8 +659,19 @@ declare class AXPDataSelectorComponent extends AXBasePageComponent {
     protected handleCloseClick(): void;
     protected handleSelectClick(): void;
     protected handleExpandRow(row: any): Promise<void>;
+    protected getDropdownRowActionItems: (rowData: unknown) => Promise<AXRowCommandItem[]>;
+    protected handleRowActionClick(event: AXRowCommandItemClickEvent): Promise<void>;
     protected handleCategoryFilterClick(node: AXPCategoryEntity): void;
     protected clearCategoryFilter(): void;
+    private getRowKey;
+    private isSingleSelectionMode;
+    private applySingleSelection;
+    private clearRowClickSelectionSync;
+    /**
+     * Keeps at most one row when single mode uses checkboxes.
+     */
+    private clampSingleSelection;
+    private syncGridSingleSelection;
     private applySearchFilter;
     private applyFilterAndSort;
     private applyCategoryFilter;
@@ -577,18 +695,6 @@ declare class AXPDataSelectorService {
     open(config: AXPDataSelectorConfig): Promise<{
         items: any[];
     } | null>;
-    /**
-     * Open data selector with category filter
-     */
-    openWithCategoryFilter(config: Omit<AXPDataSelectorConfig, 'categoryFilter'>, categoryFilterConfig: {
-        title: string;
-        dataSource: AXPCategoryTreeDataSource;
-        filterField: string;
-        filterOperator?: 'equal' | 'contains' | 'in';
-        width?: string;
-    }): Promise<{
-        items: any[];
-    } | null>;
     /**
      * Apply column width resolution to all columns using the column width service
      */
@@ -1125,12 +1231,20 @@ declare class AXPLayoutSideDetailPanelComponent {
 
 declare class AXPLogoComponent implements OnInit, OnChanges {
     source: any;
+    protected activeSource: any;
     protected logoType: string;
+    protected isCompactLogo: boolean;
+    protected readonly compactLogoSize = 32;
+    private inputSource;
     private platform;
+    private themeStore;
+    private platformConfig;
+    private cdr;
+    constructor();
     ngOnInit(): void;
     ngOnChanges(): void;
-    protected setLogoType(): void;
-    protected setLogoTheme(): void;
+    private updateActiveSource;
+    private setLogoType;
     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>;
 }
@@ -2158,6 +2272,12 @@ declare class AXPSectionItemsBuilderComponent {
     readonly readonlyMode: _angular_core.InputSignal<boolean>;
     readonly valueChange: _angular_core.OutputEmitterRef<AXPBuilderValue>;
     private readonly vm;
+    /** Snapshot from the last external `[value]` sync (load, discard, save refresh). */
+    private readonly baseline;
+    /** Set on local {@link commit}; cleared on external sync or {@link markClean}. */
+    private pendingCommitSnapshot;
+    /** True when the live model differs from the external baseline. */
+    readonly isDirty: _angular_core.Signal<boolean>;
     protected readonly sectionsModel: _angular_core.Signal<AXPBuilderValue>;
     protected readonly sectionRows: _angular_core.Signal<{
         section: AXPBuilderSection;
@@ -2169,6 +2289,8 @@ declare class AXPSectionItemsBuilderComponent {
     protected readonly itemDropListIds: _angular_core.Signal<string[]>;
     protected readonly canRemoveSection: _angular_core.Signal<boolean>;
     constructor();
+    /** Align dirty baseline to the current model (call after save). */
+    markClean(): void;
     /**
      * Opens add-section flow (same as primary "Add section" control). For page commands / ViewChild.
      */
@@ -2612,6 +2734,10 @@ declare class AXPStandardSectionItemsBuilderComponent {
     protected readonly mergedDefinition: _angular_core.Signal<AXPBuilderDefinition>;
     /** Same entry as page commands / toolbar: open standardized add-section dialog. */
     addSection(): Promise<void>;
+    /** Whether the builder model differs from the last external baseline. */
+    isDirty(): boolean;
+    /** Clears dirty state by aligning baseline to the current model. */
+    markClean(): void;
     private isDuplicateSectionName;
     /**
      * `AXPBuilderSection` uses `[key: string]: unknown`; cast to form-bound type without resolving ML.
@@ -3124,4 +3250,4 @@ declare class AXPWidgetPropertyViewerService {
 }
 
 export { AXPActivityLogComponent, AXPAvatarComponent, AXPCategoryTreeComponent, AXPColorPalettePickerComponent, AXPColumnItemListComponent, AXPCompareViewComponent, AXPConditionBuilderComponent, AXPConditionBuilderConditionComponent, AXPDataSelectorComponent, AXPDataSelectorService, AXPDragDropListComponent, AXPExpressionFieldDefinitions, AXPImageEditorPopupComponent, AXPImageEditorService, AXPItemConfiguratorComponent, AXPLayoutFloatingZoomBarComponent, AXPLayoutSideDetailPanelComponent, AXPLayoutSideDetailPanelSectionDirective, AXPLogoComponent, AXPMarkdownTemplateDirective, AXPMarkdownViewerComponent, AXPMenuBadgeHelper, AXPMenuCustomizerComponent, AXPMenuCustomizerService, AXPOutcomeResultsViewerComponent, AXPPageComponentRegistryService, AXPPreloadFiltersComponent, AXPPropertyViewerComponent, AXPPropertyViewerPopupComponent, AXPPropertyViewerService, AXPQueryColumnsComponent, AXPQueryFiltersComponent, AXPQuerySortsComponent, AXPQueryViewsComponent, AXPRepeaterRowsLayoutComponent, AXPResourceAppointmentBoardProvider, AXPResourceAppointmentComponent, AXPResourceAppointmentService, AXPSectionItemsBuilderComponent, AXPSpreadsheetComponent, AXPStandardSectionItemsBuilderComponent, AXPStateMessageComponent, AXPStopwatchComponent, AXPTableColumnsEditorComponent, AXPTableColumnsEditorPopupComponent, AXPTableColumnsEditorService, AXPTableDataEditorComponent, AXPTableDataEditorPopupComponent, AXPTableDataEditorService, AXPTaskBadgeDirective, AXPTaskBadgeProvider, AXPTaskBadgeService, AXPTemplateViewerComponent, AXPTemplateViewerService, AXPThemeLayoutActionsComponent, AXPThemeLayoutBlockComponent, AXPThemeLayoutContainerComponent, AXPThemeLayoutEndSideComponent, AXPThemeLayoutFooterComponent, AXPThemeLayoutHeaderComponent, AXPThemeLayoutListComponent, AXPThemeLayoutListItemComponent, AXPThemeLayoutListItemsGroupComponent, AXPThemeLayoutPageHeaderComponent, AXPThemeLayoutPagePrimaryActionsComponent, AXPThemeLayoutPageSecondaryActionsComponent, AXPThemeLayoutSectionComponent, AXPThemeLayoutStartSideComponent, AXPThemeLayoutToolbarComponent, AXPUserAvatarComponent, AXPUserAvatarService, AXPWidgetFieldConfiguratorComponent, AXPWidgetItemComponent, AXPWidgetPropertyViewerComponent, AXPWidgetPropertyViewerPopupComponent, AXPWidgetPropertyViewerService, AXP_EXPRESSION_LOGIC_DEFINITIONS, AXP_EXPRESSION_OPERATION_DEFINITIONS, AXP_MENU_CUSTOMIZER_SERVICE, AXP_PAGE_COMPONENT_PROVIDER, AXP_RESOURCE_APPOINTMENT_PROVIDER, AXP_TASK_BADGE_PROVIDERS, AXP_USER_AVATAR_PROVIDER, STANDARD_SECTION_ITEMS_SECTION_TABS, buildPropertyViewerInitialContextFromProperties, buildPropertyViewerTabsFromProperties, buildTableColumnsEditorLayout, getFieldDefinitions, getLogicDefinition, getOperationDefinition, isPropertyBindingExpressionFormValue, preparePropertyForViewer, preparePropertyViewerTabs, registerFieldDefinitions, withValidationsOnEditorNode };
-export type { AXPBuilderBadge, AXPBuilderBadgeVariant, AXPBuilderDefinition, AXPBuilderItem, AXPBuilderItemIconTone, AXPBuilderItemViewModel, AXPBuilderSection, AXPBuilderTexts, AXPBuilderValue, AXPCategoryTreeActions, AXPCategoryTreeConfig, AXPCategoryTreeDataSource, AXPCategoryTreeEvents, AXPCategoryTreeNode, AXPColumnItemListItem, AXPCompareViewField, AXPCompareViewInputs, AXPCompareViewMode, AXPCompareViewObject, AXPDataSelectorAllowCreate, AXPDataSelectorColumn, AXPDataSelectorConfig, AXPDragDropListConfig, AXPDragDropListDropEvent, AXPDragDropListItem, AXPExpressionFieldDefinition, AXPExpressionGroupNode, AXPExpressionLogicDefinition, AXPExpressionLogicType, AXPExpressionNode, AXPExpressionNodeId, AXPExpressionOperationDefinition, AXPExpressionOperationNode, AXPExpressionOperationType, AXPExpressionTree, AXPExpressionValueOperand, AXPExpressionValueSourceType, AXPImageEditorOpenOptions, AXPLayoutSideDetailPanelEmptyState, AXPLayoutSideDetailPanelHeader, AXPLayoutSideDetailPanelHeaderIcon, AXPLayoutSideDetailPanelRow, AXPLayoutSideDetailPanelRowFormat, AXPLayoutSideDetailPanelSection, AXPMenuCustomizerAction, AXPMenuCustomizerItem, AXPMenuCustomizerItemType, AXPMenuCustomizerNodeData, AXPMenuCustomizerNodeMetadata, AXPMenuCustomizerState, AXPOutcomeResultRow, AXPOutcomeResultSection, AXPOutcomeResultValuePresentation, AXPOutcomeResultsViewModel, AXPPageComponentDefinition, AXPPageComponentProvider, AXPPreloadFiltersApplyEvent, AXPPropertyViewerActionRef, AXPPropertyViewerChangedEvent, AXPPropertyViewerConfig, AXPPropertyViewerGroup, AXPPropertyViewerResult, AXPPropertyViewerTab, AXPResourceAppointmentActionMenuItem, AXPResourceAppointmentBoardFilter, AXPResourceAppointmentItem, AXPResourceAppointmentResource, AXPResourceAppointmentStatus, AXPSpreadsheetCellChangeEvent, AXPSpreadsheetCellValue, AXPSpreadsheetColumn, AXPSpreadsheetConfig, AXPSpreadsheetData, AXPSpreadsheetItem, AXPSpreadsheetRowChangeEvent, AXPSpreadsheetRowMode, AXPStandardSectionFormContext, AXPStandardSectionItemsBuilderConfig, AXPTableColumnDefinition, AXPTableColumnsEditorOpenOptions, AXPTableDataEditorOpenOptions, AXPTemplateViewerConfig, AXPTemplateViewerResult, AXPUserAvatarData, AXPUserAvatarProvider, AXPUserAvatarSize, AXPUserAvatarStatus, AXPWidgetItemClickEvent, AXPWidgetItemData, AXPWidgetPropertiesChangedEvent, AXPWidgetPropertyInjection, AXPWidgetPropertyViewerConfig, AXPWidgetPropertyViewerResult, ConditionBuilderSelectedField, IAXPPropertyViewerDialogBuilder, IAXPPropertyViewerRoot, IAXPWidgetPropertyViewerDialogBuilder, IAXPWidgetPropertyViewerRoot, ItemConfiguratorListItem, StateMode };
+export type { AXPBuilderBadge, AXPBuilderBadgeVariant, AXPBuilderDefinition, AXPBuilderItem, AXPBuilderItemIconTone, AXPBuilderItemViewModel, AXPBuilderSection, AXPBuilderTexts, AXPBuilderValue, AXPCategoryTreeActions, AXPCategoryTreeConfig, AXPCategoryTreeDataSource, AXPCategoryTreeEvents, AXPCategoryTreeNode, AXPColumnItemListItem, AXPCompareViewField, AXPCompareViewInputs, AXPCompareViewMode, AXPCompareViewObject, AXPDataSelectorAllowCreate, AXPDataSelectorCategoryConfig, AXPDataSelectorCategoryFilterConfig, AXPDataSelectorColumn, AXPDataSelectorConfig, AXPDataSelectorCreateConfig, AXPDataSelectorFilterConfig, AXPDataSelectorGridConfig, AXPDataSelectorRowActionItem, AXPDataSelectorRowActionsHandler, AXPDataSelectorSearchConfig, AXPDataSelectorSearchField, AXPDataSelectorSelectionConfig, AXPDragDropListConfig, AXPDragDropListDropEvent, AXPDragDropListItem, AXPExpressionFieldDefinition, AXPExpressionGroupNode, AXPExpressionLogicDefinition, AXPExpressionLogicType, AXPExpressionNode, AXPExpressionNodeId, AXPExpressionOperationDefinition, AXPExpressionOperationNode, AXPExpressionOperationType, AXPExpressionTree, AXPExpressionValueOperand, AXPExpressionValueSourceType, AXPImageEditorOpenOptions, AXPLayoutSideDetailPanelEmptyState, AXPLayoutSideDetailPanelHeader, AXPLayoutSideDetailPanelHeaderIcon, AXPLayoutSideDetailPanelRow, AXPLayoutSideDetailPanelRowFormat, AXPLayoutSideDetailPanelSection, AXPMenuCustomizerAction, AXPMenuCustomizerItem, AXPMenuCustomizerItemType, AXPMenuCustomizerNodeData, AXPMenuCustomizerNodeMetadata, AXPMenuCustomizerState, AXPOutcomeResultRow, AXPOutcomeResultSection, AXPOutcomeResultValuePresentation, AXPOutcomeResultsViewModel, AXPPageComponentDefinition, AXPPageComponentProvider, AXPPreloadFiltersApplyEvent, AXPPropertyViewerActionRef, AXPPropertyViewerChangedEvent, AXPPropertyViewerConfig, AXPPropertyViewerGroup, AXPPropertyViewerResult, AXPPropertyViewerTab, AXPResourceAppointmentActionMenuItem, AXPResourceAppointmentBoardFilter, AXPResourceAppointmentItem, AXPResourceAppointmentResource, AXPResourceAppointmentStatus, AXPSpreadsheetCellChangeEvent, AXPSpreadsheetCellValue, AXPSpreadsheetColumn, AXPSpreadsheetConfig, AXPSpreadsheetData, AXPSpreadsheetItem, AXPSpreadsheetRowChangeEvent, AXPSpreadsheetRowMode, AXPStandardSectionFormContext, AXPStandardSectionItemsBuilderConfig, AXPTableColumnDefinition, AXPTableColumnsEditorOpenOptions, AXPTableDataEditorOpenOptions, AXPTemplateViewerConfig, AXPTemplateViewerResult, AXPUserAvatarData, AXPUserAvatarProvider, AXPUserAvatarSize, AXPUserAvatarStatus, AXPWidgetItemClickEvent, AXPWidgetItemData, AXPWidgetPropertiesChangedEvent, AXPWidgetPropertyInjection, AXPWidgetPropertyViewerConfig, AXPWidgetPropertyViewerResult, ConditionBuilderSelectedField, IAXPPropertyViewerDialogBuilder, IAXPPropertyViewerRoot, IAXPWidgetPropertyViewerDialogBuilder, IAXPWidgetPropertyViewerRoot, ItemConfiguratorListItem, StateMode };