@acorex/platform 20.8.9 → 20.8.10

package/{common/index.d.ts → types/acorex-platform-common.d.ts}

@@ -4,8 +4,8 @@ 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, AXPOptionsData, AXPExpression, AXPFilterDefinition, AXPMetaData, AXPSystemActionType, AXPValidationRules, AXPGridLayoutOptions, AXPLogoConfig, AXPFileListItem, AXPNavigateActionCommand, AXPExecuteCommand, AXPApplicationUserReference, AXPEntityReference, AXPPlatformScopeKey, AXPWidgetTriggers, AXPPlatformScope, AXPExpressionEvaluatorScopeProvider, AXPExpressionEvaluatorScopeProviderContext } from '@acorex/platform/core';
-import { AXPWidgetTypesMap, AXPMetaDataDefinition, AXPWidgetNode } from '@acorex/platform/layout/widget-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 { AXPWidgetTypesMap, AXPMetaDataDefinition, AXPWidgetNode, AXPWidgetProperty } from '@acorex/platform/layout/widget-core';
 import * as i6 from '@angular/router';
 import { Route, Routes } from '@angular/router';
 import * as i1 from '@acorex/platform/workflow';
@@ -38,7 +38,6 @@ interface AXEntityPropertyWidget {
     type: AXPWidgetTypesMap[keyof AXPWidgetTypesMap] | string;
     path?: string;
     id?: string;
-    formula?: string;
     children?: AXEntityPropertyWidget[];
     mode: 'view' | 'edit';
     options?: Record<string, any>;
@@ -81,6 +80,7 @@ interface AXPEntityPropertyLayoutConfig extends AXPGridLayoutOptions {
         visible?: boolean;
     };
     order?: number;
+    visible?: boolean | AXPExpression;
 }
 interface AXPEntityPropertyGroup {
     id: string;
@@ -215,7 +215,7 @@ interface AXPCommandActionDisplay extends Partial<AXPCommandActionLook> {
     command: AXPCommandActionCallback;
     title: string;
     type: AXPSystemActionType | string;
-    priority: 'primary' | 'secondary';
+    priority: 'primary' | 'secondary' | 'none';
     separated?: boolean;
     permissions?: string[];
     hidden?: boolean | string;
@@ -225,6 +225,8 @@ interface AXPCommandActionDisplay extends Partial<AXPCommandActionLook> {
 }
 interface AXPEntityAction extends AXPCommandActionDisplay {
     scope: AXPEntityCommandScope;
+    /** Child actions for dropdown submenu */
+    items?: AXPEntityAction[];
 }
 interface AXPEntity {
     plugins?: {
@@ -265,6 +267,7 @@ interface AXPEntity {
         };
     };
     relatedEntities?: AXPRelatedEntity[];
+    pages?: AXPEntityPage[];
     groups?: AXPEntityPropertyGroup[];
     properties: AXPEntityProperty[];
     columns?: AXPEntityTableColumn[];
@@ -318,25 +321,30 @@ interface AXPRelatedEntity {
     entity: string;
     title?: string;
     icon?: string;
-    /**
-     * Either a list of property names, or full table column metadata (`AXPEntityTableColumn`).
-     * For table columns, use `options.visible` as boolean or expression string (evaluated on parent detail).
-     */
     columns?: string[] | AXPEntityTableColumn[];
     properties?: string[];
+    excludeProperties?: string[];
     layout?: {
         type: 'tab-detail' | 'tab-list' | 'page-detail' | 'page-list' | 'merge-detail';
         order?: number;
         position?: 'before' | 'after' | 'middle';
     };
     conditions?: AXPQueryFilter[];
-    /**
-     * Optional toolbar filter definitions merged when the related list is built.
-     * Entries matching an existing property `field` override/extend that filter definition.
-     */
     customFilterDefinitions?: Partial<AXPFilterDefinition>[];
-    hidden?: boolean | string;
+    hidden?: boolean | AXPExpression;
     actions?: AXPEntityAction[];
+    /**
+     * Controls inclusion on the host entity master **create** / **update** form.
+     * Defaults depend on layout:
+     * - **merge-detail**: omitted flags behave as **true** (opt-out with `false`).
+     * - **tab-list** / **page-list**: omitted flags behave as **false** (opt-in with `true`).
+     */
+    appearOn?: {
+        /** Include on host create form (see defaults above per layout type). */
+        create?: boolean;
+        /** Include on host update form (see defaults above per layout type). */
+        update?: boolean;
+    };
     /**
      * Relationship-level persistence strategy for merge-detail data.
      * Defaults:
@@ -355,7 +363,53 @@ interface AXPRelatedEntity {
         cascade?: {
             delete?: 'none' | 'orphans' | 'all';
         };
+        foreignKeyField?: string;
+    };
+}
+interface AXPEntityPage {
+    /**
+     * Key to identify the component in the page component registry
+     */
+    componentKey: string;
+    /**
+     * Property name to render when the page component displays an entity field (e.g. 'questions', 'attachments').
+     * Passed to the page component as pageConfig.field.
+     */
+    field?: string;
+    /**
+     * Title of the page (displayed in navigation)
+     */
+    title?: AXPMultiLanguageString;
+    /**
+     * Icon for the page (displayed in navigation)
+     */
+    icon?: string;
+    /**
+     * Description of the page
+     */
+    description?: AXPMultiLanguageString;
+    /**
+     * Layout configuration for page positioning
+     */
+    layout?: {
+        /**
+         * Order of the page (lower numbers appear first)
+         */
+        order?: number;
+        /**
+         * Position relative to the main page
+         */
+        position?: 'before' | 'after' | 'middle';
     };
+    /**
+     * Visibility condition (boolean or expression string)
+     */
+    hidden?: boolean | string;
+    /**
+     * Permissions required to view this page
+     */
+    permissions?: string[];
+    options?: Record<string, any>;
 }
 interface AXPCategoryEntity {
     entity: string;
@@ -373,18 +427,18 @@ interface AXPEntityVersionHistory {
 interface AXPAggregate {
     id: string;
     name: string;
-    title: string;
+    title: AXPMultiLanguageString;
     entities: AXPEntity[];
 }
 interface AXPModule {
     name: string;
-    title: string;
+    title: AXPMultiLanguageString;
     aggregates: AXPAggregate[];
     relationships?: AXPRelationship[];
 }
 interface AXPApplication {
     name: string;
-    title: string;
+    title: AXPMultiLanguageString;
     modules: AXPModule[];
 }
 interface AXPEntityMasterLayoutView {
@@ -392,12 +446,23 @@ interface AXPEntityMasterLayoutView {
     sections: AXPEntitySectionView[];
     properties?: AXPEntityPropertyView[];
 }
+/** Quick create config for lookup widgets (+ button) - uses subset of create form */
+interface AXPEntityQuickCreate {
+    enabled?: boolean;
+    properties?: string[];
+    layout?: {
+        size?: AXPopupSizeType;
+    };
+    excludeProperties?: string[];
+}
 interface AXPEntityMasterCreateLayoutView extends AXPEntityMasterLayoutView {
     steps?: {
         id: string;
         title: string;
         description?: string;
     };
+    /** Quick create config for lookup widgets - uses subset of create form */
+    quickCreate?: AXPEntityQuickCreate;
 }
 interface AXPEntityMasterUpdateLayoutView extends AXPEntityMasterLayoutView {
 }
@@ -444,6 +509,51 @@ interface AXPQuerySort {
     name: string;
     dir: 'asc' | 'desc';
 }
+declare enum AXPEntityType {
+    Entity = 0,
+    AggregateRoot = 1,
+    ValueObject = 2
+}
+interface AXPEntityV2 {
+    version: 2;
+    module: string;
+    aggregate: string;
+    name: string;
+    type: AXPEntityType;
+    icon?: string;
+    title: string;
+    description?: string;
+    plugins?: {
+        name: string;
+        options?: AXPOptionsData;
+    }[];
+    pages?: AXPEntityPage[];
+    groups?: AXPEntityPropertyGroup[];
+    properties: AXPEntityProperty[];
+    formats: {
+        individual: string;
+        plural: string;
+        lookup?: string;
+        displayName?: string;
+        searchResult?: {
+            title: string;
+            description?: string;
+        };
+    };
+    columns?: AXPEntityTableColumn[];
+    validations?: AXPValidationRules;
+    interfaces?: {
+        master?: {
+            single?: AXPEntityMasterSingleLayoutView;
+            list?: AXPEntityMasterListView;
+            create?: AXPEntityMasterCreateLayoutView;
+            update?: AXPEntityMasterUpdateLayoutView;
+        };
+        detail?: {
+            list?: AXPEntityDetailListView;
+        };
+    };
+}
 
 interface AXPFilterOperator {
     name: string;
@@ -585,6 +695,7 @@ declare enum AXPCommonSettings {
     ApplyLayoutOrdering = "Common:Setting:Entity.ApplyLayoutOrdering",
     RedirectToDetailsAfterCreate = "Common:Setting:Entity.RedirectToDetailsAfterCreate",
     ShowPageBadge = "Common:Setting:Entity.ShowPageBadge",
+    DebugMode = "PlatformDevTools:Setting:Developer.DebugMode",
     ShowRowIndexColumn = "Common:Setting:Entity.ShowRowIndexColumn",
     EntityListPersistenceMode = "Common:Setting:Entity.ListPersistenceMode"
 }
@@ -1166,16 +1277,23 @@ declare class AXPStickyDirective {
     private _isSticky;
     get isSticky(): boolean;
     set isSticky(value: boolean);
-    private topOffset;
     private parentElement;
     private targetElement;
     private mutationObserver;
+    private readonly onWindowResize;
     stickyParent: string | HTMLElement;
     stickyTarget: string;
     constructor(element: ElementRef<HTMLDivElement>, renderer: Renderer2, zone: NgZone, cdr: ChangeDetectorRef);
     ngAfterViewInit(): void;
     private initSticky;
-    private updateTopOffset;
+    private getScrollTop;
+    /**
+     * Toggle stuck styling only while this element is visually pinned (matches `position: sticky; top: 0`).
+     * Scroll-offset thresholds would stay true for every section already passed, so multiple stacked stickies
+     * would all keep `--stuck`; geometry fixes that.
+     */
+    private computeShouldStick;
+    private applyStickyStateFromScrollPosition;
     private onParentScroll;
     private toggleStickyClasses;
     ngOnDestroy(): void;
@@ -1183,6 +1301,18 @@ declare class AXPStickyDirective {
     static ɵdir: i0.ɵɵDirectiveDeclaration<AXPStickyDirective, "[axpSticky]", ["axpSticky"], { "stickyClass": { "alias": "axpSticky"; "required": false; }; "stickyOffset": { "alias": "stickyOffset"; "required": false; }; "stickyParent": { "alias": "stickyParent"; "required": false; }; "stickyTarget": { "alias": "stickyTarget"; "required": false; }; }, { "isStickyChange": "isStickyChange"; }, never, never, true, never>;
 }
 
+/**
+ * Registered menu items (raw tree flattened) for select widgets via dataSource name {@link MENU_ITEMS_DATASOURCE_NAME}.
+ */
+declare const MENU_ITEMS_DATASOURCE_NAME = "platform-menu-items";
+/**
+ * Data source definition for menu items from {@link AXPMenuProviderService#rawItems}.
+ */
+declare class AXPMenuItemsDataSourceDefinition implements AXPDataSourceDefinitionProvider {
+    private readonly menuProviderService;
+    items(): Promise<AXPDataSourceDefinition[]>;
+}
+
 type AXPMenuInsertion = 'before' | 'after' | 'inside';
 type AXPMenuType = 'menu' | 'group' | 'break';
 type AXPMenuItemCommand = AXPNavigateActionCommand<'modal' | 'router'> | AXPExecuteCommand;
@@ -1574,8 +1704,8 @@ interface AXPSearchResult {
     id?: string;
     group: string;
     data?: any;
-    title?: string;
-    description?: string;
+    title?: string | AXPMultiLanguageString;
+    description?: string | AXPMultiLanguageString;
     icon?: string;
     command: AXPExecuteCommand;
     parent?: AXPSearchParentResult;
@@ -1591,8 +1721,8 @@ interface AXPSearchDisplayResult {
     definitionName?: string;
     definitionTitle?: string;
     name: string;
-    title: string;
-    description?: string;
+    title: string | AXPMultiLanguageString;
+    description?: string | AXPMultiLanguageString;
     icon: string;
     data?: any;
     order?: any;
@@ -1664,6 +1794,7 @@ interface AXPSearchProvider {
     search(text: string): Promise<AXPSearchResult[]>;
 }
 declare abstract class AXPSearchCommandProvider {
+    private readonly translationService;
     abstract commands: AXPSearchResult[];
     search(text: string): Promise<AXPSearchResult[]>;
 }
@@ -1673,11 +1804,39 @@ declare class AXPSearchService {
     private providers;
     private definitionService;
     private formatService;
+    private translationService;
     search(text: string): Promise<AXPSearchDisplayGroupResult[]>;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXPSearchService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<AXPSearchService>;
 }
 
+/**
+ * Shared utility for creating Entity:Create command options used in search command providers.
+ * Use with command: { name: 'Entity:Create', options: createEntityCommandOptions(...) }
+ */
+declare function createEntityCommandOptions(entityKey: string, entityInfo: {
+    name: string;
+    module: string;
+    title: string;
+}): Record<string, unknown>;
+/**
+ * Creates a search command for "Create {Entity}" with consistent i18n pattern.
+ * Use titleKey/descriptionKey from module (e.g. @module:entity.permissions.create.title).
+ * Standard: "Create {Entity}" for title, "Create new {entities}" for description.
+ */
+declare function createEntitySearchCommand(config: {
+    id: string;
+    entityKey: string;
+    entityInfo: {
+        name: string;
+        module: string;
+        title: string;
+    };
+    titleKey: string;
+    descriptionKey?: string;
+    icon: string;
+}): AXPSearchResult;
+
 declare class AXPMenuSearchDefinitionProvider implements AXPSearchDefinitionProvider {
     provide(context: AXPSearchDefinitionProviderContext): Promise<void>;
 }
@@ -1750,10 +1909,65 @@ declare abstract class AXPLockService {
     static ɵprov: i0.ɵɵInjectableDeclaration<AXPLockService>;
 }
 
+/**
+ * Synchronous access to default multi-language behavior for named entity fields and widget
+ * property bindings. Mirrors {@link AXPLayoutOrderingConfigService}: avoids async in entity
+ * modifiers and startup deadlocks.
+ */
+declare class AXPDefaultMultiLanguageConfigService {
+    private readonly settingsService;
+    private readonly _applyDefault;
+    private syncScheduled;
+    constructor();
+    getApplyDefaultMultiLanguage(): boolean;
+    private syncFromSettings;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AXPDefaultMultiLanguageConfigService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<AXPDefaultMultiLanguageConfigService>;
+}
+
+/**
+ * Shared multi-language defaults for entity properties and widget property bindings.
+ *
+ * **Circular dependencies:** use only `import type` for `AXPWidgetProperty` and
+ * `AXPEntityProperty` so this module has no runtime imports from widget-core or application
+ * types — `@acorex/platform/layout/widget-core` does not import `@acorex/platform/common`.
+ */
+
+/**
+ * Widget types that support the multiLanguage option (text / rich text editors).
+ */
+declare const MULTILANGUAGE_CAPABLE_WIDGET_TYPES: Set<string>;
+/**
+ * Common property names / binding path segments that are usually translatable when the feature is
+ * enabled in settings. Explicit `multiLanguage` on the property still wins.
+ */
+declare const DEFAULT_MULTILANGUAGE_FIELD_NAMES: Set<string>;
+declare function shouldApplyDefaultMultiLanguageToEntityProperty(prop: AXPEntityProperty): boolean;
+declare function shouldApplyDefaultMultiLanguageToWidgetProperty(prop: AXPWidgetProperty): boolean;
+/**
+ * Leaf widget nodes in entity `schema.interface` trees (e.g. GridLayout → RichText under `pre` /
+ * `post`) — same path/type rules as {@link shouldApplyDefaultMultiLanguageToWidgetProperty}, without
+ * `schema.dataType` (nodes do not carry entity schema).
+ */
+declare function shouldApplyDefaultMultiLanguageToWidgetNode(node: AXPWidgetNode): boolean;
+/**
+ * When {@link AXPDefaultMultiLanguageConfigService#getApplyDefaultMultiLanguage} is true, sets
+ * `options.multiLanguage` on eligible editor leaves inside an entity property's widget tree
+ * (including nested layouts). Used by entity middleware so object fields (e.g. `pre`, `post`) are
+ * covered, not only top-level string properties.
+ */
+declare function withDefaultMultiLanguageOnWidgetNodeTree(root: AXPWidgetNode | undefined | null, applyDefault: boolean): AXPWidgetNode | undefined | null;
+/**
+ * When {@link AXPDefaultMultiLanguageConfigService#getApplyDefaultMultiLanguage} is true, sets
+ * `schema.interface.options.multiLanguage` for eligible string widget properties (same rules as
+ * entity middleware), unless the property already specifies `multiLanguage`.
+ */
+declare function withDefaultMultiLanguageOnWidgetProperty(prop: AXPWidgetProperty, applyDefault: boolean): AXPWidgetProperty;
+
 declare class AXPSettingDefinitionProviderContext {
     private rootGroups;
     private groupMap;
-    addGroup(name: string, title: string, description?: string, icon?: string): AXPSettingDefinitionGroupBuilder;
+    addGroup(name: string, title: string, description?: string, icon?: string, pageTitle?: string): AXPSettingDefinitionGroupBuilder;
     group(name: string): AXPSettingDefinitionGroupBuilder | null;
     getGroups(): AXPSettingDefinitionGroup[];
     hasGroup(name: string): boolean;
@@ -1765,7 +1979,7 @@ declare class AXPSettingDefinitionGroupBuilder {
     constructor(context: AXPSettingDefinitionProviderContext, group: AXPSettingDefinitionGroup);
     addSection(name: string, title: string, description?: string): AXPSettingDefinitionSectionBuilder;
     section(name: string): AXPSettingDefinitionSectionBuilder | null;
-    addGroup(name: string, title: string, description?: string, icon?: string): AXPSettingDefinitionGroupBuilder;
+    addGroup(name: string, title: string, description?: string, icon?: string, pageTitle?: string): AXPSettingDefinitionGroupBuilder;
     endGroup(): AXPSettingDefinitionProviderContext;
 }
 declare class AXPSettingDefinitionSectionBuilder {
@@ -1783,6 +1997,7 @@ declare class AXPSettingDefinitionSectionBuilder {
             layout?: AXPGridLayoutOptions;
         };
         description?: string;
+        searchTagKeys?: string[];
         isRequired?: boolean;
         isInherited?: boolean;
         isEncrypted?: boolean;
@@ -1823,6 +2038,8 @@ interface AXPSettingDefinition {
     name: string;
     title: string;
     description?: string;
+    /** Optional i18n keys (e.g. `@scope:key`) whose translated values are included in settings search. */
+    searchTagKeys?: string[];
     widget: AXPWidgetNode;
     layout?: AXPGridLayoutOptions;
     scope: AXPPlatformScopeKey;
@@ -1834,7 +2051,10 @@ interface AXPSettingDefinition {
 }
 interface AXPSettingDefinitionGroup {
     name: string;
+    /** Short label (e.g. sidebar); i18n key when using the translation pipe. */
     title: string;
+    /** Optional fuller page heading; i18n key. When omitted, `title` is used for the page header. */
+    pageTitle?: string;
     icon?: string;
     description?: string;
     groups: AXPSettingDefinitionGroup[];
@@ -1885,6 +2105,25 @@ declare class AXPSettingDefaultValuesAggregatorService {
 
 declare const AXP_SETTING_VALUE_PROVIDER: InjectionToken<AXPSettingValueProvider[]>;
 
+/**
+ * Supported primitive coercions for persisted setting values (including `{ value: ... }` wrappers).
+ */
+type AXPSettingCoercionKind = 'string' | 'boolean' | 'number' | 'date';
+/**
+ * If the payload uses the common `{ value: T }` shape from setting widgets, returns the inner value; otherwise returns `raw`.
+ */
+declare function peelSettingValueKey(raw: unknown): unknown;
+/**
+ * Picks a primitive coercion kind from the setting definition default and/or the effective stored value.
+ * Type argument `T` on the settings service `get` method is compile-time only; runtime behavior follows this inference.
+ */
+declare function inferSettingCoercionKind(defaultSample: unknown, effective: unknown): AXPSettingCoercionKind | null;
+declare function coerceAXPSettingRawValueByKind(raw: unknown, kind: AXPSettingCoercionKind): string | boolean | number | Date;
+declare function coerceAXPSettingRawValue(raw: unknown, kind: 'string'): string;
+declare function coerceAXPSettingRawValue(raw: unknown, kind: 'boolean'): boolean;
+declare function coerceAXPSettingRawValue(raw: unknown, kind: 'number'): number;
+declare function coerceAXPSettingRawValue(raw: unknown, kind: 'date'): Date;
+
 interface AXPSettingsServiceInterface {
     load(): Promise<AXPSettingValue[]>;
     get<T = any>(key: string): Promise<T>;
@@ -1902,7 +2141,16 @@ declare class AXPSettingsService implements AXPSettingsServiceInterface {
     constructor();
     reload(): Promise<void>;
     load(): Promise<AXPSettingValue[]>;
+    /**
+     * Returns the effective setting value. Primitive coercion (string, boolean, number, date) is inferred from the
+     * definition default and/or the stored shape (including `{ value: ... }`). Type argument `T` is compile-time only;
+     * it is not read at runtime—use it to document the expected result (e.g. `get<boolean>(key)`).
+     */
     get<T = any>(key: string): Promise<T>;
+    /**
+     * Effective value (user → tenant → platform) when set; otherwise the definition default. Used for reads and coercion hints.
+     */
+    private resolveEffectiveAndDefault;
     defaultValues(scope: AXPPlatformScope): Promise<Record<string, unknown>>;
     scope(scope: AXPPlatformScope): ScopedSettingService;
     invokeChangeEvent(event: AXPSettingChangedEvent): void;
@@ -1924,9 +2172,17 @@ declare class ScopedSettingService {
 }
 
 /**
- * Regional settings keys for date, time, and locale formatting.
- * These keys are used by platform widgets and components to access regional settings.
- * The actual setting definitions and providers are implemented in the locale-management module.
+ * Exposes platform settings in expression strings, e.g.
+ * `{{ settings.get('Common:Setting:Entity.ShowPageBadge') }}`.
+ */
+declare class AXPSettingsEvaluatorScopeProvider implements AXPExpressionEvaluatorScopeProvider {
+    private readonly settingsService;
+    provide(context: AXPExpressionEvaluatorScopeProviderContext): Promise<void>;
+}
+
+/**
+ * Regional and locale-related setting keys used by platform widgets and components.
+ * Most values use the `LocaleManagement:Setting:Regional.*` prefix; definitions live in the locale-management module where applicable.
  */
 declare enum AXPRegionalSetting {
     LocaleProfile = "LocaleManagement:Setting:Regional.LocaleProfile",
@@ -1948,7 +2204,9 @@ declare enum AXPRegionalSetting {
     WeightUnits = "LocaleManagement:Setting:Regional.WeightUnits",
     VolumeUnits = "LocaleManagement:Setting:Regional.VolumeUnits",
     SpeedUnits = "LocaleManagement:Setting:Regional.SpeedUnits",
-    AreaUnits = "LocaleManagement:Setting:Regional.AreaUnits"
+    AreaUnits = "LocaleManagement:Setting:Regional.AreaUnits",
+    /** Default multi-language behavior for standard text field names; defined in locale-management `AXMRegionalSettingProvider`. */
+    MultiLanguageSupport = "LocaleManagement:Setting:Regional.MultiLanguageSupport"
 }
 
 /**
@@ -2156,6 +2414,10 @@ declare class AXPStatusDefinitionProviderService {
      * Checks if the transition exists in the provider's transitions list
      */
     private isValidTransition;
+    /**
+     * Best-effort plain string for {@link Error} messages (no i18n lookup).
+     */
+    private commandMessageTextForError;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXPStatusDefinitionProviderService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<AXPStatusDefinitionProviderService>;
 }
@@ -2559,6 +2821,16 @@ interface AXPCurrency {
     format: string;
 }
 
+/**
+ * Narrow API for reading app locale profiles and active languages.
+ * Implemented by locale-management; consumed by platform layout without importing the module (avoids circular deps).
+ */
+interface AXPLocaleManagementPort {
+    getLocaleProfiles(): Promise<AXPLocaleProfile[]>;
+    getLanguages(): Promise<AXPLanguage[]>;
+}
+declare const AXP_LOCALE_MANAGEMENT_PORT: InjectionToken<AXPLocaleManagementPort>;
+
 interface AXPVersionStream {
     id: string;
     entityType: string;
@@ -2712,5 +2984,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, AXPDialogConfirmAction, AXPEntityCommandScope, AXPEntityQueryType, AXPErrorHandlerRegistryService, AXPExportService, AXPFileActionsService, AXPFileStorageService, AXPFileStorageStatus, AXPFileTypeProviderService, AXPFilterOperatorMiddlewareService, AXPFilterOperatorMiddlewareServiceImpl, AXPFooterTextSlotComponent, AXPGlobalErrorHandler, AXPHomePageModule, AXPHomePageService, AXPLockService, AXPMenuMiddlewareRegistry, AXPMenuProviderService, AXPMenuSearchDefinitionProvider, AXPMenuSearchProvider, AXPMenuService, AXPMenuVisibilityService, AXPNavBarSlotComponent, AXPNavigateWorkflow, AXPPlatformDefaultConfigs, AXPRedirectEvent, AXPRefreshEvent, AXPRegionalSetting, AXPRelationshipCardinality, AXPRelationshipKind, AXPReloadAction, AXPReloadEvent, AXPSearchCommandProvider, AXPSearchDefinitionActionBuilder, AXPSearchDefinitionBuilder, AXPSearchDefinitionProviderContext, AXPSearchDefinitionProviderService, AXPSearchService, AXPSettingDefaultValuesAggregatorService, AXPSettingDefinitionGroupBuilder, AXPSettingDefinitionProviderContext, AXPSettingDefinitionProviderService, AXPSettingDefinitionSectionBuilder, AXPSettingsService, AXPStatusDefinitionProviderService, AXPStatusProvider, AXPStickyDirective, AXPSystemStatusType, AXPSystemStatuses, AXPToastAction, AXPTokenDefinitionService, AXPTokenEvaluatorScopeProvider, AXPVersioningService, AXPWorkflowNavigateAction, AXPWorkflowRouterNavigateAction, AXP_APP_VERSION_PROVIDER, AXP_FILE_ACTION_PROVIDER, AXP_FILE_TYPE_INFO_PROVIDER, AXP_HOME_PAGES, AXP_HOME_PAGE_DEFAULT_KEY, AXP_MENU_MIDDLEWARE, AXP_MENU_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, ENDS_WITH_OPER, ENVIRONMENT, EQ_OPER, GTE_OPER, GT_OPER, IN_OPER, IS_EMPTY_OPER, IS_NOT_EMPTY_OPER, LTE_OPER, LT_OPER, NOT_CONTAINS_OPER, NOT_EQ_OPER, NUMBER_OPERATORS, STARTS_WITH_OPER, STRING_OPERATORS, UploadFromComputerActionProvider, configPlatform, createAllQueryView, createMenuContext, createMenuMiddleware, createQueryView, getEntityInfo, getStatusInfo, getSystemStatus, provideDynamicHomePage, provideMenuMiddleware, resolveStatusLook, systemStatusToDefinition };
-export type { AXCFileUploaderAction, AXCFileUploaderActionsPayload, AXCFileUploaderCapabilities, AXEntityPropertyWidget, AXPAggregate, AXPAppVersion, AXPAppVersionProvider, AXPApplication, AXPCategoryEntity, AXPColumnAlign, AXPColumnContentAlign, AXPCommandActionCallback, AXPCommandActionDisplay, AXPCommandActionLook, AXPCommandActionPriority, AXPCommandActionType, AXPCommonModuleConfigs, AXPCurrency, AXPDomToImageOptions, AXPEntity, AXPEntityAction, AXPEntityCommand, AXPEntityDetailListView, AXPEntityMasterCreateLayoutView, AXPEntityMasterLayoutView, AXPEntityMasterListView, AXPEntityMasterSingleLayoutView, AXPEntityMasterUpdateLayoutView, AXPEntityProperty, AXPEntityPropertyCreateView, AXPEntityPropertyGroup, AXPEntityPropertyLayoutConfig, AXPEntityPropertyUpdateView, AXPEntityPropertyView, AXPEntityQuery, AXPEntitySectionView, AXPEntityTableColumn, AXPEntityVersionHistory, AXPErrorHandler, AXPFileActionProvider, AXPFileActionProviderToken, AXPFileExtension, AXPFileManyStorageInfo, AXPFileStorageCreateRequest, AXPFileStorageFindRequest, AXPFileStorageInfo, AXPFileStorageUpdateRequest, AXPFileType, AXPFileTypeInfoProvider, AXPFilterOperator, AXPGeoLocation, AXPGroupSearchResult, AXPHomePageDefinition, AXPLanguage, AXPLocaleProfile, AXPLockGetInfoRequest, AXPLockInfo, AXPLockRequest, AXPLockType, AXPMenuFinderResult, AXPMenuInsertion, AXPMenuItem, AXPMenuItemCommand, AXPMenuItemFinder, AXPMenuItemWithParent, AXPMenuMiddleware, AXPMenuMiddlewareContext, AXPMenuMiddlewareProvider, AXPMenuProvider, AXPMenuProviderContext, AXPMenuType, AXPModule, AXPPlatformConfigs, AXPQueryFilter, AXPQuerySort, AXPQueryView, AXPRelatedEntity, AXPRelationship, AXPRootConfigs, AXPSearchAction, AXPSearchDefinition, AXPSearchDefinitionDisplayFormat, AXPSearchDefinitionProvider, AXPSearchDisplayGroupResult, AXPSearchDisplayResult, AXPSearchDisplayResultForSave, AXPSearchParentResult, AXPSearchProvider, AXPSearchResult, AXPSettingChangedEvent, AXPSettingDefaultValuesProvider, AXPSettingDefinition, AXPSettingDefinitionGroup, AXPSettingDefinitionProvider, AXPSettingDefinitionSection, 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, AXPFileStorageService, AXPFileStorageStatus, AXPFileTypeProviderService, AXPFilterOperatorMiddlewareService, AXPFilterOperatorMiddlewareServiceImpl, AXPFooterTextSlotComponent, AXPGlobalErrorHandler, AXPHomePageModule, AXPHomePageService, AXPLockService, AXPMenuItemsDataSourceDefinition, AXPMenuMiddlewareRegistry, AXPMenuProviderService, AXPMenuSearchDefinitionProvider, AXPMenuSearchProvider, AXPMenuService, AXPMenuVisibilityService, AXPNavBarSlotComponent, AXPNavigateWorkflow, 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_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_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_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, coerceAXPSettingRawValue, coerceAXPSettingRawValueByKind, configPlatform, createAllQueryView, createEntityCommandOptions, createEntitySearchCommand, createMenuContext, createMenuMiddleware, createQueryView, getEntityInfo, getStatusInfo, getSystemStatus, inferSettingCoercionKind, peelSettingValueKey, provideDynamicHomePage, provideMenuMiddleware, resolveStatusLook, shouldApplyDefaultMultiLanguageToEntityProperty, shouldApplyDefaultMultiLanguageToWidgetNode, shouldApplyDefaultMultiLanguageToWidgetProperty, systemStatusToDefinition, withDefaultMultiLanguageOnWidgetNodeTree, withDefaultMultiLanguageOnWidgetProperty };
+export type { AXCFileUploaderAction, AXCFileUploaderActionsPayload, AXCFileUploaderCapabilities, AXEntityPropertyWidget, AXPAggregate, AXPAppVersion, AXPAppVersionProvider, AXPApplication, AXPCategoryEntity, AXPColumnAlign, AXPColumnContentAlign, AXPCommandActionCallback, AXPCommandActionDisplay, AXPCommandActionLook, AXPCommandActionPriority, AXPCommandActionType, AXPCommonModuleConfigs, AXPCurrency, 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, AXPLanguage, AXPLocaleManagementPort, AXPLocaleProfile, AXPLockGetInfoRequest, AXPLockInfo, AXPLockRequest, AXPLockType, AXPMenuFinderResult, AXPMenuInsertion, AXPMenuItem, AXPMenuItemCommand, AXPMenuItemFinder, AXPMenuItemWithParent, AXPMenuMiddleware, AXPMenuMiddlewareContext, AXPMenuMiddlewareProvider, AXPMenuProvider, AXPMenuProviderContext, AXPMenuType, AXPModule, AXPPlatformConfigs, AXPQueryFilter, AXPQuerySort, AXPQueryView, AXPRelatedEntity, AXPRelationship, AXPRootConfigs, AXPSearchAction, AXPSearchDefinition, AXPSearchDefinitionDisplayFormat, AXPSearchDefinitionProvider, AXPSearchDisplayGroupResult, AXPSearchDisplayResult, AXPSearchDisplayResultForSave, AXPSearchParentResult, AXPSearchProvider, AXPSearchResult, AXPSettingChangedEvent, AXPSettingCoercionKind, AXPSettingDefaultValuesProvider, AXPSettingDefinition, AXPSettingDefinitionGroup, AXPSettingDefinitionProvider, AXPSettingDefinitionSection, AXPSettingValue, AXPSettingValueProvider, AXPSettingsServiceInterface, AXPStatusDefinition, AXPStatusTransition, AXPTimeZone, AXPTokenDefinition, AXPTokenDefinitionProvider, AXPTokenDefinitionProviderToken, AXPUnLockRequest, AXPVersionChange, AXPVersionEntry, AXPVersionStream, CanonicalChange, CanonicalChangeOp, VersionedFileInfo };