@acorex/platform 21.0.0-next.3 → 21.0.0-next.33

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

@@ -1,11 +1,11 @@
 import * as i0 from '@angular/core';
 import { InjectionToken, EnvironmentProviders, Injector, ErrorHandler, ModuleWithProviders, EventEmitter, ElementRef, Renderer2, NgZone, ChangeDetectorRef } from '@angular/core';
-import { AXStyleColorType, AXDataSourceOperator, AXDataSourceFilterOption } from '@acorex/cdk/common';
+import { AXDataSourceOperator, AXStyleColorType, AXDataSourceFilterOption } from '@acorex/cdk/common';
 import * as i2 from '@acorex/components/popup';
 import { AXPopupSizeType, AXPopupService } from '@acorex/components/popup';
 import * as i5 from '@acorex/platform/core';
-import { AXPValueTransformerFunctions, AXPGridLayoutOptions, AXPValidationRules, AXPSystemActionType, AXPMetaData, AXPOptionsData, AXPLogoConfig, AXPNavigateActionCommand, AXPExecuteCommand, AXPEntityReference, AXPApplicationUserReference, AXPPlatformScopeKey, AXPPlatformScope, AXPWidgetTriggers, AXPExpressionEvaluatorScopeProvider, AXPExpressionEvaluatorScopeProviderContext } from '@acorex/platform/core';
-import { AXPWidgetTypesMap, AXPMetaDataDefinition, AXPWidgetNode } from '@acorex/platform/layout/widget-core';
+import { AXPValueTransformerFunctions, AXPOptionsData, AXPExpression, AXPFilterDefinition, AXPMetaData, AXPSystemActionType, AXPValidationRules, AXPGridLayoutOptions, AXPLogoConfig, AXPFileListItem, AXPDataSourceDefinitionProvider, AXPDataSourceDefinition, AXPNavigateActionCommand, AXPExecuteCommand, AXPApplicationUserReference, AXPEntityReference, AXPPlatformScopeKey, AXPPlatformScope, AXPWidgetTriggers, 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>;
@@ -102,8 +101,6 @@ interface AXPEntityPropertyCreateView extends AXPEntityPropertyView {
 }
 interface AXPEntitySectionView {
     id: string;
-    icon?: string;
-    description?: string;
     order?: number;
     collapsed?: boolean;
     layout?: AXPEntityPropertyLayoutConfig;
@@ -133,6 +130,10 @@ interface AXPEntityProperty {
             inline?: {
                 enabled?: boolean;
             };
+            preload?: {
+                enabled?: boolean;
+                required?: boolean;
+            };
         };
         sort?: {
             enabled?: boolean;
@@ -153,7 +154,8 @@ interface AXPEntityTableColumn {
         dir?: 'asc' | 'desc';
     };
     options?: {
-        visible?: boolean;
+        /** When string, evaluate against parent detail context (e.g. related list). */
+        visible?: boolean | string;
         width?: string;
         dataPath?: string;
         [name: string]: any;
@@ -208,12 +210,31 @@ interface AXPCommandActionDisplay extends Partial<AXPCommandActionLook> {
 }
 interface AXPEntityAction extends AXPCommandActionDisplay {
     scope: AXPEntityCommandScope;
+    /** Child actions for dropdown submenu */
+    items?: AXPEntityAction[];
 }
 interface AXPEntity {
     plugins?: {
         name: string;
         options?: AXPOptionsData;
     }[];
+    /**
+     * High-level rules: when expression evaluates true, apply actions to the given targets
+     * (property/section/action). Reduces repetition of the same condition across many properties.
+     * Evaluation context: form data, user, entity; precedence vs property-level visible/readonly
+     * must be defined where rules are applied.
+     */
+    rules?: Array<{
+        name: string;
+        expression: AXPExpression;
+        actions: Array<{
+            target: {
+                type: 'property' | 'section' | 'action';
+                name: string;
+            };
+            values: AXPOptionsData;
+        }>;
+    }>;
     module: string;
     name: string;
     icon?: string;
@@ -231,6 +252,7 @@ interface AXPEntity {
         };
     };
     relatedEntities?: AXPRelatedEntity[];
+    pages?: AXPEntityPage[];
     groups?: AXPEntityPropertyGroup[];
     properties: AXPEntityProperty[];
     columns?: AXPEntityTableColumn[];
@@ -284,13 +306,25 @@ interface AXPRelatedEntity {
     entity: string;
     title?: string;
     icon?: string;
-    columns?: 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[];
+    /** Exclude these properties from the related entity (for merge-detail) */
+    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;
     actions?: AXPEntityAction[];
     /**
@@ -313,6 +347,51 @@ interface AXPRelatedEntity {
         };
     };
 }
+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?: string;
+    /**
+     * Icon for the page (displayed in navigation)
+     */
+    icon?: string;
+    /**
+     * Description of the page
+     */
+    description?: string;
+    /**
+     * 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;
     title?: string;
@@ -348,12 +427,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 {
 }
@@ -367,6 +457,12 @@ interface AXPEntityMasterListView {
     description?: string;
     actions?: AXPEntityAction[];
     views: AXPQueryView[];
+    layouts?: {
+        table?: {
+            columns: AXPEntityTableColumn[];
+        };
+        card?: {};
+    };
 }
 interface AXPEntityDetailListView {
     title?: string;
@@ -394,6 +490,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;
@@ -530,7 +671,12 @@ declare function configPlatform(config?: Partial<AXPPlatformConfigs>): AXPPlatfo
 
 declare enum AXPCommonSettings {
     EnableOperationToasts = "Common:Setting:Notifications.EnableOperationToasts",
-    EntityFilterApplyMode = "Common:Setting:Entity.FilterApplyMode"
+    EntityFilterApplyMode = "Common:Setting:Entity.FilterApplyMode",
+    ShowCategoryColumnsByDefault = "Common:Setting:Entity.ShowCategoryColumnsByDefault",
+    ApplyLayoutOrdering = "Common:Setting:Entity.ApplyLayoutOrdering",
+    RedirectToDetailsAfterCreate = "Common:Setting:Entity.RedirectToDetailsAfterCreate",
+    ShowPageBadge = "Common:Setting:Entity.ShowPageBadge",
+    DebugMode = "PlatformDevTools:Setting:Developer.DebugMode"
 }
 
 declare const AXP_ROOT_CONFIG_TOKEN: InjectionToken<AXPRootConfigs>;
@@ -669,16 +815,16 @@ interface AXPFileStorageUpdateRequest {
 }
 interface AXPFileManyStorageInfo {
     /**
-    * The unique identifier for the stored file.
-    */
+     * The unique identifier for the stored file.
+     */
     id?: string;
     /**
      * The unique identifier for the stored file.
      */
     fileId: string;
     /**
-    * The unique identifier of referenced entity.
-    */
+     * The unique identifier of referenced entity.
+     */
     refId: string;
     /**
      * The type of the referenced entity.
@@ -692,6 +838,18 @@ interface AXPFileManyStorageInfo {
      * The name of the file.
      */
     name?: string;
+    /**
+     * The URL where the file can be accessed.
+     */
+    url?: string;
+    /**
+     * Optional title (e.g. for display in file list).
+     */
+    title?: string;
+    /**
+     * Optional description (e.g. for display in file list).
+     */
+    description?: string;
 }
 /**
  * Represents information about a file stored in the AXP file storage system.
@@ -850,6 +1008,175 @@ declare abstract class AXPFileStorageService {
     static ɵprov: i0.ɵɵInjectableDeclaration<AXPFileStorageService>;
 }
 
+/**
+ * Capabilities API provided to file action providers.
+ * These methods allow actions to interact with the file uploader widget.
+ */
+interface AXCFileUploaderCapabilities {
+    /**
+     * Get all current files in the uploader.
+     */
+    getFiles: () => AXPFileListItem[];
+    /**
+     * Replace all files in the uploader.
+     */
+    setFiles: (files: AXPFileListItem[]) => void;
+    /**
+     * Add new files to the uploader.
+     */
+    addFiles: (files: AXPFileListItem[]) => void;
+    /**
+     * Update files matching a predicate.
+     */
+    updateFile: (predicate: (f: AXPFileListItem) => boolean, updater: (f: AXPFileListItem) => AXPFileListItem) => void;
+    /**
+     * Remove a file from the uploader.
+     */
+    removeFile: (file: AXPFileListItem) => void;
+    /**
+     * Clear all files from the uploader.
+     */
+    clear: () => void;
+    /**
+     * Get a file by its ID.
+     */
+    getFileById: (id: string) => AXPFileListItem | undefined;
+    /**
+     * Update a file by its ID.
+     */
+    updateFileById: (id: string, next: Partial<AXPFileListItem>) => void;
+}
+/**
+ * A file uploader action that can be added by providers.
+ */
+interface AXCFileUploaderAction {
+    /**
+     * Unique identifier for the action/plugin.
+     */
+    plugin: string;
+    /**
+     * Whether this action is global (available even if plugin is not explicitly enabled).
+     */
+    global?: boolean;
+    /**
+     * Display text for the action (optional if textKey is provided).
+     */
+    text?: string;
+    /**
+     * Translation key for the action text (optional if text is provided).
+     */
+    textKey?: string;
+    /**
+     * Icon class for the action (e.g., 'fa-light fa-file-arrow-up').
+     */
+    icon?: string;
+    /**
+     * Action execution handler.
+     * Receives capabilities to interact with the file uploader.
+     * @param capabilities The capabilities API for file operations.
+     */
+    run: (capabilities: AXCFileUploaderCapabilities) => void | Promise<void>;
+}
+/**
+ * Payload passed to file action providers.
+ */
+interface AXCFileUploaderActionsPayload {
+    /**
+     * Enabled plugins configuration.
+     */
+    plugins: {
+        name: string;
+        options?: unknown;
+    }[];
+    /**
+     * List of plugin names to exclude.
+     */
+    excludePlugins: string[];
+    /**
+     * Capabilities API for interacting with the file uploader.
+     */
+    capabilities: AXCFileUploaderCapabilities;
+    /**
+     * Current list of actions (providers can add to this array).
+     */
+    actions: AXCFileUploaderAction[];
+    /**
+     * Widget options (optional, for accessing widget-specific settings).
+     */
+    options?: {
+        /**
+         * Whether multiple files are allowed.
+         */
+        multiple?: boolean;
+        /**
+         * Accepted file types (e.g., '.jpg,.png' or 'image/*').
+         */
+        accept?: string;
+    };
+}
+
+/**
+ * Type for file action provider token (supports both direct and async providers).
+ */
+type AXPFileActionProviderToken = AXPFileActionProvider | Promise<AXPFileActionProvider>;
+/**
+ * File action provider interface.
+ * Providers can add actions to the file uploader widget.
+ */
+interface AXPFileActionProvider {
+    /**
+     * Unique key identifying this provider.
+     * Should match the webhook key for backward compatibility: 'file-uploader.actions'
+     */
+    key: string;
+    /**
+     * Execute the provider to add actions.
+     * @param payload The payload containing capabilities and current actions.
+     * @returns The modified payload with new actions added.
+     */
+    execute(payload: AXCFileUploaderActionsPayload): Promise<AXCFileUploaderActionsPayload> | AXCFileUploaderActionsPayload;
+    /**
+     * Priority for execution order (lower numbers execute first).
+     * Defaults to 0 if not specified.
+     */
+    priority?: number;
+}
+/**
+ * Multi-provider injection token for file action providers.
+ * Modules can provide multiple implementations using this token.
+ */
+declare const AXP_FILE_ACTION_PROVIDER: InjectionToken<AXPFileActionProviderToken[]>;
+
+/**
+ * Service for managing file uploader actions.
+ * Aggregates actions from multiple providers and filters them based on plugin configuration.
+ * Wraps the hook system for backward compatibility.
+ */
+declare class AXPFileActionsService {
+    private readonly actionProviders;
+    private readonly hookService;
+    private readonly injector;
+    /**
+     * Get all actions from providers, filtered based on plugin configuration.
+     * Wraps the hook system for backward compatibility.
+     * @param payload Initial payload with capabilities and plugin configuration.
+     * @returns Filtered list of actions.
+     */
+    getActions(payload: AXCFileUploaderActionsPayload): Promise<AXCFileUploaderAction[]>;
+    /**
+     * Resolve all providers (handle both direct providers and Promise<provider>).
+     */
+    private resolveProviders;
+    /**
+     * Filter actions based on enabled plugins and exclude list.
+     */
+    private filterActions;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AXPFileActionsService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<AXPFileActionsService>;
+}
+
+declare const UploadFromComputerActionProvider: AXPFileActionProvider;
+
 interface AXPFileType {
     /**
      * The unique identifier for the file type.
@@ -929,16 +1256,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;
@@ -946,6 +1280,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;
@@ -973,6 +1319,12 @@ interface AXPMenuFinderResult {
     remove(): void;
     update(updatedItem: Partial<AXPMenuItem>): void;
     addItems(items: AXPMenuItem[]): void;
+    /**
+     * Moves the item matched by the current `find` target to another place in the tree.
+     * @param destination Name of the target menu item (group or item).
+     * @param position `inside` — child of `destination` (default). `before` / `after` — sibling of `destination` in its parent's list.
+     */
+    moveTo(destination: string, position?: AXPMenuInsertion): void;
 }
 interface AXPMenuProviderContext {
     addItems(items: AXPMenuItem[]): void;
@@ -985,13 +1337,13 @@ interface AXPMenuProvider {
 declare const AXP_MENU_PROVIDER: InjectionToken<AXPMenuProvider[]>;
 declare class AXPMenuProviderService {
     private providers;
-    private providerRegistry;
     private middlewareRegistry;
     private cache;
     private pendingInserts;
     private pendingRemovals;
     private pendingUpdates;
     private pendingAdditions;
+    private pendingMoves;
     /**
      * Observable for menu reload events
      * Emits when menu cache is cleared and consumers should reload
@@ -1026,6 +1378,8 @@ declare class AXPMenuProviderService {
      * Find menu item by name in the items tree (recursive search)
      */
     private findItemByName;
+    private applyPendingMove;
+    private itemIsInSubtreeOf;
     /**
      * Merge new item properties into existing item, handling children merge
      */
@@ -1405,7 +1759,6 @@ interface AXPSearchDefinitionProvider {
 declare const AXP_SEARCH_DEFINITION_PROVIDER: InjectionToken<AXPSearchDefinitionProvider[]>;
 declare class AXPSearchDefinitionProviderService {
     private providers;
-    private providerRegistry;
     private cache;
     private load;
     getListAsync(): Promise<AXPSearchDefinition[]>;
@@ -1427,14 +1780,41 @@ declare abstract class AXPSearchCommandProvider {
 declare const AXP_SEARCH_PROVIDER: InjectionToken<AXPSearchProvider[]>;
 declare class AXPSearchService {
     private providers;
-    private providerRegistry;
     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>;
 }
@@ -1507,6 +1887,61 @@ 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;
+
 interface AXPSettingValueProvider {
     get scope(): AXPPlatformScope;
     load(): Promise<AXPSettingValue[]>;
@@ -1619,7 +2054,6 @@ interface AXPSettingDefinitionProvider {
 declare const AXP_SETTING_DEFINITION_PROVIDER: InjectionToken<AXPSettingDefinitionProvider[]>;
 declare class AXPSettingDefinitionProviderService {
     private providers;
-    private providerRegistry;
     private cache;
     private load;
     reload(): Promise<void>;
@@ -1680,9 +2114,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",
@@ -1704,7 +2146,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"
 }
 
 /**
@@ -1851,7 +2295,7 @@ declare const AXP_STATUS_PROVIDERS: InjectionToken<AXPStatusProvider[]>;
  * }
  *
  * // Later, get the status:
- * const status = statusService.getStatus('task-management.status');
+ * const status = await statusService.getStatus('task-management.status');
  * if (status) {
  *   console.log('Statuses:', status.statuses);
  *   console.log('Transitions:', status.transitions);
@@ -1862,24 +2306,31 @@ declare class AXPStatusDefinitionProviderService {
     private providers;
     private commandService;
     private statusMap;
-    constructor();
+    private initializationPromise;
+    private isInitialized;
+    /**
+     * Initialize providers (resolve promises if needed)
+     * Called lazily on first access
+     */
+    private initialize;
+    private _doInitialize;
     /**
      * Get a status provider by key
-     * Direct access from Map (no lazy load, no cache)
+     * Ensures initialization is complete before accessing the status map.
      *
      * @param key - Status key (e.g., 'task-management.status')
-     * @returns Status provider with all statuses and transitions, or undefined if not found
+     * @returns Promise that resolves to status provider with all statuses and transitions, or undefined if not found
      *
      * @example
      * ```typescript
-     * const status = statusService.getStatus('task-management.status');
+     * const status = await statusService.getStatus('task-management.status');
      * if (status) {
      *   console.log('Statuses:', status.statuses);
      *   console.log('Transitions:', status.transitions);
      * }
      * ```
      */
-    getStatus(key: string): AXPStatusProvider | undefined;
+    getStatus(key: string): Promise<AXPStatusProvider | undefined>;
     /**
      * Execute a status transition workflow action
      * Uses transition.command if provided, otherwise defaults to Entity:UpdateStatus
@@ -2308,6 +2759,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;
@@ -2461,5 +2922,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, 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_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, configPlatform, createAllQueryView, createMenuContext, createMenuMiddleware, createQueryView, getEntityInfo, getStatusInfo, getSystemStatus, provideDynamicHomePage, provideMenuMiddleware, resolveStatusLook, systemStatusToDefinition };
-export type { AXEntityPropertyWidget, AXPAggregate, AXPAppVersion, AXPAppVersionProvider, AXPApplication, AXPCategoryEntity, 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, 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, configPlatform, createAllQueryView, createEntityCommandOptions, createEntitySearchCommand, createMenuContext, createMenuMiddleware, createQueryView, getEntityInfo, getStatusInfo, getSystemStatus, provideDynamicHomePage, provideMenuMiddleware, resolveStatusLook, shouldApplyDefaultMultiLanguageToEntityProperty, shouldApplyDefaultMultiLanguageToWidgetNode, shouldApplyDefaultMultiLanguageToWidgetProperty, systemStatusToDefinition, withDefaultMultiLanguageOnWidgetNodeTree, withDefaultMultiLanguageOnWidgetProperty };
+export type { AXCFileUploaderAction, AXCFileUploaderActionsPayload, AXCFileUploaderCapabilities, AXEntityPropertyWidget, AXPAggregate, AXPAppVersion, AXPAppVersionProvider, AXPApplication, AXPCategoryEntity, 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, AXPSettingDefaultValuesProvider, AXPSettingDefinition, AXPSettingDefinitionGroup, AXPSettingDefinitionProvider, AXPSettingDefinitionSection, AXPSettingValue, AXPSettingValueProvider, AXPSettingsServiceInterface, AXPStatusDefinition, AXPStatusTransition, AXPTimeZone, AXPTokenDefinition, AXPTokenDefinitionProvider, AXPTokenDefinitionProviderToken, AXPUnLockRequest, AXPVersionChange, AXPVersionEntry, AXPVersionStream, CanonicalChange, CanonicalChangeOp, VersionedFileInfo };