@acorex/modules 21.0.0-next.70 → 21.0.0-next.71

package/fesm2022/acorex-modules-common.mjs

@@ -1,17 +1,17 @@
 import { AXPEntityCommandScope, createQueryView, AXPRefreshEvent, AXVChangeType, AXPVersioningService, AXPSettingsService, AXPCommonSettings, createAllQueryView, AXPEntityQueryType, AXPLockService, AXPStatusDefinitionProviderService, AXPStatusProvider, AXPSystemStatuses, AXPSystemStatusType, AXPHomePageService, ALL_DEFAULT_OPERATORS, AXP_MENU_PROVIDER, AXP_SETTING_DEFINITION_PROVIDER, AXP_STATUS_PROVIDERS, AXPSearchService } from '@acorex/platform/common';
 import * as i1$4 from '@acorex/platform/core';
-import { AXPSystemActionType, AXPExpressionEvaluatorService, getSmart, AXP_EXPRESSION_EVALUATOR_SCOPE_PROVIDER, AXPBroadcastEventService, AXP_MODULE_MANIFEST_PROVIDER, AXP_FEATURE_DEFINITION_PROVIDER, AXPComponentSlotModule, AXPPlatformScope } from '@acorex/platform/core';
+import { AXPSystemActionType, PLATFORM_CATALOG_SCOPES_DATASOURCE_NAME, AXPCatalogScopeDefinitionProviderService, AXPCatalogScopeDefinitionsDataSourceDefinition, AXP_DATASOURCE_DEFINITION_PROVIDER, AXPExpressionEvaluatorService, getSmart, AXP_EXPRESSION_EVALUATOR_SCOPE_PROVIDER, AXPBroadcastEventService, AXP_MODULE_MANIFEST_PROVIDER, AXP_FEATURE_DEFINITION_PROVIDER, AXP_CATALOG_SCOPE_DEFINITION_PROVIDER, AXPComponentSlotModule, AXPPlatformScope } from '@acorex/platform/core';
 import { provideCommandSetups, provideCommandMiddleware, AXPCommandExecutor } from '@acorex/platform/runtime';
 import { AXPWidgetsModule } from '@acorex/platform/layout/widgets';
 import * as i0 from '@angular/core';
 import { inject, Injectable, NgModule, input, signal, computed, ChangeDetectionStrategy, Component, Injector, runInInjectionContext, ViewEncapsulation, InjectionToken, HostListener } from '@angular/core';
-import { ensureListActions, actionExists, AXPEntityDefinitionRegistryService, AXP_ENTITY_ACTION_PLUGIN, resolveEntityPluginDetailPageOrder, cloneLayoutArrays, ensureLayoutSection, ensureLayoutPropertyView, AXMEntityCrudServiceImpl, entityMasterCrudActions, entityMasterDeleteAction, AXP_ENTITY_DEFINITION_LOADER, AXP_ENTITY_STORAGE_BACKEND, AXP_ENTITY_STORAGE_MIDDLEWARE, AXPEntityEventsKeys, AXPEntityService, AXPMultiSourceType, AXP_MULTI_SOURCE_DEFINITION_PROVIDER } from '@acorex/platform/layout/entity';
+import { ensureListActions, actionExists, AXPEntityDefinitionRegistryService, AXP_ENTITY_ACTION_PLUGIN, resolveEntityPluginDetailPageOrder, cloneLayoutArrays, ensureLayoutSection, ensureLayoutPropertyView, AXMEntityCrudServiceImpl, entityMasterCrudActions, entityMasterDeleteAction, AXP_ENTITY_DEFINITION_LOADER, AXPMiddlewareAbortError, AXP_ENTITY_STORAGE_MIDDLEWARE, AXP_ENTITY_STORAGE_BACKEND, AXPEntityEventsKeys, AXPEntityService, AXPMultiSourceType, AXP_MULTI_SOURCE_DEFINITION_PROVIDER } from '@acorex/platform/layout/entity';
 import * as i1 from '@acorex/platform/workflow';
 import { createWorkFlowEvent, AXPWorkflowAction, AXPWorkflowModule, AXPWorkflowService } from '@acorex/platform/workflow';
 import { AXDialogService } from '@acorex/components/dialog';
 import { AXLoadingDialogService } from '@acorex/components/loading-dialog';
 import * as i4 from '@acorex/core/translation';
