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

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, AXPKeyboardShortcutRegistry, chordToKbdItemKeys, AXPKeyboardShortcutPriority, 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 { inject, Injectable, NgModule, input, signal, computed, ChangeDetectionStrategy, Component, Injector, runInInjectionContext, ViewEncapsulation, InjectionToken, DestroyRef } from '@angular/core';
+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';
@@ -19,22 +19,23 @@ import { ActivatedRoute } from '@angular/router';
 import * as i1$1 from '@acorex/components/decorators';
 import { AXDecoratorModule } from '@acorex/components/decorators';
 import { AXLoadingModule } from '@acorex/components/loading';
+import { AXPPageLayoutBaseComponent, AXPPageLayoutBase, AXPPageLayoutComponent } from '@acorex/platform/layout/views';
 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';
 import { AXValidationModule } from '@acorex/core/validation';
 import { AXCalendarService } from '@acorex/core/date-time';
 import { firstValueFrom, Subject } from 'rxjs';
+import { AXKBDComponent, AXKBDItemComponent } from '@acorex/components/kbd';
 import { AXTextBoxModule } from '@acorex/components/text-box';
-import { AXPPageLayoutBaseComponent, AXPPageLayoutComponent, AXPPageLayoutBase } from '@acorex/platform/layout/views';
 
 const config = {
     i18n: 'common',
@@ -114,6 +115,7 @@ const AXPWidgetsList = {
         ProgressBox: 'progress-bar-editor',
         RatePicker: 'rate-picker-editor',
         ActivityCommandConfigurator: 'activity-command-configurator',
+        WorkflowConfigurator: 'workflow-configurator',
     },
     Layouts: {
         AlertBox: 'alert-box-layout',
@@ -296,6 +298,7 @@ const archivePlugin = {
                     type: 'archive',
                     scope: AXPEntityCommandScope.Individual,
                     hidden: `{{ context.eval("${fieldName}") }}`,
+                    shortcuts: ['ctrl+shift+a'],
                 });
             }
             // Add restore archive action to list view
@@ -313,6 +316,7 @@ const archivePlugin = {
                     type: 'update',
                     scope: AXPEntityCommandScope.Individual,
                     hidden: `{{ !context.eval("${fieldName}") }}`,
+                    shortcuts: ['ctrl+shift+a'],
                 });
             }
             // Add bulk archive action to list view
@@ -361,6 +365,7 @@ const archivePlugin = {
                     type: 'archive',
                     scope: AXPEntityCommandScope.Individual,
                     hidden: `{{ context.eval("${fieldName}") }}`,
+                    shortcuts: ['ctrl+shift+a'],
                 });
             }
             // Add restore archive action to single view
@@ -378,6 +383,7 @@ const archivePlugin = {
                     type: 'update',
                     scope: AXPEntityCommandScope.Individual,
                     hidden: `{{ !context.eval("${fieldName}") }}`,
+                    shortcuts: ['ctrl+shift+a'],
                 });
             }
             return i;
@@ -1111,6 +1117,7 @@ const historyPlugin = {
                         priority: 'secondary',
                         type: 'version-history',
                         scope: AXPEntityCommandScope.Individual,
+                        shortcuts: ['ctrl+shift+h'],
                     });
                 }
                 const singleActions = i.master?.single?.actions || [];
@@ -1128,6 +1135,7 @@ const historyPlugin = {
                         priority: 'secondary',
                         type: 'version-history',
                         scope: AXPEntityCommandScope.Individual,
+                        shortcuts: ['ctrl+shift+h'],
                     });
                 }
                 return i;
