@acorex/modules 21.0.0-next.37 → 21.0.0-next.40

package/fesm2022/acorex-modules-common.mjs

@@ -202,26 +202,12 @@ const AXPWidgetsList = {
     },
     Theme: {
         ThemeColorChooser: 'theme-color-chooser',
-        ThemePaletteChooser: 'theme-palette-chooser',
         // ThemeModeChooser: 'theme-mode-chooser',
         IconChooser: 'icon-chooser',
         FontSizeChooser: 'font-size-chooser',
         FontStyleChooser: 'font-style-chooser',
         // MenuOrientationChooser: 'menu-orientation-chooser',
     },
-    // Dashboard: {
-    //   Weather: 'weather',
-    //   StickyNote: 'sticky-note',
-    //   LineChart: 'line-chart',
-    //   BarChart: 'bar-chart',
-    //   DonutChart: 'donut-chart',
-    //   GaugeChart: 'gauge-chart',
-    //   AnalogClock: 'analog-clock',
-    //   ClockCalendar: 'clock-calendar',
-    //   DashboardShortcut: 'dashboard-shortcut',
-    //   TaskBoard: 'task-board',
-    //   MyNotificationDashboard: 'my-notification-dashboard',
-    // },
     // Features: {
     //   Comment: 'comment',
     //   Permissions: 'permissions',
@@ -2531,6 +2517,13 @@ const colorPlugin = {
         if (!groups.some((g) => g.id === groupId)) {
             ctx.groups.add({ id: groupId, title: `@general:terms.interface.${options?.group ?? 'appearance'}` });
         }
+        const mode = options?.mode ?? 'free';
+        const colorEditorType = mode === 'theme' ? AXPWidgetsList.Theme.ThemeColorChooser : AXPWidgetsList.Editors.ColorPalette;
+        const colorEditorOptions = mode === 'theme'
+            ? {}
+            : {
+                swatches: options?.swatches,
+            };
         const props = ctx.properties.list();
         if (!props.some((p) => p.name === 'color')) {
             ctx.properties.add({
@@ -2540,10 +2533,8 @@ const colorPlugin = {
                 schema: {
                     dataType: 'string',
                     interface: {
-                        type: AXPWidgetsList.Editors.ColorPalette,
-                        options: {
-                            swatches: options?.swatches,
-                        },
+                        type: colorEditorType,
+                        options: colorEditorOptions,
                     },
                 },
                 validations: [],
@@ -5073,7 +5064,8 @@ const namePlugin = {
                 layout.properties.push({
                     name: 'name',
                     layout: {
-                        positions: { lg: { colSpan: 12, order: 10 } },
+                        // Width is applied by layout-ordering middleware (4+8 with title on md/lg).
+                        positions: { lg: { order: 10 } },
                     },
                 });
             }
@@ -5358,6 +5350,26 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImpor
                 }]
         }] });
 