-import { AXTranslationService, AXTranslationModule } from '@acorex/core/translation';
+import { AXTranslationService, AXTranslationModule, createMultiLanguageString } from '@acorex/core/translation';
 import { AXP_PAGE_COMPONENT_PROVIDER, AXPActivityLogComponent, AXPCompareViewComponent, AXPThemeLayoutBlockComponent, AXPResourceAppointmentComponent } from '@acorex/platform/layout/components';
 import { AXPWidgetGroupEnum, AXP_WIDGET_DEFINITION_PROVIDER, AXPWidgetRegistryService, AXPWidgetsCatalog } from '@acorex/platform/layout/widget-core';
 import { AXPopupService } from '@acorex/components/popup';
@@ -20,13 +20,13 @@ import * as i1$1 from '@acorex/components/decorators';
 import { AXDecoratorModule } from '@acorex/components/decorators';
 import { AXLoadingModule } from '@acorex/components/loading';
 import { AXP_PERMISSION_DEFINITION_PROVIDER, AXPSessionService } from '@acorex/platform/auth';
+import { castArray, get, isString, isArray, set, isEmpty } from 'lodash-es';
 import * as i1$2 from '@angular/common';
 import { CommonModule, AsyncPipe } from '@angular/common';
 import * as i2 from '@acorex/components/button';
 import { AXButtonModule } from '@acorex/components/button';
 import { AXBasePageComponent } from '@acorex/components/page';
 import { AXFormatService } from '@acorex/core/format';
-import { get, set } from 'lodash-es';
 import { AXToastService } from '@acorex/components/toast';
 import { AXPLayoutBuilderService } from '@acorex/platform/layout/builder';
 import * as i1$3 from '@acorex/core/validation';
@@ -114,6 +114,7 @@ const AXPWidgetsList = {
         ProgressBox: 'progress-bar-editor',
         RatePicker: 'rate-picker-editor',
         ActivityCommandConfigurator: 'activity-command-configurator',
+        WorkflowConfigurator: 'workflow-configurator',
     },
     Layouts: {
         AlertBox: 'alert-box-layout',
@@ -2252,6 +2253,411 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImpor
                 }]
         }] });
 
