@acorex/modules 21.0.0-next.39 → 21.0.0-next.41

package/fesm2022/acorex-modules-common.mjs

@@ -202,7 +202,6 @@ const AXPWidgetsList = {
     },
     Theme: {
         ThemeColorChooser: 'theme-color-chooser',
-        ThemePaletteChooser: 'theme-palette-chooser',
         // ThemeModeChooser: 'theme-mode-chooser',
         IconChooser: 'icon-chooser',
         FontSizeChooser: 'font-size-chooser',
@@ -2518,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({
@@ -2527,10 +2533,8 @@ const colorPlugin = {
                 schema: {
                     dataType: 'string',
                     interface: {
-                        type: AXPWidgetsList.Editors.ColorPalette,
-                        options: {
-                            swatches: options?.swatches,
-                        },
+                        type: colorEditorType,
+                        options: colorEditorOptions,
                     },
                 },
                 validations: [],
@@ -5346,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,
@@ -5355,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,
@@ -5370,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' }] : [],
@@ -5416,7 +5449,6 @@ const statusPlugin = {
                 },
             });
         }
-        // Exclude status from create form when showInCreate is false
         if (!showInCreate) {
             ctx.interfaces.master.create.update((create) => {
                 const next = {
@@ -5428,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) {
@@ -5576,6 +5599,7 @@ function getFinalStatuses(provider) {
 function getActiveStatuses(provider) {
     return provider.statuses;
 }
+//#endregion
 
 //#region ----   Task Status Provider   ----
 /**
@@ -5968,6 +5992,35 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImpor
                 }]
         }] });
 
+//#endregion
+//#region ---- At least one of validation rule ----
+/**
+ * Client-side no-op for `at-least-one-of`.
+ *
+ * Custom validation rules are constructed from the validation module injector, which does not
+ * include `AXPContextStore` (that store is provided on layout/widget hosts). Resolving the store
+ * here caused NG0201 (no provider for `SignalStore`). Cross-field checks are enforced on save by
+ * `entity-validation.middleware` in `@acorex/connectivity/mock`.
+ */
+class AtLeastOneOfValidationRule {
+    get name() {
+        return 'at-least-one-of';
+    }
+    async validate(value, _options) {
+        return {
+            rule: this.name,
+            result: true,
+            message: '',
+            value,
+        };
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AtLeastOneOfValidationRule, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AtLeastOneOfValidationRule }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AtLeastOneOfValidationRule, decorators: [{
+            type: Injectable
+        }] });
+
 //#region ---- Unique Validation Rule Class ----
 /**
  * Unique Validation Rule (client-side no-op).
@@ -6081,6 +6134,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImpor
  *
  * - 'variable-name': validates variable naming conventions.
  * - 'unique': client-side no-op; uniqueness is enforced by backend (entity-validation middleware).
+ * - 'at-least-one-of': client-side no-op; cross-field check is enforced by entity-validation middleware on save.
  *
  * ```typescript
  * validations: [
@@ -6094,7 +6148,7 @@ class AXPValidationRulesModule {
     static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPValidationRulesModule, deps: [], target: i0.ɵɵFactoryTarget.NgModule }); }
     static { this.ɵmod = i0.ɵɵngDeclareNgModule({ minVersion: "14.0.0", version: "21.2.9", ngImport: i0, type: AXPValidationRulesModule, imports: [i1$4.AXValidationModule] }); }
     static { this.ɵinj = i0.ɵɵngDeclareInjector({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPValidationRulesModule, imports: [AXValidationModule.forChild({
-                rules: [VariableNameValidationRule, UniqueValidationRule],
+                rules: [VariableNameValidationRule, UniqueValidationRule, AtLeastOneOfValidationRule],
             })] }); }
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPValidationRulesModule, decorators: [{
@@ -6102,7 +6156,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImpor
             args: [{
                     imports: [
                         AXValidationModule.forChild({
-                            rules: [VariableNameValidationRule, UniqueValidationRule],
+                            rules: [VariableNameValidationRule, UniqueValidationRule, AtLeastOneOfValidationRule],
                         }),
                     ],
                     exports: [],
@@ -6127,6 +6181,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;
+                }
+            },
         });
     }
 }
@@ -6709,6 +6779,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 = {
@@ -6752,10 +6823,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;
@@ -6816,37 +6890,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 ??= {};
@@ -7266,5 +7343,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, 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, 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