@acorex/modules 20.2.4-next.0 → 20.2.4-next.2

package/fesm2022/acorex-modules-common.mjs

@@ -1,8 +1,7 @@
 import { AXPSessionService, AXP_PERMISSION_DEFINITION_PROVIDER } from '@acorex/platform/auth';
-import { AXPHomePageService, AXPSearchCommandProvider, AXPSearchService, AXPSettingService, AXPEntityCommandScope, AXPLockService, AXP_MENU_PROVIDER, AXP_SETTING_DEFINITION_PROVIDER, AXP_SEARCH_PROVIDER } from '@acorex/platform/common';
-import { AXPEntityDefinitionRegistryService, AXP_ENTITY_STORAGE_BACKEND, detectEntityChanges, ensureListActions, actionExists, AXP_ENTITY_STORAGE_MIDDLEWARE, AXP_ENTITY_ACTION_PLUGIN, AXP_ENTITY_DEFINITION_LOADER } from '@acorex/platform/layout/entity';
+import { AXPHomePageService, AXPSearchCommandProvider, AXPSearchService, AXPSettingService, AXPEntityCommandScope, AXPLockService, createAllQueryView, AXPEntityQueryType, AXP_MENU_PROVIDER, AXP_SETTING_DEFINITION_PROVIDER, AXP_SEARCH_PROVIDER } from '@acorex/platform/common';
 import * as i0 from '@angular/core';
-import { inject, Injector, Injectable, input, signal, ViewEncapsulation, Component, NgModule, InjectionToken, HostListener, computed, viewChild } from '@angular/core';
+import { inject, Injectable, input, signal, ViewEncapsulation, Component, NgModule, InjectionToken, HostListener, computed, Injector, runInInjectionContext, viewChild } from '@angular/core';
 import { firstValueFrom, Subject } from 'rxjs';
 import * as i1$2 from '@acorex/platform/core';
 import { objectKeyValueTransforms, AXPPlatformScope, AXPActivityLogService, AXPSystemActionType, extractTextFromHtml, AXPDataGenerator, AXP_EXPRESSION_EVALUATOR_SCOPE_PROVIDER } from '@acorex/platform/core';
@@ -10,22 +9,24 @@ import * as i4 from '@acorex/core/translation';
 import { AXTranslationService, AXTranslationModule } from '@acorex/core/translation';
 import { AXPWidgetsCatalog } from '@acorex/platform/layout/builder';
 import { AXPWidgetsModule } from '@acorex/platform/widgets';
-import * as i1 from '@angular/common';
+import * as i3 from '@angular/common';
 import { CommonModule } from '@angular/common';
 import * as i2 from '@acorex/components/button';
 import { AXButtonModule } from '@acorex/components/button';
 import { AXBasePageComponent } from '@acorex/components/page';
-import * as i3 from '@acorex/components/decorators';
+import * as i1 from '@acorex/components/decorators';
 import { AXDecoratorModule } from '@acorex/components/decorators';
 import * as i2$1 from '@acorex/platform/layout/components';
-import { AXPCompareViewComponent, AXPComponentSlotModule } from '@acorex/platform/layout/components';
+import { AXPCompareViewComponent, AXPComponentSlotModule, AXP_EXTRA_PROPERTY_TYPES } from '@acorex/platform/layout/components';
 import * as i1$1 from '@acorex/platform/workflow';
 import { AXPWorkflowAction, AXPWorkflowModule, AXPWorkflowService } from '@acorex/platform/workflow';
 import { AXPopupService } from '@acorex/components/popup';
+import { AXPEntityDefinitionRegistryService, AXP_ENTITY_STORAGE_BACKEND, detectEntityChanges, ensureListActions, actionExists, AXP_ENTITY_STORAGE_MIDDLEWARE, AXP_ENTITY_ACTION_PLUGIN, AXMEntityCrudServiceImpl, entityMasterCrudActions, entityMasterDeleteAction, AXP_ENTITY_DEFINITION_LOADER } from '@acorex/platform/layout/entity';
 import { AXFormatService } from '@acorex/core/format';
 import { AXTextBoxModule } from '@acorex/components/text-box';
 import { AXCalendarService } from '@acorex/core/date-time';
 import { AXDialogService } from '@acorex/components/dialog';
+import { provideCommandSetups } from '@acorex/platform/runtime';
 import * as i1$3 from '@angular/forms';
 import { FormsModule } from '@angular/forms';
 import * as i4$1 from '@acorex/components/form';
@@ -52,31 +53,6 @@ const RootConfig = {
     entities: {},
 };
 