+//#region ---- Imports ----
+//#endregion
+//#region ---- Plugin ----
+const catalogScopePlugin = {
+    name: 'catalog-scope',
+    order: 46,
+    apply: (ctx, options) => {
+        const moduleName = ctx.entity.module;
+        const baseEntityName = ctx.entity.name;
+        const entityTarget = options?.entityTarget?.trim() ||
+            `${moduleName}.${baseEntityName}`;
+        const propertyName = options?.propertyName?.trim()?.length
+            ? options.propertyName.trim()
+            : 'catalogScopeKeys';
+        const allowMultiple = options?.allowMultiple ?? true;
+        const dataSource = options?.dataSource?.trim() || PLATFORM_CATALOG_SCOPES_DATASOURCE_NAME;
+        const showInList = options?.showInList ?? false;
+        const groupId = options?.groupId?.trim() || 'classification';
+        const layoutOrder = options?.layoutOrder ?? 14;
+        const groups = ctx.groups.list() ?? [];
+        if (!groups.some((g) => g.id === groupId)) {
+            ctx.groups.add({
+                id: groupId,
+                title: '@general:terms.interface.classification',
+            });
+        }
+        const props = ctx.properties.list();
+        if (!props.some((p) => p.name === propertyName)) {
+            ctx.properties.add({
+                name: propertyName,
+                title: '@general:terms.classification.catalog-scopes',
+                groupId,
+                schema: {
+                    dataType: 'string',
+                    interface: {
+                        type: AXPWidgetsList.Editors.SelectBox,
+                        options: {
+                            multiple: allowMultiple,
+                            valueField: 'name',
+                            textField: 'title',
+                            cssClassField: 'cssClass',
+                            hasClearButton: true,
+                            allowSearch: true,
+                            dataSource,
+                            filter: {
+                                field: 'targets',
+                                operator: { type: 'contains' },
+                                value: entityTarget,
+                            },
+                            ...(options?.allowedScopeKeys?.length
+                                ? { allowedScopeKeys: options.allowedScopeKeys }
+                                : {}),
+                        },
+                    },
+                },
+                validations: [{ rule: 'required' }],
+                options: {
+                    sort: { enabled: false },
+                    filter: {
+                        advance: { enabled: true },
+                        inline: { enabled: false },
+                    },
+                },
+            });
+        }
+        const columns = ctx.columns.list() ?? [];
+        if (!columns.some((c) => c.name === propertyName)) {
+            ctx.columns.add({
+                name: propertyName,
+                title: '@general:terms.classification.catalog-scopes',
+                width: 220,
+                sortable: false,
+                filterable: true,
+                visible: showInList,
+                showAs: {
+                    type: AXPWidgetsList.Editors.SelectBox,
+                    options: {
+                        valueField: 'name',
+                        textField: 'title',
+                        cssClassField: 'cssClass',
+                        multiple: allowMultiple,
+                    },
+                },
+                options: {
+                    dataPath: 'catalogScopes',
+                },
+            });
+        }
+        const applyLayoutPatch = (layout) => {
+            const next = cloneLayoutArrays(layout);
+            ensureLayoutSection(next, { id: groupId, order: 150 });
+            ensureLayoutPropertyView(next, {
+                name: propertyName,
+                layout: { positions: { lg: { colSpan: 12, order: layoutOrder } } },
+            });
+            return next;
+        };
+        ctx.interfaces.master.create.update((create) => applyLayoutPatch(create ?? { sections: [], properties: [] }));
+        ctx.interfaces.master.modify.update((modify) => applyLayoutPatch(modify ?? { sections: [], properties: [] }));
+        ctx.interfaces.master.single.update((single) => applyLayoutPatch(single ?? { title: ctx.entity.title, sections: [], properties: [] }));
+        ctx.entity.extensions ??= {};
+        ctx.entity.extensions.catalogScope = {
+            propertyName,
+            entityTarget,
+            allowMultiple,
+            dataSource,
+            allowedScopeKeys: options?.allowedScopeKeys,
+        };
+    },
+};
+//#endregion
+
+//#region ---- Imports ----
+//#endregion
+//#region ---- Service ----
+/**
+ * Resolves catalog scope keys to display rows using registered module providers (source of truth for {@link cssClass}).
+ */
+class AXPCatalogScopeEnrichmentService {
+    constructor() {
+        this.registry = inject(AXPCatalogScopeDefinitionProviderService);
+    }
+    async resolveItems(keys) {
+        const items = [];
+        for (const name of keys) {
+            const definition = await this.registry.get(name);
+            items.push({
+                name,
+                title: definition ? this.registry.resolveTitle(definition) : name,
+                cssClass: definition?.cssClass?.trim() || undefined,
+            });
+        }
+        return items;
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPCatalogScopeEnrichmentService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPCatalogScopeEnrichmentService, providedIn: 'root' }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPCatalogScopeEnrichmentService, decorators: [{
+            type: Injectable,
+            args: [{ providedIn: 'root' }]
+        }] });
+
+//#region ---- Imports ----
+//#endregion
+//#region ---- Helpers ----
+/**
+ * Normalizes scope keys from stored property values and/or enriched `catalogScopes` rows.
+ * Accepts string keys (persisted) and select-box row objects (`{ name, title, … }`).
+ */
+function normalizeCatalogScopeKeys(data, propertyName = 'catalogScopeKeys', enrichPath = 'catalogScopes') {
+    const keys = new Set();
+    for (const entry of castArray(get(data, propertyName))) {
+        if (isString(entry) && entry.trim()) {
+            keys.add(entry.trim());
+            continue;
+        }
+        if (entry != null && typeof entry === 'object' && !Array.isArray(entry)) {
+            const name = entry['name'];
+            if (typeof name === 'string' && name.trim()) {
+                keys.add(name.trim());
+            }
+        }
+    }
+    const scopes = get(data, enrichPath);
+    if (isArray(scopes)) {
+        for (const scope of scopes) {
+            if (isString(scope) && scope.trim()) {
+                keys.add(scope.trim());
+                continue;
+            }
+            if (scope != null && typeof scope === 'object' && !Array.isArray(scope)) {
+                const name = scope['name'];
+                if (typeof name === 'string' && name.trim()) {
+                    keys.add(name.trim());
+                }
+            }
+        }
+    }
+    return [...keys];
+}
+/** Writes normalized string keys onto the update/create payload. */
+function applyNormalizedCatalogScopeKeys(data, propertyName = 'catalogScopeKeys', enrichPath = 'catalogScopes') {
+    const keys = normalizeCatalogScopeKeys(data, propertyName, enrichPath);
+    if (keys.length) {
+        set(data, propertyName, keys);
+    }
+    return keys;
+}
+//#endregion
+
+//#region ---- Imports ----
+const READ_OPS = new Set(['getOne', 'getAll', 'query', 'queryAll']);
+//#endregion
+//#region ---- Helpers ----
+function readResultRows(result) {
+    if (!result || typeof result !== 'object') {
+        return [];
+    }
+    if (Array.isArray(result)) {
+        return result;
+    }
+    const items = result.items;
+    return Array.isArray(items) ? items : [];
+}
+async function enrichRows(rows, propertyName, enrichPath, enrichment) {
+    for (const row of rows) {
+        if (!row) {
+            continue;
+        }
+        const keys = normalizeCatalogScopeKeys(row, propertyName, enrichPath);
+        if (isEmpty(keys)) {
+            continue;
+        }
+        set(row, propertyName, keys);
+        set(row, enrichPath, await enrichment.resolveItems(keys));
+    }
+}
+//#endregion
+//#region ---- Middleware ----
+/**
+ * Resolves {@link catalogScopePlugin} keys to `catalogScopes: [{ name, title, cssClass }]` on write and read.
+ * {@link cssClass} always comes from registered providers on read (not stale persisted mock values).
+ */
+const catalogScopeResolverMiddleware = {
+    target: {
+        ops: ['create', 'update', 'getOne', 'getAll', 'query', 'queryAll', 'initial'],
+        order: 9,
+    },
+    execute: async (ctx, next) => {
+        const entityRegistry = inject(AXPEntityDefinitionRegistryService);
+        const enrichment = inject(AXPCatalogScopeEnrichmentService);
+        const [moduleName, entityName] = ctx.entityName.split('.');
+        if (!moduleName || !entityName) {
+            await next();
+            return;
+        }
+        if ((ctx.op === 'create' || ctx.op === 'update' || ctx.op === 'initial') &&
+            (ctx.data === undefined || ctx.data === null)) {
+            await next();
+            return;
+        }
+        const def = await entityRegistry.resolve(moduleName, entityName).catch(() => null);
+        const catalogExt = def
+            ?.extensions?.catalogScope;
+        if (!catalogExt?.propertyName) {
+            await next();
+            return;
+        }
+        const propertyName = catalogExt.propertyName;
+        const enrichPath = 'catalogScopes';
+        try {
+            if (ctx.op === 'initial' && Array.isArray(ctx.data)) {
+                await enrichRows(ctx.data, propertyName, enrichPath, enrichment);
+            }
+            else if (ctx.op === 'create' || ctx.op === 'update') {
+                const data = ctx.data;
+                const hasPayload = propertyName in data || enrichPath in data;
+                if (hasPayload) {
+                    const keys = applyNormalizedCatalogScopeKeys(data, propertyName, enrichPath);
+                    if (!isEmpty(keys)) {
+                        set(data, enrichPath, await enrichment.resolveItems(keys));
+                    }
+                }
+            }
+        }
+        catch (error) {
+            console.error('[catalog-scope-resolver] Failed to resolve on write:', error);
+        }
+        await next();
+        if (READ_OPS.has(ctx.op) && ctx.result) {
+            try {
+                if (ctx.op === 'getOne') {
+                    await enrichRows([ctx.result], propertyName, enrichPath, enrichment);
+                }
+                else {
+                    await enrichRows(readResultRows(ctx.result), propertyName, enrichPath, enrichment);
+                }
+            }
+            catch (error) {
+                console.error('[catalog-scope-resolver] Failed to enrich on read:', error);
+            }
+        }
+    },
+};
+//#endregion
+
+//#region ---- Imports ----
+//#endregion
+//#region ---- Middleware ----
+/**
+ * Rejects unknown or inapplicable {@link catalogScopePlugin} keys on create/update.
+ */
+const catalogScopeValidationMiddleware = {
+    target: {
+        ops: ['create', 'update'],
+        order: 6,
+    },
+    execute: async (ctx, next) => {
+        const registry = inject(AXPEntityDefinitionRegistryService, { optional: true });
+        const scopeRegistry = inject(AXPCatalogScopeDefinitionProviderService);
+        if (!registry || ctx.data === undefined) {
+            await next();
+            return;
+        }
+        const parts = ctx.entityName.split('.');
+        const moduleName = parts[0] ?? '';
+        const entityName = parts.slice(1).join('.') || (parts[0] ?? '');
+        const entity = await registry.resolve(moduleName, entityName).catch(() => null);
+        const ext = entity?.extensions
+            ?.catalogScope;
+        if (!ext?.propertyName) {
+            await next();
+            return;
+        }
+        const data = ctx.data;
+        const propertyName = ext.propertyName;
+        const enrichPath = 'catalogScopes';
+        if (ctx.op === 'update' &&
+            !(propertyName in data) &&
+            !(enrichPath in data)) {
+            await next();
+            return;
+        }
+        const keys = applyNormalizedCatalogScopeKeys(data, propertyName, enrichPath);
+        if (isEmpty(keys)) {
+            throw new AXPMiddlewareAbortError(`Catalog scope is required (${propertyName}).`, { code: 'VALIDATION_ERROR', status: 400 });
+        }
+        const allowedSubset = ext.allowedScopeKeys?.length ? new Set(ext.allowedScopeKeys) : null;
+        const errors = [];
+        for (const key of keys) {
+            if (allowedSubset && !allowedSubset.has(key)) {
+                errors.push(`"${key}" is not allowed for this entity.`);
+                continue;
+            }
+            const definition = await scopeRegistry.get(key);
+            if (!definition) {
+                errors.push(`Unknown catalog scope: "${key}".`);
+                continue;
+            }
+            const target = ext.entityTarget?.trim();
+            if (target && !definition.targets?.includes(target)) {
+                errors.push(`Catalog scope "${key}" does not apply to ${target}.`);
+            }
+        }
+        if (errors.length) {
+            throw new AXPMiddlewareAbortError(errors.join(' '), {
+                code: 'VALIDATION_ERROR',
+                status: 400,
+                details: { errors },
+            });
+        }
+        await next();
+    },
+};
+//#endregion
+
+//#region ---- Imports ----
+//#endregion
+//#region ---- Module ----
+class AXPCatalogScopePluginModule {
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPCatalogScopePluginModule, deps: [], target: i0.ɵɵFactoryTarget.NgModule }); }
+    static { this.ɵmod = i0.ɵɵngDeclareNgModule({ minVersion: "14.0.0", version: "21.2.9", ngImport: i0, type: AXPCatalogScopePluginModule }); }
+    static { this.ɵinj = i0.ɵɵngDeclareInjector({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPCatalogScopePluginModule, providers: [
+            { provide: AXP_ENTITY_ACTION_PLUGIN, multi: true, useValue: catalogScopePlugin },
+            {
+                provide: AXP_DATASOURCE_DEFINITION_PROVIDER,
+                useClass: AXPCatalogScopeDefinitionsDataSourceDefinition,
+                multi: true,
+            },
+            {
+                provide: AXP_ENTITY_STORAGE_MIDDLEWARE,
+                multi: true,
+                useValue: catalogScopeValidationMiddleware,
+            },
+            {
+                provide: AXP_ENTITY_STORAGE_MIDDLEWARE,
+                multi: true,
+                useValue: catalogScopeResolverMiddleware,
+            },
+        ] }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPCatalogScopePluginModule, decorators: [{
+            type: NgModule,
+            args: [{
+                    providers: [
+                        { provide: AXP_ENTITY_ACTION_PLUGIN, multi: true, useValue: catalogScopePlugin },
+                        {
+                            provide: AXP_DATASOURCE_DEFINITION_PROVIDER,
+                            useClass: AXPCatalogScopeDefinitionsDataSourceDefinition,
+                            multi: true,
+                        },
+                        {
+                            provide: AXP_ENTITY_STORAGE_MIDDLEWARE,
+                            multi: true,
+                            useValue: catalogScopeValidationMiddleware,
+                        },
+                        {
+                            provide: AXP_ENTITY_STORAGE_MIDDLEWARE,
+                            multi: true,
+                            useValue: catalogScopeResolverMiddleware,
+                        },
+                    ],
+                }]
+        }] });
+
 const clonePlugin = {
     name: 'clone',
     order: 60,
@@ -6467,6 +6873,40 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImpor
             type: Injectable
         }] });
 
