@acorex/platform 21.0.0-next.41 → 21.0.0-next.43

package/fesm2022/{acorex-platform-common-common-settings.provider-G9XcXXOG.mjs → acorex-platform-common-common-settings.provider-lWz_f-Ia.mjs}

@@ -1,25 +1,23 @@
-import { AXTranslationService } from '@acorex/core/translation';
-import { AXPPlatformScope } from '@acorex/platform/core';
-import { AXPWidgetsCatalog } from '@acorex/platform/layout/widget-core';
 import * as i0 from '@angular/core';
 import { Injectable } from '@angular/core';
+import { AXPPlatformScope } from '@acorex/platform/core';
+import { AXPWidgetsCatalog } from '@acorex/platform/layout/widget-core';
 import { AXPCommonSettings } from './acorex-platform-common.mjs';
 
+const I18N = '@general:settings';
 class AXPCommonSettingProvider {
-    constructor(injector) {
-        this.injector = injector;
-        this.translateService = this.injector.get(AXTranslationService);
+    constructor(_injector) {
+        this._injector = _injector;
     }
     async provide(context) {
-        const trans = async (key) => await this.translateService.translateAsync(`@general:settings.${key}`);
         // Define the 'General Settings' group
         context
             .group('general')
-            ?.addSection('notifications', await trans('general.notifications.title'), await trans('general.notifications.description'))
+            ?.addSection('notifications', `${I18N}.general.notifications.title`, `${I18N}.general.notifications.description`)
             // Add the 'Enable Operation Toasts' setting
             .addSetting({
             key: AXPCommonSettings.EnableOperationToasts,
-            title: await trans('general.notifications.enable-operation-toasts.title'),
+            title: `${I18N}.general.notifications.enable-operation-toasts.title`,
             scope: AXPPlatformScope.User,
             isInherited: true,
             defaultValue: true,
@@ -29,15 +27,15 @@ class AXPCommonSettingProvider {
                     label: null,
                 },
             },
-            description: await trans('general.notifications.enable-operation-toasts.description'),
+            description: `${I18N}.general.notifications.enable-operation-toasts.description`,
         })
             // End the 'Notifications' section
             .endSection()
-            .addSection('entity', await trans('general.entity.title'), await trans('general.entity.description'))
+            .addSection('entity', `${I18N}.general.entity.title`, `${I18N}.general.entity.description`)
             // Add the 'Enable Operation Toasts' setting
             .addSetting({
             key: AXPCommonSettings.EntityFilterApplyMode,
-            title: await trans('general.entity.filter-apply-mode.title'),
+            title: `${I18N}.general.entity.filter-apply-mode.title`,
             scope: AXPPlatformScope.User,
             isInherited: true,
             defaultValue: 'auto',
@@ -48,16 +46,16 @@ class AXPCommonSettingProvider {
                     valueField: 'value',
                     textField: 'text',
                     dataSource: [
-                        { value: 'auto', text: await trans('general.entity.filter-apply-mode.options.auto') },
-                        { value: 'manual', text: await trans('general.entity.filter-apply-mode.options.manual') },
+                        { value: 'auto', text: `${I18N}.general.entity.filter-apply-mode.options.auto` },
+                        { value: 'manual', text: `${I18N}.general.entity.filter-apply-mode.options.manual` },
                     ],
                 },
             },
-            description: await trans('general.entity.filter-apply-mode.description'),
+            description: `${I18N}.general.entity.filter-apply-mode.description`,
         })
             .addSetting({
             key: AXPCommonSettings.ShowCategoryColumnsByDefault,
-            title: await trans('general.entity.show-category-columns-by-default.title'),
+            title: `${I18N}.general.entity.show-category-columns-by-default.title`,
             scope: AXPPlatformScope.User,
             isInherited: true,
             defaultValue: false,
@@ -67,11 +65,11 @@ class AXPCommonSettingProvider {
                     label: null,
                 },
             },
-            description: await trans('general.entity.show-category-columns-by-default.description'),
+            description: `${I18N}.general.entity.show-category-columns-by-default.description`,
         })
             .addSetting({
             key: AXPCommonSettings.ApplyLayoutOrdering,
-            title: await trans('general.entity.apply-layout-ordering.title'),
+            title: `${I18N}.general.entity.apply-layout-ordering.title`,
             scope: AXPPlatformScope.User,
             isInherited: true,
             defaultValue: true,
@@ -81,11 +79,11 @@ class AXPCommonSettingProvider {
                     label: null,
                 },
             },
-            description: await trans('general.entity.apply-layout-ordering.description'),
+            description: `${I18N}.general.entity.apply-layout-ordering.description`,
         })
             .addSetting({
             key: AXPCommonSettings.RedirectToDetailsAfterCreate,
-            title: await trans('general.entity.redirect-to-details-after-create.title'),
+            title: `${I18N}.general.entity.redirect-to-details-after-create.title`,
             scope: AXPPlatformScope.User,
             isInherited: true,
             defaultValue: true,
@@ -95,11 +93,11 @@ class AXPCommonSettingProvider {
                     label: null,
                 },
             },
-            description: await trans('general.entity.redirect-to-details-after-create.description'),
+            description: `${I18N}.general.entity.redirect-to-details-after-create.description`,
         })
             .addSetting({
             key: AXPCommonSettings.ShowPageBadge,
-            title: await trans('general.entity.show-page-badge.title'),
+            title: `${I18N}.general.entity.show-page-badge.title`,
             scope: AXPPlatformScope.User,
             isInherited: true,
             defaultValue: true,
@@ -109,7 +107,7 @@ class AXPCommonSettingProvider {
                     label: null,
                 },
             },
-            description: await trans('general.entity.show-page-badge.description'),
+            description: `${I18N}.general.entity.show-page-badge.description`,
         })
             // End the 'Entity Settings' section
             .endSection()
