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

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

@@ -1,16 +1,17 @@
 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, 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';
 import * as i6 from '@angular/router';
 import { Route, Routes } from '@angular/router';
 import * as i1 from '@acorex/platform/workflow';
 import { AXPWorkflowAction, AXPWorkflowContext, AXPWorkflow } from '@acorex/platform/workflow';
-import * as i3 from '@acorex/core/date-time';
 import * as i4 from '@acorex/components/toast';
 import * as rxjs from 'rxjs';
 import { Subject } from 'rxjs';
@@ -18,6 +19,100 @@ import * as _ngrx_signals from '@ngrx/signals';
 import { AXTranslationService } from '@acorex/core/translation';
 import { AXLocaleProfile } from '@acorex/core/locale';
 
+/** JSON data primitive for the specialist final deliverable. */
+type AXPAgentOutputKind = 'string' | 'object' | 'array';
+/** When `kind` is `object`, controls how the parsed value maps into chat transcript segments. */
+type AXPOutputTranscriptSegmentId = 'text' | 'node' | 'followUp' | 'file';
+/**
+ * Minimal JSON-Schema-like object for native provider hints and local validation.
+ */
+interface AXPJsonSchemaLike {
+    type?: 'object' | 'array' | 'string' | 'number' | 'integer' | 'boolean' | 'null';
+    properties?: Record<string, AXPJsonSchemaLike>;
+    items?: AXPJsonSchemaLike | AXPJsonSchemaLike[];
+    required?: string[];
+    enum?: unknown[];
+    additionalProperties?: boolean | AXPJsonSchemaLike;
+    description?: string;
+    [key: string]: unknown;
+}
+/** Provider-native structured output hint (OpenAI `response_format`, Gemini `responseMimeType`). */
+type AXPAgentResponseFormat = {
+    type: 'text';
+} | {
+    type: 'json_object';
+} | {
+    type: 'json_schema';
+    schema: AXPJsonSchemaLike;
+    name?: string;
+    strict?: boolean;
+};
+/**
+ * Catalog row contract for specialist final output (separate from domain `systemPrompt`).
+ * Field paths align with agent/assist entity `outputContract` JSON.
+ */
+interface AXPAgentOutputContract {
+    kind: AXPAgentOutputKind;
+    /**
+     * When `kind` is `object`: `text` = generic JSON object as text; `node` = inner widget node in chat;
+     * `followUp` = `{"type":"followUp","content":[...]}` envelope.
+     */
+    transcriptSegment?: AXPOutputTranscriptSegmentId;
+    instruction?: string;
+    schemaSummary?: string;
+    schema?: AXPJsonSchemaLike;
+    schemaName?: string;
+    schemaStrict?: boolean;
+    validationCommandName?: string;
+    structuredRetries?: number;
+    providerResponseFormat?: AXPAgentResponseFormat;
+}
+/** Default structured retry count when `structuredRetries` is omitted on structured kinds. */
+declare const AXP_AGENT_OUTPUT_CONTRACT_DEFAULT_STRUCTURED_RETRIES = 2;
+/**
+ * Registered preset for an output-contract transcript segment.
+ * Modules register via {@link AXP_OUTPUT_CONTRACT_TRANSCRIPT_SEGMENT_PROVIDER}.
+ */
+interface AXPOutputContractTranscriptSegmentDefinition {
+    /** Segment id (`text`, `node`, `followUp`). */
+    name: AXPOutputTranscriptSegmentId;
+    /** i18n key or display title for admin UI selects. */
+    title: string;
+    description?: string;
+    /** Contract kinds this segment applies to (defaults to `object` only). */
+    applicableKinds?: AXPAgentOutputKind[];
+    /** Default `outputContract` field values when this segment is chosen. */
+    contract: AXPAgentOutputContract;
+}
+
+type AXPOutputContractTranscriptSegmentProviderToken = AXPOutputContractTranscriptSegmentProvider | Promise<AXPOutputContractTranscriptSegmentProvider>;
+/**
+ * Registers one or more transcript-segment presets for agent/assist `outputContract`.
+ * Use with `multi: true` in module providers.
+ */
+interface AXPOutputContractTranscriptSegmentProvider {
+    provide(): AXPOutputContractTranscriptSegmentDefinition[] | Promise<AXPOutputContractTranscriptSegmentDefinition[]>;
+}
+declare const AXP_OUTPUT_CONTRACT_TRANSCRIPT_SEGMENT_PROVIDER: InjectionToken<AXPOutputContractTranscriptSegmentProviderToken[]>;
+
+declare class AXPOutputContractTranscriptSegmentService {
+    private readonly segmentProviders;
+    private definitionsByName;
+    private loadPromise;
+    /** All registered transcript segment definitions (deduped by `name`). */
+    getAll(): Promise<AXPOutputContractTranscriptSegmentDefinition[]>;
+    /** Lookup by segment id (`text`, `node`, `followUp`). */
+    get(name: AXPOutputTranscriptSegmentId): Promise<AXPOutputContractTranscriptSegmentDefinition | undefined>;
+    /** Default `outputContract` for a segment, or `undefined` when not registered. */
+    getContractPreset(name: AXPOutputTranscriptSegmentId): Promise<AXPAgentOutputContract | undefined>;
+    /** Clears the in-memory registry (e.g. after hot reload in dev). */
+    clearCache(): void;
+    private ensureLoaded;
+    private loadDefinitions;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AXPOutputContractTranscriptSegmentService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<AXPOutputContractTranscriptSegmentService>;
+}
+
 interface AXPAppVersion {
     version: string;
     build: number;
@@ -38,7 +133,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 +175,7 @@ interface AXPEntityPropertyLayoutConfig extends AXPGridLayoutOptions {
         visible?: boolean;
     };
     order?: number;
+    visible?: boolean | AXPExpression;
 }
 interface AXPEntityPropertyGroup {
     id: string;
@@ -102,8 +197,6 @@ interface AXPEntityPropertyCreateView extends AXPEntityPropertyView {
 }
 interface AXPEntitySectionView {
     id: string;
-    icon?: string;
-    description?: string;
     order?: number;
     collapsed?: boolean;
     layout?: AXPEntityPropertyLayoutConfig;
@@ -133,6 +226,10 @@ interface AXPEntityProperty {
             inline?: {
                 enabled?: boolean;
             };
+            preload?: {
+                enabled?: boolean;
+                required?: boolean;
+            };
         };
         sort?: {
             enabled?: boolean;
@@ -140,25 +237,73 @@ interface AXPEntityProperty {
     };
     validations?: AXPValidationRules;
 }
-interface AXPEntityTableColumn {
+/** Logical alignment for table column header/cell (respects RTL). */
+type AXPColumnContentAlign = 'start' | 'center' | 'end';
+/**
+ * Column alignment: shorthand applies to both header and cell;
+ * object form sets each side independently (omitted keys default to start).
+ */
+type AXPColumnAlign = AXPColumnContentAlign | {
+    header?: AXPColumnContentAlign;
+    cell?: AXPColumnContentAlign;
+};
+/** 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>;
     };
-    sort?: {
-        enabled?: boolean;
-        dir?: 'asc' | 'desc';
-    };
     options?: {
-        visible?: boolean;
-        width?: string;
+        /** 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;
+        /** Header/cell alignment (shorthand or per-side). */
+        align?: AXPColumnAlign;
+    };
+}
 interface AXPEntityCommand {
     execute: string | Function;
     permissions?: string[];
@@ -198,7 +343,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;
@@ -208,12 +353,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 +395,7 @@ interface AXPEntity {
         };
     };
     relatedEntities?: AXPRelatedEntity[];
+    pages?: AXPEntityPage[];
     groups?: AXPEntityPropertyGroup[];
     properties: AXPEntityProperty[];
     columns?: AXPEntityTableColumn[];
@@ -284,15 +449,30 @@ interface AXPRelatedEntity {
     entity: string;
     title?: string;
     icon?: string;
-    columns?: string[];
+    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[];
-    hidden?: boolean | string;
+    customFilterDefinitions?: Partial<AXPFilterDefinition>[];
+    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:
@@ -311,8 +491,64 @@ 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[];
+    /**
+     * Controls inclusion on the host entity master **create** / **update** form wizard.
+     * Omitted flags behave as **false** (opt-in with `true`), same as `tab-list` / `page-list` related entities.
+     */
+    appearOn?: {
+        /** Include as a wizard step on host create form. */
+        create?: boolean;
+        /** Include as a wizard step on host update form. */
+        update?: boolean;
+    };
+    options?: Record<string, any>;
+}
 interface AXPCategoryEntity {
     entity: string;
     title?: string;
@@ -329,18 +565,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 {
@@ -348,12 +584,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,7 +614,35 @@ interface AXPEntityMasterListView {
     description?: string;
     actions?: AXPEntityAction[];
     views: AXPQueryView[];
+    layouts?: {
+        table?: {
+            enabled?: boolean;
+            columns: AXPEntityTableColumn[];
+        };
+        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;
@@ -394,6 +669,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;
@@ -420,6 +740,27 @@ declare const BOOLEAN_OPERATORS: AXPFilterOperator[];
 declare const DATE_OPERATORS: AXPFilterOperator[];
 declare const ALL_DEFAULT_OPERATORS: AXPFilterOperator[];
 
+type AXPDateTimeFilterPresetKind = 'computed' | 'manual';
+interface AXPDateTimeFilterPreset {
+    id: string;
+    title: string;
+    kind: AXPDateTimeFilterPresetKind;
+    operationType?: string;
+}
+declare const DEFAULT_DATE_FILTER_PRESETS: AXPDateTimeFilterPreset[];
+interface AXPDateTimeFilterValue {
+    operation?: {
+        type: string;
+    };
+    value?: string | {
+        from?: string;
+        to?: string;
+    };
+}
+declare function resolveDateFilterPresets(customPresets?: AXPDateTimeFilterPreset[], presetIds?: string[]): AXPDateTimeFilterPreset[];
+declare function applyDateFilterPreset(presetId: string, calendarService: AXCalendarService): AXPDateTimeFilterValue | undefined;
+declare function findManualPresetIdByOperation(operationType: string | undefined, presets: AXPDateTimeFilterPreset[]): string | undefined;
+
 interface AXPHomePageDefinition {
     key: string;
     title: string;
@@ -530,7 +871,14 @@ 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",
+    ShowRowIndexColumn = "Common:Setting:Entity.ShowRowIndexColumn",
+    EntityListPersistenceMode = "Common:Setting:Entity.ListPersistenceMode"
 }
 
 declare const AXP_ROOT_CONFIG_TOKEN: InjectionToken<AXPRootConfigs>;
@@ -669,16 +1017,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 +1040,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 +1210,180 @@ 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.
+ */
+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 +1463,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 +1487,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 +1526,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;
@@ -991,6 +1550,7 @@ declare class AXPMenuProviderService {
     private pendingRemovals;
     private pendingUpdates;
     private pendingAdditions;
+    private pendingMoves;
     /**
      * Observable for menu reload events
      * Emits when menu cache is cleared and consumers should reload
@@ -1025,6 +1585,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
      */
@@ -1328,8 +1890,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;
@@ -1345,8 +1907,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;
@@ -1418,6 +1980,7 @@ interface AXPSearchProvider {
     search(text: string): Promise<AXPSearchResult[]>;
 }
 declare abstract class AXPSearchCommandProvider {
+    private readonly translationService;
     abstract commands: AXPSearchResult[];
     search(text: string): Promise<AXPSearchResult[]>;
 }
@@ -1427,11 +1990,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>;
 }
@@ -1504,6 +2095,105 @@ 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, pageTitle?: string, priority?: number): AXPSettingDefinitionGroupBuilder;
+    group(name: string): AXPSettingDefinitionGroupBuilder | null;
+    getGroups(): AXPSettingDefinitionGroup[];
+    hasGroup(name: string): boolean;
+    getGroup(name: string): AXPSettingDefinitionGroup | undefined;
+}
+declare class AXPSettingDefinitionGroupBuilder {
+    private context;
+    private group;
+    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, pageTitle?: string, priority?: number): AXPSettingDefinitionGroupBuilder;
+    endGroup(): AXPSettingDefinitionProviderContext;
+}
+declare class AXPSettingDefinitionSectionBuilder {
+    private groupBuilder;
+    private section;
+    constructor(groupBuilder: AXPSettingDefinitionGroupBuilder, section: AXPSettingDefinitionSection);
+    addSetting(setting: {
+        key: string;
+        title: string;
+        scope: AXPPlatformScopeKey;
+        widget: {
+            type: AXPWidgetTypesMap[keyof AXPWidgetTypesMap] | string;
+            options?: AXPOptionsData;
+            triggers?: AXPWidgetTriggers;
+            layout?: AXPSettingLayoutOptions;
+        };
+        description?: string;
+        searchTagKeys?: string[];
+        isRequired?: boolean;
+        isInherited?: boolean;
+        isEncrypted?: boolean;
+        defaultValue?: unknown;
+        valueTransforms?: AXPValueTransformerFunctions;
+        validationRules?: AXPValidationRules;
+    }): this;
+    endSection(): AXPSettingDefinitionGroupBuilder;
+}
+
 interface AXPSettingValueProvider {
     get scope(): AXPPlatformScope;
     load(): Promise<AXPSettingValue[]>;
@@ -1517,6 +2207,11 @@ interface AXPSettingValueProvider {
 interface AXPSettingDefaultValuesProvider {
     /** Merge order; lower numbers are applied first. Default is 0. */
     priority?: number;
+    /**
+     * When set, missing values from this provider are persisted at this scope instead of each
+     * setting's definition scope. Use for app-wide demo or deployment defaults (e.g. platform).
+     */
+    scope?: AXPPlatformScope;
     /** Returns a flat map of setting key to default value. */
     provide(): Promise<Record<string, unknown>>;
 }
@@ -1530,12 +2225,19 @@ interface AXPSettingChangedEvent {
     values: Record<string, any>;
     entries: AXPSettingValue[];
 }
+/** Layout options for a single setting row on the settings page. */
+interface AXPSettingLayoutOptions extends AXPGridLayoutOptions {
+    /** When true, stack the label above a full-width control. */
+    stacked?: boolean;
+}
 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;
+    layout?: AXPSettingLayoutOptions;
     scope: AXPPlatformScopeKey;
     isRequired?: boolean;
     isInherited?: boolean;
@@ -1545,9 +2247,14 @@ 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;
+    /** Sidebar order; lower numbers appear first. Defaults to 1000 when omitted. */
+    priority?: number;
     groups: AXPSettingDefinitionGroup[];
     sections: AXPSettingDefinitionSection[];
 }
@@ -1567,49 +2274,6 @@ interface AXPGroupSearchResult {
     groups: AXPSettingDefinitionGroup[] | null;
 }
 
-declare class AXPSettingDefinitionProviderContext {
-    private rootGroups;
-    private groupMap;
-    addGroup(name: string, title: string, description?: string, icon?: string): AXPSettingDefinitionGroupBuilder;
-    group(name: string): AXPSettingDefinitionGroupBuilder | null;
-    getGroups(): AXPSettingDefinitionGroup[];
-    hasGroup(name: string): boolean;
-    getGroup(name: string): AXPSettingDefinitionGroup | undefined;
-}
-declare class AXPSettingDefinitionGroupBuilder {
-    private context;
-    private group;
-    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;
-    endGroup(): AXPSettingDefinitionProviderContext;
-}
-declare class AXPSettingDefinitionSectionBuilder {
-    private groupBuilder;
-    private section;
-    constructor(groupBuilder: AXPSettingDefinitionGroupBuilder, section: AXPSettingDefinitionSection);
-    addSetting(setting: {
-        key: string;
-        title: string;
-        scope: AXPPlatformScopeKey;
-        widget: {
-            type: AXPWidgetTypesMap[keyof AXPWidgetTypesMap] | string;
-            options?: AXPOptionsData;
-            triggers?: AXPWidgetTriggers;
-            layout?: AXPGridLayoutOptions;
-        };
-        description?: string;
-        isRequired?: boolean;
-        isInherited?: boolean;
-        isEncrypted?: boolean;
-        defaultValue?: unknown;
-        valueTransforms?: AXPValueTransformerFunctions;
-        validationRules?: AXPValidationRules;
-    }): this;
-    endSection(): AXPSettingDefinitionGroupBuilder;
-}
-
 interface AXPSettingDefinitionProvider {
     provide(context: AXPSettingDefinitionProviderContext): Promise<void>;
 }
@@ -1622,15 +2286,22 @@ declare class AXPSettingDefinitionProviderService {
     getListAsync(scope: AXPPlatformScopeKey): Promise<AXPSettingDefinitionGroup[]>;
     getList(scope: AXPPlatformScopeKey): AXPSettingDefinitionGroup[];
     defaultValues(): Promise<Record<string, unknown>>;
+    settingScopeByKey(): Promise<Record<string, AXPPlatformScope>>;
     findGroup(scope: AXPPlatformScopeKey, groupName: string): AXPGroupSearchResult;
     private searchRecursive;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXPSettingDefinitionProviderService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<AXPSettingDefinitionProviderService>;
 }
 declare const AXP_SETTING_DEFAULT_VALUES_PROVIDERS: InjectionToken<AXPSettingDefaultValuesProvider[]>;
+interface AXPSettingMergedDefaults {
+    defaults: Record<string, unknown>;
+    /** Per-key scope override for seeding (from providers that set `scope`). */
+    seedScopeByKey: Record<string, AXPPlatformScope>;
+}
 declare class AXPSettingDefaultValuesAggregatorService {
     private readonly definitionService;
     private readonly providers;
+    getMerged(): Promise<AXPSettingMergedDefaults>;
     getDefaults(): Promise<Record<string, unknown>>;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXPSettingDefaultValuesAggregatorService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<AXPSettingDefaultValuesAggregatorService>;
@@ -1638,6 +2309,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>;
@@ -1655,10 +2345,20 @@ 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;
+    private seedMissingDefaults;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXPSettingsService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<AXPSettingsService>;
 }
@@ -1676,9 +2376,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",
@@ -1700,7 +2408,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"
 }
 
 /**
@@ -1847,7 +2557,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);
@@ -1860,7 +2570,6 @@ declare class AXPStatusDefinitionProviderService {
     private statusMap;
     private initializationPromise;
     private isInitialized;
-    constructor();
     /**
      * Initialize providers (resolve promises if needed)
      * Called lazily on first access
@@ -1869,22 +2578,21 @@ declare class AXPStatusDefinitionProviderService {
     private _doInitialize;
     /**
      * Get a status provider by key
-     * Direct synchronous access from Map. Providers are initialized in the constructor,
-     * including lazy-loaded providers (promises) which are resolved during initialization.
+     * 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
@@ -1910,6 +2618,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>;
 }
@@ -1929,6 +2641,7 @@ declare enum AXPSystemStatusType {
     Cancelled = "cancelled",
     Draft = "draft",
     PendingReview = "pending-review",
+    WaitingSignOff = "waiting-sign-off",
     Approved = "approved",
     Published = "published",
     Archived = "archived",
@@ -2048,6 +2761,16 @@ declare const AXPSystemStatuses: Readonly<{
         readonly isInitial: false;
         readonly isFinal: false;
     };
+    readonly WaitingSignOff: {
+        readonly name: AXPSystemStatusType.WaitingSignOff;
+        readonly title: string;
+        readonly icon: "fa-light fa-clock";
+        readonly color: "warning";
+        readonly description: string;
+        readonly order: 3;
+        readonly isInitial: false;
+        readonly isFinal: false;
+    };
     readonly Approved: {
         readonly name: AXPSystemStatusType.Approved;
         readonly title: string;
@@ -2313,6 +3036,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;
@@ -2466,5 +3199,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, 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 };