+/** Cross-module catalog scope for shared questionnaires, question bank items, and workflows. */
+const COMMON_CATALOG_SCOPE_GENERAL = 'common.general';
+
+//#region ---- Imports ----
+//#endregion
+//#region ---- Constants ----
+const M = createMultiLanguageString;
+const QUESTIONNAIRE = 'AssessmentManagement.Questionnaire';
+const QUESTION_BANK_ITEM = 'AssessmentManagement.QuestionBankItem';
+const WORKFLOW_DEFINITION = 'WorkflowManagement.WorkflowDefinition';
+const COMMON_CATALOG_TARGETS = [QUESTIONNAIRE, QUESTION_BANK_ITEM, WORKFLOW_DEFINITION];
+//#endregion
+//#region ---- Provider ----
+class AXPCommonCatalogScopeDefinitionProvider {
+    async items() {
+        return [
+            {
+                name: COMMON_CATALOG_SCOPE_GENERAL,
+                title: M('General', 'عمومی'),
+                description: M('Shared questionnaires, question bank items, and workflows not tied to a specific business domain.', 'پرسشنامه‌ها، آیتم‌های بانک سؤال و گردش‌کارهای مشترک که به یک حوزه کسب‌وکار خاص وابسته نیستند.'),
+                targets: [...COMMON_CATALOG_TARGETS],
+                icon: 'fa-light fa-grid-2',
+                cssClass: 'ax-lighter-surface ax-text-on-lighter-surface ax-border-border-lighter-surface',
+                order: 0,
+            },
+        ];
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPCommonCatalogScopeDefinitionProvider, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPCommonCatalogScopeDefinitionProvider }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPCommonCatalogScopeDefinitionProvider, decorators: [{
+            type: Injectable
+        }] });
+
 //#region ----   Platform Imports   ----
 //#endregion
 class AXMCommonModule {
@@ -6474,6 +6914,7 @@ class AXMCommonModule {
     static { this.ɵmod = i0.ɵɵngDeclareNgModule({ minVersion: "14.0.0", version: "21.2.9", ngImport: i0, type: AXMCommonModule, imports: [
             //#region ----   Extension & System Plugins   ----
             AXPCategoryModule,
+            AXPCatalogScopePluginModule,
             AXMLockSystemModule,
             AXPHistoryModule,
             //#endregion
@@ -6569,6 +7010,13 @@ class AXMCommonModule {
                 multi: true,
             },
             //#endregion
+            //#region ----   Catalog Scope Definition Provider   ----
+            {
+                provide: AXP_CATALOG_SCOPE_DEFINITION_PROVIDER,
+                useClass: AXPCommonCatalogScopeDefinitionProvider,
+                multi: true,
+            },
+            //#endregion
             //#region ----   Multi-Source Definition Provider   ----
             {
                 provide: AXP_MULTI_SOURCE_DEFINITION_PROVIDER,
@@ -6587,6 +7035,7 @@ class AXMCommonModule {
         ], imports: [
             //#region ----   Extension & System Plugins   ----
             AXPCategoryModule,
+            AXPCatalogScopePluginModule,
             AXMLockSystemModule,
             AXPHistoryModule,
             //#endregion
@@ -6626,6 +7075,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImpor
                     imports: [
                         //#region ----   Extension & System Plugins   ----
                         AXPCategoryModule,
+                        AXPCatalogScopePluginModule,
                         AXMLockSystemModule,
                         AXPHistoryModule,
                         //#endregion
@@ -6725,6 +7175,13 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImpor
                             multi: true,
                         },
                         //#endregion
+                        //#region ----   Catalog Scope Definition Provider   ----
+                        {
+                            provide: AXP_CATALOG_SCOPE_DEFINITION_PROVIDER,
+                            useClass: AXPCommonCatalogScopeDefinitionProvider,
+                            multi: true,
+                        },
+                        //#endregion
                         //#region ----   Multi-Source Definition Provider   ----
                         {
                             provide: AXP_MULTI_SOURCE_DEFINITION_PROVIDER,
@@ -7118,5 +7575,5 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImpor
  * Generated bundle index. Do not edit.
  */
 
-export { AXMCommonModule, AXMLockPopupWorkflow, AXMLockPopupWorkflowAction, AXMMenuProvider, AXMSettingProvider, AXMUnlockConfirmWorkflow, AXMUnlockConfirmWorkflowAction, AXMVersionHistoryPageComponent, AXPCommonFeatureDefinitionProvider, AXPCommonFeatureKeys, AXPCommonMenuKeys, AXPDisablePluginModule, AXPGlobalSearchModule, AXPGlobalSearchViewModel, AXPHistoryAuditInfoWidget, AXPHistoryModule, AXPResourceAppointmentPageComponent, AXPStatusPluginModule, AXPUniqueFieldsPluginModule, AXPValidationRulesModule, AXPWidgetsList, AXP_GLOBAL_SEARCH_CONFIG_TOKEN, AXP_RESOURCE_APPOINTMENT_PAGE_CONFIG, ApprovalStatusProvider, AtLeastOneOfValidationRule, CommonManifest, HISTORY_PAGE_COMPONENT_KEY, RootConfig, ShowVersionHistoryPopupCommand, StateStatusProvider, TaskStatusProvider, UniqueValidationRule, VARIABLE_NAME_VALIDATION_PATTERN, VariableNameValidationRule, disablePlugin, getActiveStatuses, getFinalStatuses, getInitialStatuses, getStatusByName, getTransitionsFromStatus, getTransitionsToStatus, historyPlugin, humanizeChange, isValidTransition, mapChangeType, mapOpToAction, resolvePathKey, statusPlugin, uniqueFieldsPlugin, versionEntriesToActivityLogs };
+export { AXMCommonModule, AXMLockPopupWorkflow, AXMLockPopupWorkflowAction, AXMMenuProvider, AXMSettingProvider, AXMUnlockConfirmWorkflow, AXMUnlockConfirmWorkflowAction, AXMVersionHistoryPageComponent, AXPCommonFeatureDefinitionProvider, AXPCommonFeatureKeys, AXPCommonMenuKeys, AXPDisablePluginModule, AXPGlobalSearchModule, AXPGlobalSearchViewModel, AXPHistoryAuditInfoWidget, AXPHistoryModule, AXPResourceAppointmentPageComponent, AXPStatusPluginModule, AXPUniqueFieldsPluginModule, AXPValidationRulesModule, AXPWidgetsList, AXP_GLOBAL_SEARCH_CONFIG_TOKEN, AXP_RESOURCE_APPOINTMENT_PAGE_CONFIG, ApprovalStatusProvider, AtLeastOneOfValidationRule, COMMON_CATALOG_SCOPE_GENERAL, CommonManifest, HISTORY_PAGE_COMPONENT_KEY, RootConfig, ShowVersionHistoryPopupCommand, StateStatusProvider, TaskStatusProvider, UniqueValidationRule, VARIABLE_NAME_VALIDATION_PATTERN, VariableNameValidationRule, disablePlugin, getActiveStatuses, getFinalStatuses, getInitialStatuses, getStatusByName, getTransitionsFromStatus, getTransitionsToStatus, historyPlugin, humanizeChange, isValidTransition, mapChangeType, mapOpToAction, resolvePathKey, statusPlugin, uniqueFieldsPlugin, versionEntriesToActivityLogs };
 //# sourceMappingURL=acorex-modules-common.mjs.map