@@ -124,4 +122,4 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImpor
         }], ctorParameters: () => [{ type: i0.Injector }] });
 
 export { AXPCommonSettingProvider };
-//# sourceMappingURL=acorex-platform-common-common-settings.provider-G9XcXXOG.mjs.map
+//# sourceMappingURL=acorex-platform-common-common-settings.provider-lWz_f-Ia.mjs.map

package/fesm2022/acorex-platform-common-common-settings.provider-lWz_f-Ia.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"acorex-platform-common-common-settings.provider-lWz_f-Ia.mjs","sources":["../../../../libs/platform/common/src/lib/configs/common-settings.provider.ts"],"sourcesContent":["import { Injectable, Injector } from '@angular/core';\nimport { AXPPlatformScope } from '@acorex/platform/core';\nimport { AXPWidgetsCatalog } from '@acorex/platform/layout/widget-core';\nimport { AXPSettingDefinitionProvider, AXPSettingDefinitionProviderContext } from '../settings';\nimport { AXPCommonSettings } from './common-settings.key';\n\nconst I18N = '@general:settings';\n\n@Injectable()\nexport class AXPCommonSettingProvider implements AXPSettingDefinitionProvider {\n  constructor(private _injector: Injector) {}\n\n  async provide(context: AXPSettingDefinitionProviderContext): Promise<void> {\n    // Define the 'General Settings' group\n    context\n      .group('general')\n      ?.addSection(\n        'notifications',\n        `${I18N}.general.notifications.title`,\n        `${I18N}.general.notifications.description`,\n      )\n      // Add the 'Enable Operation Toasts' setting\n      .addSetting({\n        key: AXPCommonSettings.EnableOperationToasts,\n        title: `${I18N}.general.notifications.enable-operation-toasts.title`,\n        scope: AXPPlatformScope.User,\n        isInherited: true,\n        defaultValue: true,\n        widget: {\n          type: AXPWidgetsCatalog.toggle,\n          options: {\n            label: null,\n          },\n        },\n\n        description: `${I18N}.general.notifications.enable-operation-toasts.description`,\n      })\n\n      // End the 'Notifications' section\n      .endSection()\n      .addSection('entity', `${I18N}.general.entity.title`, `${I18N}.general.entity.description`)\n      // Add the 'Enable Operation Toasts' setting\n      .addSetting({\n        key: AXPCommonSettings.EntityFilterApplyMode,\n        title: `${I18N}.general.entity.filter-apply-mode.title`,\n        scope: AXPPlatformScope.User,\n        isInherited: true,\n        defaultValue: 'auto',\n        widget: {\n          type: AXPWidgetsCatalog.select,\n          options: {\n            label: null,\n            valueField: 'value',\n            textField: 'text',\n            dataSource: [\n              { value: 'auto', text: `${I18N}.general.entity.filter-apply-mode.options.auto` },\n              { value: 'manual', text: `${I18N}.general.entity.filter-apply-mode.options.manual` },\n            ],\n          },\n        },\n\n        description: `${I18N}.general.entity.filter-apply-mode.description`,\n      })\n      .addSetting({\n        key: AXPCommonSettings.ShowCategoryColumnsByDefault,\n        title: `${I18N}.general.entity.show-category-columns-by-default.title`,\n        scope: AXPPlatformScope.User,\n        isInherited: true,\n        defaultValue: false,\n        widget: {\n          type: AXPWidgetsCatalog.toggle,\n          options: {\n            label: null,\n          },\n        },\n        description: `${I18N}.general.entity.show-category-columns-by-default.description`,\n      })\n      .addSetting({\n        key: AXPCommonSettings.ApplyLayoutOrdering,\n        title: `${I18N}.general.entity.apply-layout-ordering.title`,\n        scope: AXPPlatformScope.User,\n        isInherited: true,\n        defaultValue: true,\n        widget: {\n          type: AXPWidgetsCatalog.toggle,\n          options: {\n            label: null,\n          },\n        },\n        description: `${I18N}.general.entity.apply-layout-ordering.description`,\n      })\n      .addSetting({\n        key: AXPCommonSettings.RedirectToDetailsAfterCreate,\n        title: `${I18N}.general.entity.redirect-to-details-after-create.title`,\n        scope: AXPPlatformScope.User,\n        isInherited: true,\n        defaultValue: true,\n        widget: {\n          type: AXPWidgetsCatalog.toggle,\n          options: {\n            label: null,\n          },\n        },\n        description: `${I18N}.general.entity.redirect-to-details-after-create.description`,\n      })\n      .addSetting({\n        key: AXPCommonSettings.ShowPageBadge,\n        title: `${I18N}.general.entity.show-page-badge.title`,\n        scope: AXPPlatformScope.User,\n        isInherited: true,\n        defaultValue: true,\n        widget: {\n          type: AXPWidgetsCatalog.toggle,\n          options: {\n            label: null,\n          },\n        },\n        description: `${I18N}.general.entity.show-page-badge.description`,\n      })\n\n      // End the 'Entity Settings' section\n      .endSection()\n      // End the 'General Settings' group\n      .endGroup();\n  }\n}\n"],"names":[],"mappings":"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"}