-class AXMEntityProvider {
-    constructor() {
-        this.injector = inject(Injector);
-    }
-    preload() {
-        const module = RootConfig.module.name;
-        return Array.from(Object.values(RootConfig.entities)).map((entity) => ({
-            module: module,
-            entity: entity.name,
-        }));
-    }
-    async get(moduleName, entityName) {
-        if (moduleName == RootConfig.module.name) {
-            switch (entityName) {
-            }
-        }
-        return null;
-    }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.1.6", ngImport: i0, type: AXMEntityProvider, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
-    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.1.6", ngImport: i0, type: AXMEntityProvider }); }
-}
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.1.6", ngImport: i0, type: AXMEntityProvider, decorators: [{
-            type: Injectable
-        }] });
-
 class AXMMenuProvider {
     constructor() {
         this.sessionService = inject(AXPSessionService);
@@ -217,9 +193,9 @@ class AXPComparePopupComponent extends AXBasePageComponent {
                 // Angular
                 CommonModule }, { kind: "ngmodule", type: 
                 // ACoreX
-                AXDecoratorModule }, { kind: "component", type: i3.AXDecoratorGenericComponent, selector: "ax-footer, ax-header, ax-content, ax-divider, ax-form-hint, ax-prefix, ax-suffix, ax-text, ax-title, ax-subtitle, ax-placeholder, ax-overlay" }, { 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: AXTranslationModule }, { kind: "component", type: 
+                AXDecoratorModule }, { kind: "component", type: i1.AXDecoratorGenericComponent, selector: "ax-footer, ax-header, ax-content, ax-divider, ax-form-hint, ax-prefix, ax-suffix, ax-text, ax-title, ax-subtitle, ax-placeholder, ax-overlay" }, { 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: AXTranslationModule }, { kind: "component", type: 
                 // Compare View
-                AXPCompareViewComponent, selector: "axp-compare-view", inputs: ["inputs", "mode"] }, { kind: "pipe", type: i1.AsyncPipe, name: "async" }, { kind: "pipe", type: i4.AXTranslatorPipe, name: "translate" }], encapsulation: i0.ViewEncapsulation.None }); }
+                AXPCompareViewComponent, selector: "axp-compare-view", inputs: ["inputs", "mode"] }, { kind: "pipe", type: i3.AsyncPipe, name: "async" }, { kind: "pipe", type: i4.AXTranslatorPipe, name: "translate" }], encapsulation: i0.ViewEncapsulation.None }); }
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.1.6", ngImport: i0, type: AXPComparePopupComponent, decorators: [{
             type: Component,
@@ -472,7 +448,7 @@ class AXPGlobalSearchSlotComponent {
       </div>
       <kbd class="ax-text-sm">Ctrl+K</kbd>
     </div>
-  `, isInline: true, dependencies: [{ kind: "ngmodule", type: CommonModule }, { 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: i3.AXDecoratorIconComponent, selector: "ax-icon", inputs: ["icon"] }, { kind: "ngmodule", type: AXTranslationModule }, { kind: "directive", type: i4.AXTranslatorDirective, selector: "[translate]" }, { kind: "ngmodule", type: AXTextBoxModule }, { kind: "pipe", type: i1.AsyncPipe, name: "async" }] }); }
+  `, isInline: true, dependencies: [{ kind: "ngmodule", type: CommonModule }, { 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.AXDecoratorIconComponent, selector: "ax-icon", inputs: ["icon"] }, { kind: "ngmodule", type: AXTranslationModule }, { kind: "directive", type: i4.AXTranslatorDirective, selector: "[translate]" }, { kind: "ngmodule", type: AXTextBoxModule }, { kind: "pipe", type: i3.AsyncPipe, name: "async" }] }); }
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.1.6", ngImport: i0, type: AXPGlobalSearchSlotComponent, decorators: [{
             type: Component,
@@ -546,7 +522,7 @@ class AXPGlobalSearchModule {
             {
                 provide: AXP_GLOBAL_SEARCH_CONFIG_TOKEN,
                 useValue: {
-                    window: () => import('./acorex-modules-common-search-popup.component-39U0-TIj.mjs').then((c) => c.AXPGlobalSearchPopupComponent),
+                    window: () => import('./acorex-modules-common-search-popup.component-BSQyjDKA.mjs').then((c) => c.AXPGlobalSearchPopupComponent),
                 },
             },
         ], imports: [AXPComponentSlotModule.forChild({
@@ -597,7 +573,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.1.6", ngImpor
                         {
                             provide: AXP_GLOBAL_SEARCH_CONFIG_TOKEN,
                             useValue: {
-                                window: () => import('./acorex-modules-common-search-popup.component-39U0-TIj.mjs').then((c) => c.AXPGlobalSearchPopupComponent),
+                                window: () => import('./acorex-modules-common-search-popup.component-BSQyjDKA.mjs').then((c) => c.AXPGlobalSearchPopupComponent),
                             },
                         },
                     ]
@@ -713,7 +689,7 @@ class AXMVersionHistoryPopupStartAction extends AXPWorkflowAction {
         this.translate = inject(AXTranslationService);
     }
     async execute(context) {
-        const comp = (await import('./acorex-modules-common-timeline-version-history-popup.component-_KJd8oGw.mjs')).AXMTimelineVersionHistoryPopupComponent;
+        const comp = (await import('./acorex-modules-common-timeline-version-history-popup.component-ByAc4Yp9.mjs')).AXMTimelineVersionHistoryPopupComponent;
         this.popupService.open(comp, {
             title: await this.translate.translateAsync('@activity-log:actions.view-history'),
             data: {
@@ -1248,9 +1224,522 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.1.6", ngImpor
                 }]
         }] });
 