@@ -1616,8 +1624,9 @@ function versionEntriesToActivityLogs(entries, refId, refType, fieldTitles, getH
  * Entity page component that shows version history for the current record.
  * Used when history plugin has display: 'page'. Resolves refId/refType from rootContext or route.
  */
-class AXMVersionHistoryPageComponent {
+class AXMVersionHistoryPageComponent extends AXPPageLayoutBaseComponent {
     constructor() {
+        super(...arguments);
         this.rootContext = input.required(...(ngDevMode ? [{ debugName: "rootContext" }] : /* istanbul ignore next */ []));
         this.pageConfig = input(...(ngDevMode ? [undefined, { debugName: "pageConfig" }] : /* istanbul ignore next */ []));
         this.options = input({}, ...(ngDevMode ? [{ debugName: "options" }] : /* istanbul ignore next */ []));
@@ -1649,6 +1658,7 @@ class AXMVersionHistoryPageComponent {
         return config?.historyLayout;
     }
     async ngOnInit() {
+        await super.ngOnInit();
         this.isBusy.set(true);
         const { refId, refType } = this.resolveEntityRef();
         if (!refId || !refType) {
@@ -1717,8 +1727,13 @@ class AXMVersionHistoryPageComponent {
             null;
         return { refId, refType };
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXMVersionHistoryPageComponent, deps: [], target: i0.ɵɵFactoryTarget.Component }); }
-    static { this.ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.1.0", version: "21.2.9", type: AXMVersionHistoryPageComponent, isStandalone: true, selector: "axm-version-history-page", inputs: { rootContext: { classPropertyName: "rootContext", publicName: "rootContext", isSignal: true, isRequired: true, transformFunction: null }, pageConfig: { classPropertyName: "pageConfig", publicName: "pageConfig", isSignal: true, isRequired: false, transformFunction: null }, options: { classPropertyName: "options", publicName: "options", isSignal: true, isRequired: false, transformFunction: null } }, ngImport: i0, template: `
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXMVersionHistoryPageComponent, deps: null, target: i0.ɵɵFactoryTarget.Component }); }
+    static { this.ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.1.0", version: "21.2.9", type: AXMVersionHistoryPageComponent, isStandalone: true, selector: "axm-version-history-page", inputs: { rootContext: { classPropertyName: "rootContext", publicName: "rootContext", isSignal: true, isRequired: true, transformFunction: null }, pageConfig: { classPropertyName: "pageConfig", publicName: "pageConfig", isSignal: true, isRequired: false, transformFunction: null }, options: { classPropertyName: "options", publicName: "options", isSignal: true, isRequired: false, transformFunction: null } }, providers: [
+            {
+                provide: AXPPageLayoutBase,
+                useExisting: AXMVersionHistoryPageComponent,
+            },
+        ], usesInheritance: true, ngImport: i0, template: `
     <div class="ax-p-4 ax-min-h-[30vh] ax-overflow-y-auto">
       <axp-activity-log [activities]="activities()" [loading]="isBusy()"></axp-activity-log>
     </div>
@@ -1741,6 +1756,12 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImpor
     </div>
   `,
                     changeDetection: ChangeDetectionStrategy.OnPush,
+                    providers: [
+                        {
+                            provide: AXPPageLayoutBase,
+                            useExisting: AXMVersionHistoryPageComponent,
+                        },
+                    ],
                 }]
         }], propDecorators: { rootContext: [{ type: i0.Input, args: [{ isSignal: true, alias: "rootContext", required: true }] }], pageConfig: [{ type: i0.Input, args: [{ isSignal: true, alias: "pageConfig", required: false }] }], options: [{ type: i0.Input, args: [{ isSignal: true, alias: "options", required: false }] }] } });
 
@@ -2252,6 +2273,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,
@@ -2274,6 +2700,7 @@ const clonePlugin = {
                     priority: 'secondary',
                     type: 'copy',
                     scope: AXPEntityCommandScope.Individual,
+                    shortcuts: ['ctrl+shift+c'],
                 });
             }
             // Add clone action to single view
@@ -2291,6 +2718,7 @@ const clonePlugin = {
                     priority: 'secondary',
                     type: 'copy',
                     scope: AXPEntityCommandScope.Individual,
+                    shortcuts: ['ctrl+shift+c'],
                 });
             }
             return i;