package/fesm2022/acorex-platform-common.mjs

@@ -4,8 +4,7 @@ import { kebabCase, merge, sortBy, cloneDeep, get, omit } from 'lodash-es';
 import { Router, ROUTES, RouterModule } from '@angular/router';
 import { AXPSessionService, AXPSessionStatus } from '@acorex/platform/auth';
 import { Subject, distinctUntilChanged, merge as merge$1 } from 'rxjs';
-import { AXPPlatformScope, AXPBroadcastEventService, objectKeyValueTransforms, AXPSystemActionType, AXPModuleManifestModule, AXPAppStartUpProvider, AXP_EXPRESSION_EVALUATOR_SCOPE_PROVIDER, AXPHookService, AXPDataGenerator, AXPModuleManifestRegistry } from '@acorex/platform/core';
-import { AXTranslationService } from '@acorex/core/translation';
+import { unwrapValueProperty, coerceUnknownToDate, coerceUnknownToFiniteNumber, coerceUnknownToBoolean, coerceUnknownToTrimmedString, AXPPlatformScope, AXPBroadcastEventService, objectKeyValueTransforms, AXPSystemActionType, AXPModuleManifestModule, AXPAppStartUpProvider, AXP_EXPRESSION_EVALUATOR_SCOPE_PROVIDER, AXPHookService, AXPDataGenerator, AXPModuleManifestRegistry } from '@acorex/platform/core';
 import { AXPWidgetsCatalog } from '@acorex/platform/layout/widget-core';
 import { AXPopupModule, AXPopupService } from '@acorex/components/popup';
 import { AXToastService, AXToastModule } from '@acorex/components/toast';