+/**
+ * extra-properties plugin
+ * Options:
+ * - field: string (property name to hold the extra properties array, default: 'extraProperties')
+ * - title?: string (UI title for the field)
+ */
+const extraPropertiesPlugin = {
+    name: 'extra-properties',
+    order: 60,
+    apply: async (ctx, options) => {
+        const settingsService = inject(AXPSettingService);
+        //#region ----   Options   ----
+        const field = options?.field?.trim()?.length ? options.field : 'extraProperties';
+        const title = options?.title ?? '@extra-properties:title';
+        const mode = options?.mode ?? 'defined';
+        //#endregion
+        //#region ----   Group   ----
+        // Ensure group exists
+        const groupId = 'additional';
+        const groups = ctx.groups.list() ?? [];
+        if (!groups.some((g) => g.id === groupId)) {
+            ctx.groups.add({ id: groupId, title: '@extra-properties:title' });
+        }
+        const target = `${ctx.entity.module}.${ctx.entity.name}`;
+        const schema = mode === 'inline' ? [] :
+            (await settingsService.scope(AXPPlatformScope.Tenant).get(`extra-properties.schema.${target}`)) ?? [];
+        // Ensure property exists (uses our widget)
+        const props = ctx.properties.list();
+        if (!props.some((p) => p.name === field)) {
+            ctx.properties.add({
+                name: field,
+                title,
+                groupId,
+                schema: {
+                    dataType: 'object',
+                    interface: {
+                        type: mode === 'inline' ? 'extra-properties' : 'extra-properties-values',
+                        options: {
+                            schema,
+                        },
+                    },
+                },
+            });
+        }
+        const shared = {
+            name: 'extra-properties',
+            command: {
+                name: 'manage-extra-properties',
+                options: {
+                    target,
+                }
+            },
+            title: '@extra-properties:actions.manage',
+            type: 'update',
+            icon: 'fa-solid fa-gear',
+            priority: 'secondary',
+            permissions: ['@extra-properties:permissions.platform'],
+        };
+        ctx.interfaces.master.list.update((list) => {
+            const next = list ?? { title: ctx.entity.title, views: [] };
+            if (!next.actions) {
+                next.actions = [];
+            }
+            next.actions.push({
+                ...shared,
+                scope: AXPEntityCommandScope.TypeLevel,
+            });
+            return next;
+        });
+        // Ensure single view includes it
+        ctx.interfaces.master.single.update((single) => {
+            const next = single ?? { title: ctx.entity.title, sections: [], properties: [] };
+            next.sections = next.sections ?? [];
+            if (!next.sections.some((s) => s.id === groupId) && schema.length > 0) {
+                next.sections.push({ id: groupId });
+            }
+            next.properties = next.properties ?? [];
+            if (!next.properties.some((p) => p.name === field)) {
+                next.properties.push({
+                    name: field,
+                    layout: {
+                        positions: { lg: { colSpan: 12, order: 98 } },
+                        label: {
+                            visible: false
+                        }
+                    },
+                });
+            }
+            // Ensure action exists
+            if (mode === 'defined') {
+                next.actions = next.actions ?? [];
+                if (!next.actions.some((a) => a.name === 'extra-properties')) {
+                    next.actions.push({
+                        ...shared,
+                        scope: AXPEntityCommandScope.Individual,
+                    });
+                }
+            }
+            return next;
+        });
+        // Ensure create view includes it
+        ctx.interfaces.master.create.update((create) => {
+            const next = create ?? { sections: [], properties: [] };
+            next.sections = next.sections ?? [];
+            if (!next.sections.some((s) => s.id === groupId)) {
+                next.sections.push({ id: groupId });
+            }
+            next.properties = next.properties ?? [];
+            if (!next.properties.some((p) => p.name === field)) {
+                next.properties.push({
+                    name: field,
+                    layout: {
+                        positions: { lg: { colSpan: 12, order: 98 } },
+                        label: {
+                            visible: false
+                        }
+                    },
+                });
+            }
+            return next;
+        });
+        // Ensure update view includes it
+        ctx.interfaces.master.modify.update((modify) => {
+            const next = modify ?? { sections: [], properties: [] };
+            next.sections = next.sections ?? [];
+            if (!next.sections.some((s) => s.id === groupId)) {
+                next.sections.push({ id: groupId });
+            }
+            next.properties = next.properties ?? [];
+            if (!next.properties.some((p) => p.name === field)) {
+                next.properties.push({
+                    name: field,
+                    layout: {
+                        positions: { lg: { colSpan: 12, order: 98 } },
+                        label: {
+                            visible: false
+                        }
+                    },
+                });
+            }
+            return next;
+        });
+    },
+};
+
+const AXPWidgetsList = {
+    Editors: {
+        DocumentAttachment: 'document-attachment-editor',
+        TagBox: 'tagable-editor',
+        CheckBox: 'checkbox-editor',
+        ColorBox: 'color-editor',
+        DateTimeBox: 'date-time-editor',
+        Direction: 'direction',
+        LargeTextBox: 'large-text-editor',
+        NumberBox: 'number-editor',
+        UnitValueBox: 'number-unit-editor',
+        PasswordBox: 'password-editor',
+        QueryBuilder: 'query-builder-editor',
+        RichText: 'rich-text-editor',
+        SelectBox: 'select-editor',
+        SelectionList: 'selection-list-editor',
+        TextBox: 'text-editor',
+        InlineDataTable: 'table-editor',
+        ToggleSwitch: 'toggle-editor',
+        FileTypeExtension: 'file-type-extension',
+        MapBox: 'map',
+        MediaGallery: 'gallery',
+        SignatureBox: 'signature',
+        LookupBox: 'lookup-editor',
+    },
+    Layouts: {
+        BlockLayout: 'block-layout',
+        RepeaterLayout: 'repeater-layout',
+        TextBlockLayout: 'text-block-layout',
+        FormField: 'form-field',
+    },
+    Actions: {
+        ActionButton: 'button-action',
+    },
+    Advanced: {
+        QRCode: 'qrcode',
+    },
+    Templates: {
+        Designer: 'template-designer',
+    },
+};
+
+const AXP_EXTRA_PROPERTY_TYPES_DEFAULT = [
+    { id: AXPWidgetsList.Editors.TextBox, title: 'Text' },
+    { id: AXPWidgetsList.Editors.CheckBox, title: 'Checkbox' },
+    { id: AXPWidgetsList.Editors.ToggleSwitch, title: 'Toggle' },
+    { id: AXPWidgetsList.Editors.NumberBox, title: 'Number' },
+    { id: AXPWidgetsList.Editors.DateTimeBox, title: 'Date', defaultOptions: { format: 'date' } },
+    { id: AXPWidgetsList.Editors.DateTimeBox, title: 'DateTime', defaultOptions: { format: 'datetime' } },
+    { id: AXPWidgetsList.Editors.DateTimeBox, title: 'Time', defaultOptions: { format: 'time' } },
+    { id: AXPWidgetsList.Editors.TextBox, title: 'Email', defaultOptions: { type: 'email' } },
+    { id: AXPWidgetsList.Editors.TextBox, title: 'Phone', defaultOptions: { type: 'tel' } },
+];
+function provideExtraPropertyTypes(types) {
+    return {
+        provide: AXP_EXTRA_PROPERTY_TYPES,
+        useValue: types,
+    };
+}
+function provideDefaultExtraPropertyTypes() {
+    return provideExtraPropertyTypes(AXP_EXTRA_PROPERTY_TYPES_DEFAULT);
+}
+
+class AXPExtraPropertiesModule {
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.1.6", ngImport: i0, type: AXPExtraPropertiesModule, deps: [], target: i0.ɵɵFactoryTarget.NgModule }); }
+    static { this.ɵmod = i0.ɵɵngDeclareNgModule({ minVersion: "14.0.0", version: "20.1.6", ngImport: i0, type: AXPExtraPropertiesModule }); }
+    static { this.ɵinj = i0.ɵɵngDeclareInjector({ minVersion: "12.0.0", version: "20.1.6", ngImport: i0, type: AXPExtraPropertiesModule, providers: [
+            { provide: AXP_ENTITY_ACTION_PLUGIN, multi: true, useValue: extraPropertiesPlugin },
+            //
+            provideDefaultExtraPropertyTypes(),
+            //
+            provideCommandSetups([{
+                    key: 'manage-extra-properties',
+                    command: () => import('./acorex-modules-common-manage-extra-properties.command-DqdhTfLD.mjs').then(m => m.AXPManageExtraPropertiesCommand),
+                }]),
+        ] }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.1.6", ngImport: i0, type: AXPExtraPropertiesModule, decorators: [{
+            type: NgModule,
+            args: [{
+                    providers: [
+                        { provide: AXP_ENTITY_ACTION_PLUGIN, multi: true, useValue: extraPropertiesPlugin },
+                        //
+                        provideDefaultExtraPropertyTypes(),
+                        //
+                        provideCommandSetups([{
+                                key: 'manage-extra-properties',
+                                command: () => import('./acorex-modules-common-manage-extra-properties.command-DqdhTfLD.mjs').then(m => m.AXPManageExtraPropertiesCommand),
+                            }]),
+                    ],
+                }]
+        }] });
+
+const categoryPlugin = {
+    name: 'category',
+    order: 45,
+    apply: (ctx, options) => {
+        const moduleName = ctx.entity.module;
+        const baseEntityName = ctx.entity.name;
+        const categoryEntityName = `${baseEntityName}Category`;
+        const propertyName = options?.propertyName?.trim()?.length ? options.propertyName : 'categoryIds';
+        const allowMultiple = options?.allowMultiple ?? true;
+        // Ensure group exists (prefer basic-info)
+        const groups = ctx.groups.list() ?? [];
+        const hasBasic = groups.some((g) => g.id === 'basic-info');
+        if (!hasBasic) {
+            ctx.groups.add({ id: 'basic-info', title: '@general:terms.basic-info' });
+        }
+        ctx.columns.add({ name: 'categoryIds', options: { dataPath: 'categories' } });
+        // Ensure property exists
+        const props = ctx.properties.list();
+        if (!props.some((p) => p.name === propertyName)) {
+            ctx.properties.add({
+                name: propertyName,
+                title: '@general:terms.category.plural',
+                groupId: 'basic-info',
+                schema: {
+                    dataType: 'string',
+                    interface: {
+                        type: AXPWidgetsList.Editors.LookupBox,
+                        options: {
+                            entity: `${moduleName}.${categoryEntityName}`,
+                            multiple: allowMultiple,
+                            expose: [
+                                { source: 'id', target: 'categories.{id}' },
+                                { source: 'title', target: 'categories.{title}' },
+                            ],
+                        },
+                    },
+                },
+            });
+        }
+        // Ensure category sidebar/filter block
+        ctx.category.update((cat) => {
+            return {
+                entity: `${moduleName}.${categoryEntityName}`,
+                title: '@general:terms.category.plural',
+                textField: 'title',
+                valueField: 'id',
+                applyConditions: [
+                    {
+                        name: propertyName,
+                        operator: { type: 'contains' },
+                        value: 'id',
+                    },
+                ],
+            };
+        });
+        // Ensure layout includes property in create/modify/single
+        const ensureLayoutProperty = (layout) => {
+            layout.sections = layout.sections ?? [];
+            if (!layout.sections.some((s) => s.id === 'basic-info')) {
+                layout.sections.push({ id: 'basic-info' });
+            }
+            layout.properties = layout.properties ?? [];
+            if (!layout.properties.some((p) => p.name === propertyName)) {
+                layout.properties.push({
+                    name: propertyName,
+                    layout: {
+                        positions: { lg: { colSpan: 12, order: 12 } },
+                    },
+                });
+            }
+            return layout;
+        };
+        ctx.interfaces.master.create.update((create) => ensureLayoutProperty(create ?? { sections: [], properties: [] }));
+        ctx.interfaces.master.modify.update((modify) => ensureLayoutProperty(modify ?? { sections: [], properties: [] }));
+        ctx.interfaces.master.single.update((single) => ensureLayoutProperty(single ?? { title: ctx.entity.title, sections: [], properties: [] }));
+        // Mark extension for dynamic category entity generation
+        ctx.entity.extensions ??= {};
+        ctx.entity.extensions.category = {
+            entity: `${moduleName}.${categoryEntityName}`,
+            propertyName,
+            allowMultiple,
+        };
+    },
+};
+
+class AXMEntityCategoryProvider {
+    constructor() {
+        this.injector = inject(Injector);
+    }
+    preload() {
+        return [];
+    }
+    async get(moduleName, entityName) {
+        // Generic per-entity Category provider (works for any module)
+        if (entityName.endsWith('Category')) {
+            const fullKey = `${moduleName}.${entityName}`;
+            const dataService = runInInjectionContext(this.injector, () => new AXMEntityCrudServiceImpl(fullKey));
+            const entityDef = {
+                module: moduleName,
+                name: entityName,
+                parentKey: 'parentId',
+                plugins: [
+                // { name: 'history' },
+                // { name: 'lock' },
+                // { name: 'compare' },
+                ],
+                source: '',
+                title: '@general:terms.category.individual',
+                formats: {
+                    individual: '@general:terms.category.individual',
+                    plural: '@general:terms.category.plural',
+                    searchResult: {
+                        title: '{{ title }}',
+                        description: '{{ module }}',
+                    },
+                },
+                relatedEntities: [],
+                groups: [
+                    { id: 'basic-info', title: '@general:terms.basic-info' },
+                ],
+                properties: [
+                    {
+                        name: 'title',
+                        title: '@general:terms.title',
+                        groupId: 'basic-info',
+                        options: {
+                            sort: { enabled: true },
+                            filter: { advance: { enabled: true }, inline: { enabled: true } },
+                        },
+                        schema: { dataType: 'string', interface: { type: AXPWidgetsCatalog.text } },
+                        validations: [{ rule: 'required' }],
+                    },
+                    {
+                        name: 'parentId',
+                        title: '@general:terms.parent-id',
+                        groupId: 'basic-info',
+                        schema: {
+                            dataType: 'string',
+                            interface: {
+                                type: AXPWidgetsList.Editors.LookupBox,
+                                options: { entity: `${moduleName}.${entityName}` },
+                            },
+                        },
+                    },
+                    {
+                        name: 'description',
+                        title: '@general:terms.description',
+                        groupId: 'basic-info',
+                        schema: { dataType: 'string', interface: { type: AXPWidgetsCatalog.largeText } },
+                    },
+                ],
+                columns: [{ name: 'title' }, { name: 'description' }],
+                commands: {
+                    create: { execute: async (data) => ({ id: await dataService.insertOne(data) }) },
+                    delete: { execute: async (id) => dataService.deleteOne(id) },
+                    update: { execute: async (data) => dataService.updateOne(data.id, data) },
+                },
+                queries: {
+                    byKey: { execute: async (id) => dataService.getOne(id), type: AXPEntityQueryType.Single },
+                    list: {
+                        execute: async (e) => {
+                            const res = await dataService.query(e);
+                            // enrich hasChild for tree views if childCount is available
+                            return {
+                                items: res.items.map((item) => ({ ...item, hasChild: (item.childCount ?? 0) > 0 })),
+                                total: res.total,
+                            };
+                        },
+                        type: AXPEntityQueryType.List,
+                    },
+                },
+                interfaces: {
+                    master: {
+                        create: {
+                            sections: [{ id: 'basic-info' }],
+                            properties: [
+                                { name: 'title', layout: { positions: { lg: { colSpan: 12, order: 1 } } } },
+                                { name: 'parentId', layout: { positions: { lg: { colSpan: 12, order: 2 } } } },
+                                { name: 'description', layout: { positions: { lg: { colSpan: 12, order: 3 } } } },
+                            ],
+                        },
+                        update: {
+                            sections: [{ id: 'basic-info' }],
+                            properties: [
+                                { name: 'title', layout: { positions: { lg: { colSpan: 12, order: 1 } } } },
+                                { name: 'parentId', layout: { positions: { lg: { colSpan: 12, order: 2 } } } },
+                                { name: 'description', layout: { positions: { lg: { colSpan: 12, order: 3 } } } },
+                            ],
+                        },
+                        single: {
+                            title: '{{title}}',
+                            sections: [{ id: 'basic-info', layout: { positions: { lg: { colSpan: 12 } } } }],
+                            properties: [
+                                { name: 'title', layout: { positions: { lg: { colSpan: 12, order: 1 } } } },
+                                { name: 'parentId', layout: { positions: { lg: { colSpan: 12, order: 2 } } } },
+                                { name: 'description', layout: { positions: { lg: { colSpan: 12, order: 3 } } } },
+                            ],
+                            actions: [entityMasterDeleteAction()],
+                        },
+                        list: {
+                            actions: [...entityMasterCrudActions()],
+                            views: [createAllQueryView({ sorts: [{ name: 'title', dir: 'asc' }] })],
+                        },
+                    },
+                },
+            };
+            return entityDef;
+        }
+        return null;
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.1.6", ngImport: i0, type: AXMEntityCategoryProvider, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.1.6", ngImport: i0, type: AXMEntityCategoryProvider }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.1.6", ngImport: i0, type: AXMEntityCategoryProvider, decorators: [{
+            type: Injectable
+        }] });
+
+class AXPCategoryModule {
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.1.6", ngImport: i0, type: AXPCategoryModule, deps: [], target: i0.ɵɵFactoryTarget.NgModule }); }
+    static { this.ɵmod = i0.ɵɵngDeclareNgModule({ minVersion: "14.0.0", version: "20.1.6", ngImport: i0, type: AXPCategoryModule }); }
+    static { this.ɵinj = i0.ɵɵngDeclareInjector({ minVersion: "12.0.0", version: "20.1.6", ngImport: i0, type: AXPCategoryModule, providers: [
+            { provide: AXP_ENTITY_ACTION_PLUGIN, multi: true, useValue: categoryPlugin },
+            {
+                provide: AXP_PERMISSION_DEFINITION_PROVIDER,
+                multi: true,
+                useFactory: () => {
+                    const provider = {
+                        define: async (context) => {
+                            // Generate permissions for any entity that declared category extension
+                            // We can’t scan registry here reliably at bootstrap; rely on generic pattern per module via wildcard
+                            // Consumers can still override with module-level providers.
+                            // No-op here; permissions will be added when category entity is resolved via provideEntity elsewhere if needed.
+                        },
+                    };
+                    return provider;
+                },
+            },
+            {
+                provide: AXP_ENTITY_DEFINITION_LOADER,
+                useClass: AXMEntityCategoryProvider,
+                multi: true,
+            },
+        ] }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.1.6", ngImport: i0, type: AXPCategoryModule, decorators: [{
+            type: NgModule,
+            args: [{
+                    providers: [
+                        { provide: AXP_ENTITY_ACTION_PLUGIN, multi: true, useValue: categoryPlugin },
+                        {
+                            provide: AXP_PERMISSION_DEFINITION_PROVIDER,
+                            multi: true,
+                            useFactory: () => {
+                                const provider = {
+                                    define: async (context) => {
+                                        // Generate permissions for any entity that declared category extension
+                                        // We can’t scan registry here reliably at bootstrap; rely on generic pattern per module via wildcard
+                                        // Consumers can still override with module-level providers.
+                                        // No-op here; permissions will be added when category entity is resolved via provideEntity elsewhere if needed.
+                                    },
+                                };
+                                return provider;
+                            },
+                        },
+                        {
+                            provide: AXP_ENTITY_DEFINITION_LOADER,
+                            useClass: AXMEntityCategoryProvider,
+                            multi: true,
+                        },
+                    ],
+                }]
+        }] });
+
 class AXMCommonModule {
     static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.1.6", ngImport: i0, type: AXMCommonModule, deps: [], target: i0.ɵɵFactoryTarget.NgModule }); }
     static { this.ɵmod = i0.ɵɵngDeclareNgModule({ minVersion: "14.0.0", version: "20.1.6", ngImport: i0, type: AXMCommonModule, imports: [AXMLockSystemModule,
+            AXPExtraPropertiesModule,
+            AXPCategoryModule,
             AXPGlobalSearchModule,
             AXPWidgetsModule,
             AXPVersionHistoryModule,
@@ -1261,11 +1750,6 @@ class AXMCommonModule {
                 useClass: AXMMenuProvider,
                 multi: true,
             },
-            {
-                provide: AXP_ENTITY_DEFINITION_LOADER,
-                useClass: AXMEntityProvider,
-                multi: true,
-            },
             {
                 provide: AXP_SETTING_DEFINITION_PROVIDER,
                 useClass: AXMSettingProvider,
@@ -1292,6 +1776,8 @@ class AXMCommonModule {
                 multi: true,
             },
         ], imports: [AXMLockSystemModule,
+            AXPExtraPropertiesModule,
+            AXPCategoryModule,
             AXPGlobalSearchModule,
             AXPWidgetsModule,
             AXPVersionHistoryModule,
@@ -1302,6 +1788,8 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.1.6", ngImpor
             args: [{
                     imports: [
                         AXMLockSystemModule,
+                        AXPExtraPropertiesModule,
+                        AXPCategoryModule,
                         AXPGlobalSearchModule,
                         AXPWidgetsModule,
                         AXPVersionHistoryModule,
@@ -1315,11 +1803,6 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.1.6", ngImpor
                             useClass: AXMMenuProvider,
                             multi: true,
                         },
-                        {
-                            provide: AXP_ENTITY_DEFINITION_LOADER,
-                            useClass: AXMEntityProvider,
-                            multi: true,
-                        },
                         {
                             provide: AXP_SETTING_DEFINITION_PROVIDER,
                             useClass: AXMSettingProvider,
@@ -1349,48 +1832,6 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.1.6", ngImpor
                 }]
         }] });
 
-const AXPWidgetsList = {
-    Editors: {
-        DocumentAttachment: 'document-attachment-editor',
-        TagBox: 'tagable-editor',
-        CheckBox: 'checkbox-editor',
-        ColorBox: 'color-editor',
-        DateTimeBox: 'date-time-editor',
-        Direction: 'direction',
-        LargeTextBox: 'large-text-editor',
-        NumberBox: 'number-editor',
-        UnitValueBox: 'number-unit-editor',
-        PasswordBox: 'password-editor',
-        QueryBuilder: 'query-builder-editor',
-        RichText: 'rich-text-editor',
-        SelectBox: 'select-editor',
-        SelectionList: 'selection-list-editor',
-        TextBox: 'text-editor',
-        InlineDataTable: 'table-editor',
-        ToggleSwitch: 'toggle-editor',
-        FileTypeExtension: 'file-type-extension',
-        MapBox: 'map',
-        MediaGallery: 'gallery',
-        SignatureBox: 'signature',
-        LookupBox: 'lookup-editor',
-    },
-    Layouts: {
-        BlockLayout: 'block-layout',
-        RepeaterLayout: 'repeater-layout',
-        TextBlockLayout: 'text-block-layout',
-        FormField: 'form-field',
-    },
-    Actions: {
-        ActionButton: 'button-action',
-    },
-    Advanced: {
-        QRCode: 'qrcode',
-    },
-    Templates: {
-        Designer: 'template-designer',
-    },
-};
-
 class AXPLockPopupComponent extends AXBasePageComponent {
     constructor() {
         super(...arguments);
@@ -1481,7 +1922,7 @@ class AXPLockPopupComponent extends AXBasePageComponent {
                 // Angular
                 CommonModule }, { kind: "ngmodule", type: FormsModule }, { kind: "directive", type: i1$3.NgControlStatus, selector: "[formControlName],[ngModel],[formControl]" }, { kind: "directive", type: i1$3.NgModel, selector: "[ngModel]:not([formControlName]):not([formControl])", inputs: ["name", "disabled", "ngModel", "ngModelOptions"], outputs: ["ngModelChange"], exportAs: ["ngModel"] }, { kind: "ngmodule", type: 
                 // ACoreX
-                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: i3.AXDecoratorClearButtonComponent, selector: "ax-clear-button", inputs: ["icon"] }, { kind: "component", type: i3.AXDecoratorGenericComponent, selector: "ax-footer, ax-header, ax-content, ax-divider, ax-form-hint, ax-prefix, ax-suffix, ax-text, ax-title, ax-subtitle, ax-placeholder, ax-overlay" }, { kind: "ngmodule", type: AXFormModule }, { kind: "component", type: i4$1.AXFormFieldComponent, selector: "ax-form-field", inputs: ["labelMode"] }, { kind: "component", type: i4$1.AXFormComponent, selector: "ax-form", inputs: ["labelMode", "look", "messageStyle", "updateOn"], outputs: ["onValidate", "updateOnChange"] }, { kind: "directive", type: i4$1.AXValidationRuleDirective, selector: "ax-validation-rule", inputs: ["rule", "options", "message", "disabled"] }, { kind: "ngmodule", type: AXLabelModule }, { kind: "component", type: i5.AXLabelComponent, selector: "ax-label", inputs: ["required", "for"], outputs: ["requiredChange"] }, { kind: "ngmodule", type: AXSelectBoxModule }, { kind: "component", type: i6.AXSelectBoxComponent, selector: "ax-select-box", inputs: ["disabled", "readonly", "tabIndex", "placeholder", "minValue", "maxValue", "value", "state", "name", "id", "type", "look", "multiple", "valueField", "textField", "disabledField", "textTemplate", "selectedItems", "isItemTruncated", "showItemTooltip", "dataSource", "minRecordsForSearch", "caption", "itemTemplate", "selectedTemplate", "emptyTemplate", "loadingTemplate", "dropdownWidth", "searchBoxAutoFocus"], outputs: ["valueChange", "stateChange", "onValueChanged", "onBlur", "onFocus", "readonlyChange", "disabledChange", "onOpened", "onClosed"] }, { kind: "ngmodule", type: AXTextAreaModule }, { kind: "component", type: i7.AXTextAreaComponent, selector: "ax-text-area", inputs: ["disabled", "tabIndex", "readonly", "value", "state", "name", "placeholder", "maxLength", "look", "rows", "allowResize", "showCounter", "class"], outputs: ["onBlur", "onFocus", "valueChange", "stateChange", "onValueChanged", "readonlyChange", "disabledChange", "onKeyDown", "onKeyUp", "onKeyPress"] }, { kind: "ngmodule", type: AXTranslationModule }, { kind: "directive", type: i4.AXTranslatorDirective, selector: "[translate]" }, { kind: "ngmodule", type: AXValidationModule }, { kind: "pipe", type: i1.AsyncPipe, name: "async" }], encapsulation: i0.ViewEncapsulation.None }); }
+                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.AXDecoratorClearButtonComponent, selector: "ax-clear-button", inputs: ["icon"] }, { kind: "component", type: i1.AXDecoratorGenericComponent, selector: "ax-footer, ax-header, ax-content, ax-divider, ax-form-hint, ax-prefix, ax-suffix, ax-text, ax-title, ax-subtitle, ax-placeholder, ax-overlay" }, { kind: "ngmodule", type: AXFormModule }, { kind: "component", type: i4$1.AXFormFieldComponent, selector: "ax-form-field", inputs: ["labelMode"] }, { kind: "component", type: i4$1.AXFormComponent, selector: "ax-form", inputs: ["labelMode", "look", "messageStyle", "updateOn"], outputs: ["onValidate", "updateOnChange"] }, { kind: "directive", type: i4$1.AXValidationRuleDirective, selector: "ax-validation-rule", inputs: ["rule", "options", "message", "disabled"] }, { kind: "ngmodule", type: AXLabelModule }, { kind: "component", type: i5.AXLabelComponent, selector: "ax-label", inputs: ["required", "for"], outputs: ["requiredChange"] }, { kind: "ngmodule", type: AXSelectBoxModule }, { kind: "component", type: i6.AXSelectBoxComponent, selector: "ax-select-box", inputs: ["disabled", "readonly", "tabIndex", "placeholder", "minValue", "maxValue", "value", "state", "name", "id", "type", "look", "multiple", "valueField", "textField", "disabledField", "textTemplate", "selectedItems", "isItemTruncated", "showItemTooltip", "dataSource", "minRecordsForSearch", "caption", "itemTemplate", "selectedTemplate", "emptyTemplate", "loadingTemplate", "dropdownWidth", "searchBoxAutoFocus"], outputs: ["valueChange", "stateChange", "onValueChanged", "onBlur", "onFocus", "readonlyChange", "disabledChange", "onOpened", "onClosed", "onItemSelected", "onItemClick"] }, { kind: "ngmodule", type: AXTextAreaModule }, { kind: "component", type: i7.AXTextAreaComponent, selector: "ax-text-area", inputs: ["disabled", "tabIndex", "readonly", "value", "state", "name", "placeholder", "maxLength", "look", "rows", "allowResize", "showCounter", "class"], outputs: ["onBlur", "onFocus", "valueChange", "stateChange", "onValueChanged", "readonlyChange", "disabledChange", "onKeyDown", "onKeyUp", "onKeyPress"] }, { kind: "ngmodule", type: AXTranslationModule }, { kind: "directive", type: i4.AXTranslatorDirective, selector: "[translate]" }, { kind: "ngmodule", type: AXValidationModule }, { kind: "pipe", type: i3.AsyncPipe, name: "async" }], encapsulation: i0.ViewEncapsulation.None }); }
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.1.6", ngImport: i0, type: AXPLockPopupComponent, decorators: [{
             type: Component,