@@ -6066,6 +6494,7 @@ class AXMMenuProvider {
                     text: '@general:terms.interface.navigation.home',
                     path: homePagePath,
                     icon: 'fa-light fa-grid-2',
+                    shortcuts: [{ keys: 'home', allowInEditableFields: false }],
                 },
                 {
                     name: 'module-divider',
@@ -6467,6 +6896,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 +6937,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 +7033,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 +7058,7 @@ class AXMCommonModule {
         ], imports: [
             //#region ----   Extension & System Plugins   ----
             AXPCategoryModule,
+            AXPCatalogScopePluginModule,
             AXMLockSystemModule,
             AXPHistoryModule,
             //#endregion
@@ -6626,6 +7098,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImpor
                     imports: [
                         //#region ----   Extension & System Plugins   ----
                         AXPCategoryModule,
+                        AXPCatalogScopePluginModule,
                         AXMLockSystemModule,
                         AXPHistoryModule,
                         //#endregion
@@ -6725,6 +7198,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,
@@ -6747,25 +7227,38 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImpor
 const AXP_GLOBAL_SEARCH_CONFIG_TOKEN = new InjectionToken('AXP_GLOBAL_SEARCH_CONFIG_TOKEN');
 
 class AXPGlobalSearchSlotComponent {
+    //#endregion
+    //#region ---- Lifecycle ----
     constructor() {
+        //#region ---- Services & Dependencies ----
         this.workflow = inject(AXPWorkflowService);
+        this.shortcutRegistry = inject(AXPKeyboardShortcutRegistry);
+        this.destroyRef = inject(DestroyRef);
+        this.searchShortcutKeys = chordToKbdItemKeys('ctrl+k');
+        this.shortcutRegistry.register({
+            owner: this.destroyRef,
+            id: 'global-search',
+            priority: AXPKeyboardShortcutPriority.Global,
+            group: '@general:keyboard-shortcuts.groups.global',
+            shortcuts: [
+                {
+                    keys: ['ctrl+k'],
+                    title: '@general:keyboard-shortcuts.actions.global-search',
+                    allowInEditableFields: true,
+                    handler: () => {
+                        void this.startSearch();
+                    },
+                },
+            ],
+        });
     }
+    //#endregion
+    //#region ---- UI Handlers ----
     async startSearch() {
         await this.workflow.execute('global-search');
     }
-    async handleKeyboardEvent(event) {
-        if (event.ctrlKey) {
-            switch (event.code) {
-                case 'KeyK':
-                    event.preventDefault();
-                    event.stopPropagation();
-                    await this.startSearch();
-                    break;
-            }
-        }
-    }
     static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPGlobalSearchSlotComponent, deps: [], target: i0.ɵɵFactoryTarget.Component }); }
-    static { this.ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "21.2.9", type: AXPGlobalSearchSlotComponent, isStandalone: true, selector: "ng-component", host: { listeners: { "document:keydown": "handleKeyboardEvent($event)" } }, ngImport: i0, template: `
+    static { this.ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "21.2.9", type: AXPGlobalSearchSlotComponent, isStandalone: true, selector: "ng-component", ngImport: i0, template: `
     <ax-button color="primary" class="ax-flex md:ax-hidden" (onClick)="startSearch()">
       <ax-icon class="fa-regular fa-search">
       </ax-icon>
@@ -6775,9 +7268,11 @@ class AXPGlobalSearchSlotComponent {
       <i class="fa-light fa-search ax-text-xl"></i>
       <span>{{ '@global-search:terms.search-placeholder' | translate | async}}</span>
       </div>
-      <kbd class="ax-text-sm">Ctrl+K</kbd>
+      <ax-kbd class="look-text">
+        <ax-kbd-item [keys]="searchShortcutKeys"></ax-kbd-item>
+      </ax-kbd>
     </div>
-  `, isInline: true, dependencies: [{ kind: "ngmodule", type: AXButtonModule }, { kind: "component", type: i2.AXButtonComponent, selector: "ax-button", inputs: ["disabled", "size", "tabIndex", "color", "look", "text", "toggleable", "selected", "iconOnly", "type", "loadingText"], outputs: ["onBlur", "onFocus", "onClick", "selectedChange", "toggleableChange", "lookChange", "colorChange", "disabledChange", "loadingTextChange"] }, { kind: "ngmodule", type: AXDecoratorModule }, { kind: "component", type: i1$1.AXDecoratorIconComponent, selector: "ax-icon", inputs: ["icon"] }, { kind: "ngmodule", type: AXTranslationModule }, { kind: "ngmodule", type: AXTextBoxModule }, { kind: "pipe", type: i4.AXTranslatorPipe, name: "translate" }, { kind: "pipe", type: AsyncPipe, name: "async" }], changeDetection: i0.ChangeDetectionStrategy.OnPush }); }
+  `, isInline: true, dependencies: [{ kind: "ngmodule", type: AXButtonModule }, { kind: "component", type: i2.AXButtonComponent, selector: "ax-button", inputs: ["disabled", "size", "tabIndex", "color", "look", "text", "toggleable", "selected", "iconOnly", "type", "loadingText"], outputs: ["onBlur", "onFocus", "onClick", "selectedChange", "toggleableChange", "lookChange", "colorChange", "disabledChange", "loadingTextChange"] }, { kind: "ngmodule", type: AXDecoratorModule }, { kind: "component", type: i1$1.AXDecoratorIconComponent, selector: "ax-icon", inputs: ["icon"] }, { kind: "component", type: AXKBDComponent, selector: "ax-kbd", inputs: ["look"] }, { kind: "component", type: AXKBDItemComponent, selector: "ax-kbd-item", inputs: ["keys", "join", "look"], outputs: ["lookChange"] }, { kind: "ngmodule", type: AXTranslationModule }, { kind: "ngmodule", type: AXTextBoxModule }, { kind: "pipe", type: i4.AXTranslatorPipe, name: "translate" }, { kind: "pipe", type: AsyncPipe, name: "async" }], changeDetection: i0.ChangeDetectionStrategy.OnPush }); }
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPGlobalSearchSlotComponent, decorators: [{
             type: Component,
@@ -6792,16 +7287,15 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImpor
       <i class="fa-light fa-search ax-text-xl"></i>
       <span>{{ '@global-search:terms.search-placeholder' | translate | async}}</span>
       </div>
-      <kbd class="ax-text-sm">Ctrl+K</kbd>
+      <ax-kbd class="look-text">
+        <ax-kbd-item [keys]="searchShortcutKeys"></ax-kbd-item>
+      </ax-kbd>
     </div>
   `,
-                    imports: [AXButtonModule, AXDecoratorModule, AXTranslationModule, AXTextBoxModule, AsyncPipe],
+                    imports: [AXButtonModule, AXDecoratorModule, AXKBDComponent, AXKBDItemComponent, AXTranslationModule, AXTextBoxModule, AsyncPipe],
                     changeDetection: ChangeDetectionStrategy.OnPush,
                 }]
-        }], propDecorators: { handleKeyboardEvent: [{
-                type: HostListener,
-                args: ['document:keydown', ['$event']]
-            }] } });
+        }], ctorParameters: () => [] });
 
 class AXPGlobalSearchStartAction extends AXPWorkflowAction {
     constructor() {
@@ -7118,5 +7612,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