@@ -15,6 +14,7 @@ import { AXPWorkflowService, createWorkFlowEvent, AXPWorkflowAction, AXPWorkflow
 import { AXDataSource } from '@acorex/cdk/common';
 import { AXPCommandExecutor, AXPCommandService } from '@acorex/platform/runtime';
 import { signalStore, withState, withMethods, patchState, withHooks } from '@ngrx/signals';
+import { AXTranslationService } from '@acorex/core/translation';
 import { AXFormatService } from '@acorex/core/format';
 import { AXDialogService } from '@acorex/components/dialog';
 import { AXFileService } from '@acorex/core/file';
@@ -239,6 +239,70 @@ var AXPRegionalSetting;
     AXPRegionalSetting["MultiLanguageSupport"] = "LocaleManagement:Setting:Regional.MultiLanguageSupport";
 })(AXPRegionalSetting || (AXPRegionalSetting = {}));
 
+//#region ---- Imports ----
+//#endregion
+//#region ---- Kind inference ----
+/**
+ * If the payload uses the common `{ value: T }` shape from setting widgets, returns the inner value; otherwise returns `raw`.
+ */
+function peelSettingValueKey(raw) {
+    return unwrapValueProperty(raw);
+}
+function coercionKindFromScalarSample(v) {
+    if (v === null || v === undefined) {
+        return null;
+    }
+    if (typeof v === 'boolean') {
+        return 'boolean';
+    }
+    if (typeof v === 'number' && Number.isFinite(v)) {
+        return 'number';
+    }
+    if (v instanceof Date) {
+        return 'date';
+    }
+    if (typeof v === 'string') {
+        if (v === 'true' || v === 'false') {
+            return 'boolean';
+        }
+        return 'string';
+    }
+    return null;
+}
+/**
+ * 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.
+ */
+function inferSettingCoercionKind(defaultSample, effective) {
+    const fromDefault = coercionKindFromScalarSample(defaultSample);
+    if (fromDefault) {
+        return fromDefault;
+    }
+    return coercionKindFromScalarSample(unwrapValueProperty(effective));
+}
+//#endregion
+//#region ---- Value coercion ----
+function coerceAXPSettingRawValueByKind(raw, kind) {
+    switch (kind) {
+        case 'string':
+            return coerceUnknownToTrimmedString(raw);
+        case 'boolean':
+            return coerceUnknownToBoolean(raw);
+        case 'number':
+            return coerceUnknownToFiniteNumber(raw);
+        case 'date':
+            return coerceUnknownToDate(raw);
+        default: {
+            const _exhaustive = kind;
+            return _exhaustive;
+        }
+    }
+}
+function coerceAXPSettingRawValue(raw, kind) {
+    return coerceAXPSettingRawValueByKind(raw, kind);
+}
+//#endregion
+
 const AXP_SETTING_VALUE_PROVIDER = new InjectionToken('AXP_SETTING_VALUE_PROVIDER', {
     providedIn: 'root',
     factory: () => {
@@ -328,10 +392,11 @@ class AXPSettingDefinitionProviderContext {
         this.rootGroups = [];
         this.groupMap = new Map();
     }
-    addGroup(name, title, description, icon) {
+    addGroup(name, title, description, icon, pageTitle) {
         const newGroup = {
             name,
             title,
+            pageTitle,
             description,
             icon,
             groups: [],
@@ -382,10 +447,11 @@ class AXPSettingDefinitionGroupBuilder {
         }
         return new AXPSettingDefinitionSectionBuilder(this, foundSection);
     }
-    addGroup(name, title, description, icon) {
+    addGroup(name, title, description, icon, pageTitle) {
         const newGroup = {
             name,
             title,
+            pageTitle,
             description: description,
             icon,
             groups: [],
@@ -412,6 +478,7 @@ class AXPSettingDefinitionSectionBuilder {
             name: setting.key,
             title: setting.title,
             description: setting.description,
+            searchTagKeys: setting.searchTagKeys,
             isRequired: setting.isRequired ?? false,
             isInherited: setting.isInherited ?? false,
             isEncrypted: setting.isEncrypted ?? false,
@@ -654,26 +721,42 @@ class AXPSettingsService {
             throw error;
         }
     }
+    /**
+     * 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)`).
+     */
     async get(key) {
+        const { effective, defaultSample } = await this.resolveEffectiveAndDefault(key);
+        const kind = inferSettingCoercionKind(defaultSample, effective);
+        if (kind !== null) {
+            return coerceAXPSettingRawValueByKind(effective, kind);
+        }
+        if (effective === undefined) {
+            return effective;
+        }
+        return cloneDeep(effective);
+    }
+    /**
+     * Effective value (user → tenant → platform) when set; otherwise the definition default. Used for reads and coercion hints.
+     */
+    async resolveEffectiveAndDefault(key) {
         if (this.scopedSettingsCache.size === 0) {
             await this.load();
         }
-        const scopeOrder = [
-            AXPPlatformScope.User,
-            AXPPlatformScope.Tenant,
-            AXPPlatformScope.Platform,
-        ];
+        const defaults = await this.injector.get(AXPSettingDefaultValuesAggregatorService).getDefaults();
+        const defaultSample = get(defaults, key);
+        const scopeOrder = [AXPPlatformScope.User, AXPPlatformScope.Tenant, AXPPlatformScope.Platform];
         for (const scope of scopeOrder) {
             const scopeCache = this.scopedSettingsCache.get(scope);
             if (scopeCache && scopeCache.has(key)) {
                 const value = scopeCache.get(key);
                 if (value !== undefined && value !== null) {
-                    return cloneDeep(value);
+                    return { effective: value, defaultSample };
                 }
             }
         }
-        const defaults = await this.injector.get(AXPSettingDefaultValuesAggregatorService).getDefaults();
-        return get(defaults, key); // Fallback if no value is found
+        return { effective: defaultSample, defaultSample };
     }
     async defaultValues(scope) {
         let scopeOrder = [
@@ -732,7 +815,17 @@ class ScopedSettingService {
     async get(key) {
         const settings = await this.provider.load();
         const setting = settings.find((s) => s.key === key);
-        return setting ? cloneDeep(setting.value) : undefined;
+        const effective = setting?.value;
+        const defaults = await this.parent.defaultValues(this.provider.scope);
+        const defaultSample = get(defaults, key);
+        const kind = inferSettingCoercionKind(defaultSample, effective);
+        if (kind !== null) {
+            return coerceAXPSettingRawValueByKind(effective, kind);
+        }
+        if (effective === undefined) {
+            return effective;
+        }
+        return cloneDeep(effective);
     }
     async all() {
         const settings = await this.provider.load();
@@ -1129,28 +1222,27 @@ function provideDynamicHomePage() {
     ]);
 }
 
+const I18N = '@general:settings';
 class AXPHomePageSettingProvider {
     constructor(injector) {
         this.injector = injector;
-        this.translateService = this.injector.get(AXTranslationService);
         this.homePageService = this.injector.get(AXPHomePageService);
         this.defaultHomePageKey = inject(AXP_HOME_PAGE_DEFAULT_KEY, { optional: true }) ?? 'home';
     }
     async provide(context) {
-        const trans = async (key) => await this.translateService.translateAsync(`@general:settings.${key}`);
-        const list = await this.homePageService.getRegisteredList().map((c) => ({ id: c.key, title: c.title }));
+        const list = this.homePageService.getRegisteredList().map((c) => ({ id: c.key, title: c.title }));
         if (list.length === 0) {
             return;
         }
         // Define the 'General Settings' group
         context
-            .addGroup('general', await trans('general.title'), await trans('general.description'), 'fa-light fa-palette')
+            .addGroup('general', `${I18N}.general.nav-title`, `${I18N}.general.description`, 'fa-light fa-palette', `${I18N}.general.title`)
             // Add the 'Startup' section
-            .addSection('startup', await trans('general.startup.title'), await trans('general.startup.description'))
+            .addSection('startup', `${I18N}.general.startup.title`, `${I18N}.general.startup.description`)
             // Add the 'Home Page' setting
             .addSetting({
             key: AXPHomePageSettings.UserHomePath,
-            title: await trans('general.startup.home-page.title'),
+            title: `${I18N}.general.startup.home-page.title`,
             scope: AXPPlatformScope.User,
             isInherited: true,
             defaultValue: this.defaultHomePageKey || list[0].id,
@@ -1163,7 +1255,7 @@ class AXPHomePageSettingProvider {
                     dataSource: list,
                 },
             },
-            description: await trans('general.startup.home-page.description'),
+            description: `${I18N}.general.startup.home-page.description`,
         })
             // End the 'Startup' section
             .endSection()
@@ -3339,7 +3431,7 @@ class AXPCommonModule {
                 provide: AXP_SETTING_DEFINITION_PROVIDER,
                 useFactory: async () => {
                     const injector = inject(Injector);
-                    const provider = (await import('./acorex-platform-common-common-settings.provider-G9XcXXOG.mjs')).AXPCommonSettingProvider;
+                    const provider = (await import('./acorex-platform-common-common-settings.provider-lWz_f-Ia.mjs')).AXPCommonSettingProvider;
                     return new provider(injector);
                 },
                 multi: true,
@@ -3419,7 +3511,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImpor
                             provide: AXP_SETTING_DEFINITION_PROVIDER,
                             useFactory: async () => {
                                 const injector = inject(Injector);
-                                const provider = (await import('./acorex-platform-common-common-settings.provider-G9XcXXOG.mjs')).AXPCommonSettingProvider;
+                                const provider = (await import('./acorex-platform-common-common-settings.provider-lWz_f-Ia.mjs')).AXPCommonSettingProvider;
                                 return new provider(injector);
                             },
                             multi: true,
@@ -4619,5 +4711,5 @@ class AXPVersioningService {
  * Generated bundle index. Do not edit.
  */
 
-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 { ALL_DEFAULT_OPERATORS, AXMWorkflowErrorHandler, AXPAppVersionService, AXPCleanNestedFilters, AXPClipBoardService, AXPCommonModule, AXPCommonSettings, AXPCustomOperatorService, AXPCustomOperatorServiceImpl, AXPDataProvider, AXPDebugService, AXPDefaultMultiLanguageConfigService, AXPDialogConfirmAction, AXPEntityCommandScope, AXPEntityQueryType, AXPEntityType, AXPErrorHandlerRegistryService, AXPExportService, AXPFileActionsService, AXPFileStorageService, AXPFileStorageStatus, AXPFileTypeProviderService, AXPFilterOperatorMiddlewareService, AXPFilterOperatorMiddlewareServiceImpl, AXPFooterTextSlotComponent, AXPGlobalErrorHandler, AXPHomePageModule, AXPHomePageService, AXPLockService, AXPMenuItemsDataSourceDefinition, AXPMenuMiddlewareRegistry, AXPMenuProviderService, AXPMenuSearchDefinitionProvider, AXPMenuSearchProvider, AXPMenuService, AXPMenuVisibilityService, AXPNavBarSlotComponent, AXPNavigateWorkflow, AXPPlatformDefaultConfigs, AXPRedirectEvent, AXPRefreshEvent, AXPRegionalSetting, AXPRelationshipCardinality, AXPRelationshipKind, AXPReloadAction, AXPReloadEvent, AXPSearchCommandProvider, AXPSearchDefinitionActionBuilder, AXPSearchDefinitionBuilder, AXPSearchDefinitionProviderContext, AXPSearchDefinitionProviderService, AXPSearchService, AXPSettingDefaultValuesAggregatorService, AXPSettingDefinitionGroupBuilder, AXPSettingDefinitionProviderContext, AXPSettingDefinitionProviderService, AXPSettingDefinitionSectionBuilder, AXPSettingsEvaluatorScopeProvider, AXPSettingsService, AXPStatusDefinitionProviderService, AXPStatusProvider, AXPStickyDirective, AXPSystemStatusType, AXPSystemStatuses, AXPToastAction, AXPTokenDefinitionService, AXPTokenEvaluatorScopeProvider, AXPVersioningService, AXPWorkflowNavigateAction, AXPWorkflowRouterNavigateAction, AXP_APP_VERSION_PROVIDER, AXP_FILE_ACTION_PROVIDER, AXP_FILE_TYPE_INFO_PROVIDER, AXP_HOME_PAGES, AXP_HOME_PAGE_DEFAULT_KEY, AXP_LOCALE_MANAGEMENT_PORT, AXP_MENU_MIDDLEWARE, AXP_MENU_PROVIDER, AXP_PLATFORM_CONFIG_TOKEN, AXP_ROOT_CONFIG_TOKEN, AXP_SEARCH_DEFINITION_PROVIDER, AXP_SEARCH_PROVIDER, AXP_SETTING_DEFAULT_VALUES_PROVIDERS, AXP_SETTING_DEFINITION_PROVIDER, AXP_SETTING_VALUE_PROVIDER, AXP_STATUS_PROVIDERS, AXP_TOKEN_DEFINITION_PROVIDER, AXVChangeType, BETWEEN_OPER, BOOLEAN_OPERATORS, CONTAINS_OPER, DATE_OPERATORS, DEFAULT_MULTILANGUAGE_FIELD_NAMES, ENDS_WITH_OPER, ENVIRONMENT, EQ_OPER, GTE_OPER, GT_OPER, IN_OPER, IS_EMPTY_OPER, IS_NOT_EMPTY_OPER, LTE_OPER, LT_OPER, MENU_ITEMS_DATASOURCE_NAME, MULTILANGUAGE_CAPABLE_WIDGET_TYPES, NOT_CONTAINS_OPER, NOT_EQ_OPER, NUMBER_OPERATORS, STARTS_WITH_OPER, STRING_OPERATORS, UploadFromComputerActionProvider, coerceAXPSettingRawValue, coerceAXPSettingRawValueByKind, configPlatform, createAllQueryView, createEntityCommandOptions, createEntitySearchCommand, createMenuContext, createMenuMiddleware, createQueryView, getEntityInfo, getStatusInfo, getSystemStatus, inferSettingCoercionKind, peelSettingValueKey, provideDynamicHomePage, provideMenuMiddleware, resolveStatusLook, shouldApplyDefaultMultiLanguageToEntityProperty, shouldApplyDefaultMultiLanguageToWidgetNode, shouldApplyDefaultMultiLanguageToWidgetProperty, systemStatusToDefinition, withDefaultMultiLanguageOnWidgetNodeTree, withDefaultMultiLanguageOnWidgetProperty };
 //# sourceMappingURL=acorex-platform-common.mjs.map