@@ -1510,5 +1951,5 @@ var index = /*#__PURE__*/Object.freeze({
  * Generated bundle index. Do not edit.
  */
 
-export { AXMCommonModule, AXMEntityProvider, AXMLockPopupWorkflow, AXMLockPopupWorkflowAction, AXMMenuProvider, AXMSearchCommandProvider, AXMSettingProvider, AXMUnlockConfirmWorkflow, AXMUnlockConfirmWorkflowAction, AXPGlobalSearchModule, AXPGlobalSearchViewModel, AXPLockPopupComponent, AXPVersionHistoryModule, AXPWidgetsList, AXP_GLOBAL_SEARCH_CONFIG_TOKEN, RootConfig };
+export { AXMCommonModule, AXMLockPopupWorkflow, AXMLockPopupWorkflowAction, AXMMenuProvider, AXMSearchCommandProvider, AXMSettingProvider, AXMUnlockConfirmWorkflow, AXMUnlockConfirmWorkflowAction, AXPGlobalSearchModule, AXPGlobalSearchViewModel, AXPLockPopupComponent, AXPVersionHistoryModule, AXPWidgetsList, AXP_GLOBAL_SEARCH_CONFIG_TOKEN, RootConfig };
 //# sourceMappingURL=acorex-modules-common.mjs.map