+//#region ---- Imports ----
+//#endregion
+//#region ---- Primary plugin resolution ----
+/**
+ * Field name of the status plugin that drives list columns, generated views, and single-page status.
+ */
+function resolvePrimaryStatusField(entity) {
+    const entries = (entity.plugins ?? []).filter((p) => p.name === 'status');
+    if (entries.length === 0) {
+        return null;
+    }
+    const explicit = entries.find((e) => e.options?.isPrimary === true);
+    const chosen = explicit ??
+        entries.find((e) => e.options?.isPrimary !== false) ??
+        entries[0];
+    const opts = chosen.options;
+    return opts?.field ?? 'statusId';
+}
+//#endregion
+//#region ---- Plugin ----
 const statusPlugin = {
     name: 'status',
     order: 70,
@@ -5367,14 +5379,12 @@ const statusPlugin = {
         const statusService = runInInjectionContext(injector, () => inject(AXPStatusDefinitionProviderService));
         let statusProvider;
         if (config.definition && typeof config.definition === 'string') {
-            // Get provider by key from service
             statusProvider = await statusService.getStatus(config.definition);
             if (!statusProvider) {
                 console.warn(`Status provider with key "${config.definition}" not found.`);
             }
         }
         else if (config.definition && typeof config.definition === 'object') {
-            // Direct provider object provided
             statusProvider = {
                 key: `custom.${config.field ?? 'statusId'}`,
                 statuses: config.definition.statuses,
@@ -5382,40 +5392,51 @@ const statusPlugin = {
                 defaultStatus: config.definition.defaultStatus,
             };
         }
-        // If no status provider found, return early
         if (!statusProvider) {
             console.warn('No status provider found. Please provide a valid definition key or provider object.');
             return;
         }
-        //#region ----   Add Status Group   ----
-        const groupId = 'status';
+        const fieldName = config.field ?? 'statusId';
+        const primaryField = resolvePrimaryStatusField(ctx.entity) ?? fieldName;
+        const isThisPrimary = fieldName === primaryField;
+        const groupId = config.groupId ?? 'status';
+        const label = config.title ?? '@general:terms.status.title';
+        //#region ---- Add status group ----
         const groups = ctx.groups.list() ?? [];
         if (!groups.some((g) => g.id === groupId)) {
             ctx.groups.add({ id: groupId, title: '@general:terms.status.title' });
         }
         //#endregion
-        //#region ----   Add Status Property   ----
-        const fieldName = config.field ?? 'statusId';
+        //#region ---- Add status property ----
         const generateOptions = config.generate ?? {};
         const viewsGenerateConfig = generateOptions.views ?? {};
-        const required = config.required !== false;
         const showInCreate = config.showInCreate !== false;
+        const isReadonly = config.readonly === true;
+        /** Readonly fields are never required; hidden-on-create status is filled by backend middleware. */
+        const required = !isReadonly && showInCreate;
         const defaultStatus = config.defaultStatus ?? statusProvider.defaultStatus ?? statusProvider.statuses?.[0]?.name ?? null;
-        const shouldGenerateViews = viewsGenerateConfig.enabled !== false;
+        const shouldGenerateViews = isThisPrimary && viewsGenerateConfig.enabled !== false;
         const props = ctx.properties.list();
         if (!props.some((p) => p.name === fieldName)) {
+            const widgetOptions = {
+                definitionKey: statusProvider.key,
+                /** Full entity key for default `Entity:UpdateStatus` (e.g. `SecurityManagement.User`). */
+                entityName: `${ctx.entity.module}.${ctx.entity.name}`,
+                statusField: fieldName,
+            };
+            if (isReadonly) {
+                widgetOptions['readonly'] = true;
+            }
             ctx.properties.add({
                 name: fieldName,
-                title: '@general:terms.status.title',
+                title: label,
                 groupId,
                 schema: {
                     dataType: 'string',
                     defaultValue: defaultStatus,
                     interface: {
                         type: AXPWidgetsList.Advanced.Status,
-                        options: {
-                            definitionKey: statusProvider.key,
-                        },
+                        options: widgetOptions,
                     },
                 },
                 validations: required ? [{ rule: 'required' }] : [],
@@ -5428,7 +5449,6 @@ const statusPlugin = {
                 },
             });
         }
-        // Exclude status from create form when showInCreate is false
         if (!showInCreate) {
             ctx.interfaces.master.create.update((create) => {
                 const next = {
@@ -5440,39 +5460,30 @@ const statusPlugin = {
             });
         }
         //#endregion
-        //#region ----   Update Interface Layouts   ----
-        // Add status to update view
-        // ctx.interfaces.master.modify.update((update) => {
-        //     const next = cloneLayoutArrays((update ?? { sections: [], properties: [] }) as any);
-        //     ensureLayoutSection(next, { id: groupId } as any);
-        //     ensureLayoutPropertyView(next, { name: fieldName, layout: { positions: { lg: { colSpan: 6 } } } } as any);
-        //     return next;
-        // });
-        // // Add status to single view
-        // ctx.interfaces.master.single.update((single) => {
-        //     const next = cloneLayoutArrays((single ?? { title: ctx.entity.title, sections: [], properties: [] }) as any);
-        //     ensureLayoutSection(next, { id: groupId } as any);
-        //     ensureLayoutPropertyView(next, { name: fieldName, layout: { positions: { lg: { colSpan: 6 } } } } as any);
-        //     return next;
-        // });
-        // Add status to list view columns
-        const columns = ctx.columns.list() ?? [];
-        if (!columns.some((c) => c.name === fieldName)) {
-            ctx.columns.add({
-                name: fieldName,
-                title: '@general:terms.status.title',
-                width: 120,
-                sortable: true,
-                filterable: true,
-                options: {
+        //#region ---- List column (primary only) ----
+        if (isThisPrimary) {
+            const columns = ctx.columns.list() ?? [];
+            if (!columns.some((c) => c.name === fieldName)) {
+                const colOptions = {
                     definitionKey: statusProvider.key,
                     entity: `${ctx.entity.module}.${ctx.entity.name}`,
                     fieldName: fieldName,
-                },
-            });
+                };
+                if (isReadonly) {
+                    colOptions['readonly'] = true;
+                }
+                ctx.columns.add({
+                    name: fieldName,
+                    title: label,
+                    width: 120,
+                    sortable: true,
+                    filterable: true,
+                    options: colOptions,
+                });
+            }
         }
         //#endregion
-        //#region ----   Generate Status Views   ----
+        //#region ---- Generated list views (primary only) ----
         if (shouldGenerateViews) {
             const statusesForViews = statusProvider.statuses.filter((status) => status.generateView);
             if (statusesForViews.length > 0) {
@@ -5588,6 +5599,7 @@ function getFinalStatuses(provider) {
 function getActiveStatuses(provider) {
     return provider.statuses;
 }
+//#endregion
 
 //#region ----   Task Status Provider   ----
 /**
@@ -6139,6 +6151,22 @@ class AXPDateTimeEvaluatorScopeProvider {
             addDays: (date, days) => {
                 return this.calendarService.create(date).add('day', days).date;
             },
+            duration: (startDate, endDate, unit = 'days') => {
+                if (!startDate || !endDate) {
+                    return null;
+                }
+                try {
+                    const value = this.calendarService.create(startDate).duration(this.calendarService.create(endDate))[unit];
+                    const numericValue = Number(value);
+                    if (!Number.isFinite(numericValue)) {
+                        return null;
+                    }
+                    return Math.max(0, numericValue);
+                }
+                catch {
+                    return null;
+                }
+            },
         });
     }
 }
@@ -6176,10 +6204,15 @@ const commandMessageToastMiddleware = async (input, next) => {
         const title = result.success
             ? await translationService.translateAsync('@general:messages.generic.success.title')
             : await translationService.translateAsync('@general:messages.generic.error.title');
+        const content = typeof message === 'string'
+            ? message.startsWith('@')
+                ? await translationService.translateAsync(message)
+                : message
+            : translationService.resolve(message);
         toastService.show({
             color: color,
             title: title,
-            content: message,
+            content: content,
         });
     }
     return result;
@@ -6266,10 +6299,8 @@ const AXPCommonMenuKeys = {
     DataAndContent: 'Common:Menu:Configuration:DataAndContent',
     /** Configuration > AI Management (models, assists) */
     AiManagementConfig: 'Common:Menu:Configuration:AiManagement',
-    /** Configuration > Maintenance (failure causes, maintenance types, etc.) */
-    MaintenanceConfig: 'Common:Menu:Configuration:Maintenance',
-    /** Configuration > Asset and Maintenance Management   */
-    AssetConfig: 'Common:Menu:Configuration:AssetSetup',
+    /** Plan & Equipment (top-level menu group) */
+    PlanEquipment: 'Common:Menu:PlanEquipment',
 };
 
 class AXMMenuProvider {
@@ -6403,15 +6434,14 @@ class AXMMenuProvider {
                 },
             ]);
         }
-        // Ensure Maintenance menu exists under Configuration
-        const maintenanceConfigMenu = context.find(AXPCommonMenuKeys.MaintenanceConfig);
-        if (!maintenanceConfigMenu.exists) {
-            context.find(AXPCommonMenuKeys.Configuration).addItems([
+        const planEquipmentMenu = context.find(AXPCommonMenuKeys.PlanEquipment);
+        if (!planEquipmentMenu.exists) {
+            context.addItems([
                 {
-                    name: AXPCommonMenuKeys.MaintenanceConfig,
-                    priority: 8870,
-                    text: '@general:menus.maintenance.title',
-                    icon: 'fa-light fa-box',
+                    name: AXPCommonMenuKeys.PlanEquipment,
+                    priority: 8950,
+                    text: '@general:menus.plan-equipment.title',
+                    icon: 'fa-light fa-screwdriver-wrench',
                     type: 'menu',
                     children: [],
                 },
@@ -6459,20 +6489,6 @@ class AXMMenuProvider {
                 },
             ]);
         }
-        // Check if Maintenance menu exists, create it if not
-        // const maintenanceMenu = context.find(AXPCommonMenuKeys.Maintenance);
-        // if (!maintenanceMenu.exists) {
-        //   context.find(AXPCommonMenuKeys.Configuration).addItems([
-        //     {
-        //       name: AXPCommonMenuKeys.Maintenance,
-        //       priority: 9030,
-        //       text: '@general:menus.maintenances.title',
-        //       icon: 'fa-light fa-screwdriver-wrench',
-        //       type: 'menu',
-        //       children: [],
-        //     },
-        //   ]);
-        // }
         // Check if Help menu exists, create it if not
         const helpMenu = context.find(AXPCommonMenuKeys.Help);
         if (!helpMenu.exists) {
@@ -6487,6 +6503,27 @@ class AXMMenuProvider {
                 },
             ]);
         }
+        // const PlanEquipmentMenu = context.find(AXPCommonMenuKeys.PlanEquipmentConfig);
+        // if (!PlanEquipmentMenu.exists) {
+        //   context.addItems([
+        //     {
+        //       name: AXPCommonMenuKeys.PlanEquipmentAssets,
+        //       priority: 100090001,
+        //       text: '@general:menus.plan-equipment-assets.title',
+        //       icon: 'fa-light fa-boxes-stacked',
+        //       type: 'menu',
+        //       children: [],
+        //     },
+        //     {
+        //       name: AXPCommonMenuKeys.PlanEquipmentMaintenances,
+        //       priority: 100090001,
+        //       text: '@general:menus.plan-equipment-maintenances.title',
+        //       icon: 'fa-light fa-screwdriver-wrench',
+        //       type: 'menu',
+        //       children: [],
+        //     },
+        //   ]);
+        // }
     }
 }
 
@@ -6712,6 +6749,7 @@ const ATTACHMENTS_PAGE_COMPONENT_KEY = 'entity-attachments-page';
  * Attachments plugin.
  * - Always ensures an attachments group and property; when display is 'section' (default), adds a section to single/create/update layouts.
  * - When display is 'page', adds a page to entity.pages with ATTACHMENTS_PAGE_COMPONENT_KEY; register a page component with that key via AXP_PAGE_COMPONENT_PROVIDER.
+ * - List column and list upload action can be turned off with `showListColumn` / `showListAction` (both default true).
  * - Uses provided accept/multiple/fileEditable; others are fixed.
  */
 const attachmentsPlugin = {
@@ -6755,10 +6793,13 @@ const attachmentsPlugin = {
                 },
             });
         }
-        // Ensure column exists
-        const cols = ctx.columns.list() ?? [];
-        if (!cols?.some((c) => c.name === field)) {
-            ctx.columns.add({ name: field });
+        // Ensure column exists (optional)
+        const showListColumn = opts.showListColumn ?? true;
+        if (showListColumn) {
+            const cols = ctx.columns.list() ?? [];
+            if (!cols?.some((c) => c.name === field)) {
+                ctx.columns.add({ name: field });
+            }
         }
         if (displayMode === 'section') {
             const sectionOrder = 8;
@@ -6819,37 +6860,40 @@ const attachmentsPlugin = {
                 }
             }
         }
-        // Ensure list action to open file uploader popup exists
-        ensureListActions(ctx);
-        ctx.interfaces.update((i) => {
-            const actions = i.master.list.actions;
-            const cmdName = 'show-file-uploader-popup';
-            const actionName = `attachments-${field}`;
-            if (!actionExists(actions, cmdName, actionName)) {
-                actions.push({
-                    name: actionName,
-                    title: opts.titleKey ?? opts.label ?? '@document-management:actions.upload-files',
-                    command: {
-                        name: cmdName,
-                        options: {
-                            id: '{{ context.eval("id") }}',
-                            files: `{{ Array.isArray(context.eval("${field}")) ? context.eval("${field}") : [context.eval("${field}")] }}`,
-                            multiple: opts.multiple ?? true,
-                            accept: opts.accept ?? '.jpg,.jpeg,.png,.gif,.webp',
-                            readonly: opts['readonly'] ?? false,
-                            key: field,
-                            fileEditable: opts.fileEditable ?? true,
-                            showEditDialogAfterSelect: opts.showEditDialogAfterSelect ?? false,
-                            enableTitleDescription: opts.enableTitleDescription ?? false,
+        // Ensure list action to open file uploader popup exists (optional)
+        const showListAction = opts.showListAction ?? true;
+        if (showListAction) {
+            ensureListActions(ctx);
+            ctx.interfaces.update((i) => {
+                const actions = i.master.list.actions;
+                const cmdName = 'show-file-uploader-popup';
+                const actionName = `attachments-${field}`;
+                if (!actionExists(actions, cmdName, actionName)) {
+                    actions.push({
+                        name: actionName,
+                        title: opts.titleKey ?? opts.label ?? '@document-management:actions.upload-files',
+                        command: {
+                            name: cmdName,
+                            options: {
+                                id: '{{ context.eval("id") }}',
+                                files: `{{ Array.isArray(context.eval("${field}")) ? context.eval("${field}") : [context.eval("${field}")] }}`,
+                                multiple: opts.multiple ?? true,
+                                accept: opts.accept ?? '.jpg,.jpeg,.png,.gif,.webp',
+                                readonly: opts['readonly'] ?? false,
+                                key: field,
+                                fileEditable: opts.fileEditable ?? true,
+                                showEditDialogAfterSelect: opts.showEditDialogAfterSelect ?? false,
+                                enableTitleDescription: opts.enableTitleDescription ?? false,
+                            },
                         },
-                    },
-                    priority: 'secondary',
-                    type: 'upload',
-                    scope: AXPEntityCommandScope.Individual,
-                });
-            }
-            return i;
-        });
+                        priority: 'secondary',
+                        type: 'upload',
+                        scope: AXPEntityCommandScope.Individual,
+                    });
+                }
+                return i;
+            });
+        }
         // Stamp normalized config for middleware
         ctx.entity.extensions ??= {};
         ctx.entity.extensions.attachments ??= {};