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

package/types/acorex-modules-learning-management.d.ts

@@ -1,10 +1,12 @@
-import * as i0 from '@angular/core';
+import * as _angular_core from '@angular/core';
 import { Injector } from '@angular/core';
 import { AXPEntity, AXPMenuProvider, AXPMenuProviderContext, AXPSearchCommandProvider, AXPSearchResult } from '@acorex/platform/common';
-import { AXPEntityDefinitionLoader } from '@acorex/platform/layout/entity';
+import { AXPEntityDefinitionLoader, AXPEntityModel } from '@acorex/platform/layout/entity';
 import { AXPPermissionDefinitionProvider, AXPPermissionDefinitionProviderContext } from '@acorex/platform/auth';
 import * as i1 from '@acorex/platform/layout/widget-core';
-import { AXPCategoryListItem, AXPMultiLanguageString } from '@acorex/platform/core';
+import { AXPValueWidgetComponent } from '@acorex/platform/layout/widget-core';
+import { AXPSpreadsheetItem, AXPSpreadsheetData, AXPSpreadsheetCellChangeEvent, AXPSpreadsheetColumn, AXPSpreadsheetRowChangeEvent } from '@acorex/platform/layout/components';
+import { AXPMultiLanguageString, AXPCategoryListItem } from '@acorex/platform/core';
 
 declare const RootConfig: {
     config: {
@@ -124,8 +126,8 @@ declare class AXMLearningManagementEntityProvider implements AXPEntityDefinition
         name: string;
         module: string;
     }[]>;
-    static ɵfac: i0.ɵɵFactoryDeclaration<AXMLearningManagementEntityProvider, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<AXMLearningManagementEntityProvider>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXMLearningManagementEntityProvider, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXMLearningManagementEntityProvider>;
 }
 
 /**
@@ -155,8 +157,8 @@ declare class AXMLearningManagementPermissionDefinitionProvider implements AXPPe
     private readonly translationService;
     constructor(injector: Injector);
     define(context: AXPPermissionDefinitionProviderContext): Promise<void>;
-    static ɵfac: i0.ɵɵFactoryDeclaration<AXMLearningManagementPermissionDefinitionProvider, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<AXMLearningManagementPermissionDefinitionProvider>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXMLearningManagementPermissionDefinitionProvider, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXMLearningManagementPermissionDefinitionProvider>;
 }
 
 declare const AXMLearningManagementPermissionKeys: {
@@ -287,87 +289,246 @@ declare class AXMLearningManagementSearchCommandProvider extends AXPSearchComman
 }
 
 declare class AXMLearningManagementModule {
-    static ɵfac: i0.ɵɵFactoryDeclaration<AXMLearningManagementModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<AXMLearningManagementModule, never, [typeof i1.AXPWidgetCoreModule], never>;
-    static ɵinj: i0.ɵɵInjectorDeclaration<AXMLearningManagementModule>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXMLearningManagementModule, never>;
+    static ɵmod: _angular_core.ɵɵNgModuleDeclaration<AXMLearningManagementModule, never, [typeof i1.AXPWidgetCoreModule], never>;
+    static ɵinj: _angular_core.ɵɵInjectorDeclaration<AXMLearningManagementModule>;
 }
 
-interface AXMLearningManagementSkillEntityModel {
-    id: string;
-    title: string;
-    description?: string | null;
+interface AXMLearningManagementSkillEntityModel extends AXPEntityModel<string> {
+    /** Unique programmatic key for expressions and integrations (identifier-style). */
+    name: string;
+    title: AXPMultiLanguageString;
+    description?: AXPMultiLanguageString | null;
     code?: string | null;
     categoryIds: string[];
     categories?: AXPCategoryListItem[];
     relatedCourseIds?: string[];
-    createdAt?: Date;
-    updatedAt?: Date;
 }
 
-interface AXMLearningManagementSkillLevelEntityModel {
-    id: string;
-    name: string;
+declare class AXMLearningManagementSkillMatrixComponent {
+    private readonly entityService;
+    private readonly skillLevelDataAccessor;
+    private readonly skillDataAccessor;
+    private readonly skillCategoryDataAccessor;
+    private readonly entityDataSelectorService;
+    private readonly entityResolver;
+    private readonly translationService;
+    private readonly destroyRef;
+    private readonly activeLocale;
+    /**
+     * Array of job titles/positions to display as columns (e.g., Senior, Manager, Director)
+     */
+    titles: _angular_core.InputSignal<AXPSpreadsheetItem[]>;
+    /**
+     * Initial matrix data: { [skillId]: { [title.id]: skillLevelId } }
+     */
+    value: _angular_core.InputSignal<AXPSpreadsheetData>;
+    /**
+     * Whether the matrix is in readonly mode
+     */
+    readonly: _angular_core.InputSignal<boolean>;
+    /**
+     * Initial skill IDs (for syncing with parent entity)
+     */
+    skillIds: _angular_core.InputSignal<string[]>;
+    /**
+     * Emitted when the matrix value changes
+     */
+    valueChange: _angular_core.OutputEmitterRef<AXPSpreadsheetData>;
+    /**
+     * Emitted when a single cell value changes
+     */
+    cellChange: _angular_core.OutputEmitterRef<AXPSpreadsheetCellChangeEvent>;
+    /**
+     * Emitted when selected skills change (skill IDs array)
+     */
+    skillIdsChange: _angular_core.OutputEmitterRef<string[]>;
+    /**
+     * Skill levels loaded from the service
+     */
+    private skillLevels;
+    /**
+     * Selected skills (internal state)
+     */
+    protected selectedSkills: _angular_core.WritableSignal<AXMLearningManagementSkillEntityModel[]>;
+    /**
+     * Skill entity definition
+     */
+    private skillEntityDef;
+    /**
+     * Loading state
+     */
+    protected isLoading: _angular_core.WritableSignal<boolean>;
+    /**
+     * Loading state for skill entity
+     */
+    protected isLoadingSkillEntity: _angular_core.WritableSignal<boolean>;
+    /**
+     * Vertical titles (skills) - rows of the matrix
+     */
+    protected verticalTitles: _angular_core.Signal<AXPSpreadsheetItem[]>;
+    /**
+     * Horizontal titles (job titles/positions) - columns of the matrix
+     */
+    protected horizontalTitles: _angular_core.Signal<AXPSpreadsheetItem[]>;
+    /**
+     * Cell options (skill levels) - dropdown options for each cell, loaded from service
+     */
+    protected cellOptions: _angular_core.Signal<AXPSpreadsheetItem[]>;
+    /**
+     * Spreadsheet columns - converted from horizontalTitles (job titles/positions)
+     */
+    protected spreadsheetColumns: _angular_core.Signal<AXPSpreadsheetColumn[]>;
+    /**
+     * Spreadsheet rows - converted from matrix data and vertical titles
+     */
+    protected spreadsheetRows: _angular_core.Signal<Record<string, any>[]>;
+    constructor();
+    /**
+     * Load skill levels from the service
+     */
+    private loadSkillLevels;
+    /**
+     * Load skill entity definition
+     */
+    private loadSkillEntityDef;
+    /**
+     * Load skills by IDs
+     */
+    private loadSkillsByIds;
+    /**
+     * Convert spreadsheet rows back to matrix data format
+     */
+    private convertSpreadsheetRowsToMatrixData;
+    /**
+     * Handle spreadsheet change event - convert to matrix format
+     */
+    protected handleSpreadsheetChange(rows: Record<string, any>[]): void;
+    /**
+     * Handle cell change event from spreadsheet
+     */
+    protected handleCellChange(event: AXPSpreadsheetCellChangeEvent): void;
+    /**
+     * Open skill selector dialog with category filter
+     */
+    protected handleSelectSkills(): Promise<void>;
+    /**
+     * Remove a skill from selection
+     */
+    protected handleRemoveSkill(skillId: string): void;
+    /**
+     * Handle row change event from spreadsheet (add/remove)
+     */
+    protected handleRowChange(event: AXPSpreadsheetRowChangeEvent): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXMLearningManagementSkillMatrixComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXMLearningManagementSkillMatrixComponent, "axm-skill-matrix", never, { "titles": { "alias": "titles"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "skillIds": { "alias": "skillIds"; "required": false; "isSignal": true; }; }, { "valueChange": "valueChange"; "cellChange": "cellChange"; "skillIdsChange": "skillIdsChange"; }, never, never, true, never>;
+}
+
+declare class AXLSkillMatrixWidgetEditComponent extends AXPValueWidgetComponent<AXPSpreadsheetData> {
+    /**
+     * Titles from context - reactively reads from context data signal
+     * This ensures the titles update immediately when requiredLevels changes in context
+     */
+    protected titles: _angular_core.Signal<AXPSpreadsheetItem[]>;
+    /**
+     * Readonly mode from options - properly tracks options signal changes
+     */
+    protected readonly: _angular_core.Signal<boolean>;
+    /**
+     * Current matrix value - tracks getValue signal changes
+     */
+    protected matrixValue: _angular_core.Signal<AXPSpreadsheetData>;
+    /**
+     * Skill IDs extracted from matrix data keys or from options
+     */
+    protected skillIds: _angular_core.Signal<string[]>;
+    /**
+     * Handle value change from skill-matrix component
+     */
+    protected handleValueChange(data: AXPSpreadsheetData): void;
+    /**
+     * Handle skill IDs change from skill-matrix component
+     * Skill IDs are stored as keys in the matrix data, so this is mainly for tracking
+     */
+    protected handleSkillIdsChange(skillIds: string[]): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXLSkillMatrixWidgetEditComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXLSkillMatrixWidgetEditComponent, "axm-skill-matrix-widget-edit", never, {}, {}, never, never, true, never>;
+}
+
+declare class AXLSkillMatrixWidgetViewComponent extends AXPValueWidgetComponent<AXPSpreadsheetData> {
+    /**
+     * Skill IDs from options
+     */
+    protected skills: _angular_core.Signal<{
+        id: string;
+        title: string;
+        description?: string;
+    }[]>;
+    /**
+     * Current matrix value
+     */
+    protected matrixValue: _angular_core.Signal<AXPSpreadsheetData>;
+    /**
+     * Handle value change from skill-matrix component
+     */
+    protected handleValueChange(data: AXPSpreadsheetData): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXLSkillMatrixWidgetViewComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXLSkillMatrixWidgetViewComponent, "axm-skill-matrix-widget-view", never, {}, {}, never, never, true, never>;
+}
+
+interface AXMLearningManagementSkillLevelEntityModel extends AXPEntityModel<string> {
+    title: AXPMultiLanguageString;
     levelNumber: number;
-    description?: string | null;
-    createdAt?: Date;
-    updatedAt?: Date;
+    description?: AXPMultiLanguageString | null;
 }
 
-interface AXMLearningManagementCourseTypeEntityModel {
-    id: string;
-    name: string;
-    description?: string | null;
+interface AXMLearningManagementCourseTypeEntityModel extends AXPEntityModel<string> {
+    code: string;
+    title: AXPMultiLanguageString;
+    description?: AXPMultiLanguageString | null;
     deliveryMode?: string | null;
-    createdAt?: Date;
-    updatedAt?: Date;
 }
 
-interface AXMLearningManagementCourseEntityModel {
-    id: string;
+interface AXMLearningManagementCourseEntityModel extends AXPEntityModel<string> {
     code: string;
-    title: string;
-    description?: string | null;
+    title: AXPMultiLanguageString;
+    description?: AXPMultiLanguageString | null;
     courseTypeId: string;
     durationHours?: number | null;
     relatedSkillIds: string[];
     certificateDefinitionIds?: string[];
     courseType?: {
         id: string;
-        name: string;
+        title: AXPMultiLanguageString;
     };
     skills?: Array<{
         id: string;
-        title: string;
+        title: AXPMultiLanguageString;
     }>;
     certificateDefinitions?: Array<{
         id: string;
-        title: string;
+        title: AXPMultiLanguageString;
     }>;
-    createdAt?: Date;
-    updatedAt?: Date;
 }
 
-interface AXMLearningManagementTrainingTypeEntityModel {
-    id: string;
-    name: string;
-    description?: string | null;
-    createdAt?: Date;
-    updatedAt?: Date;
+interface AXMLearningManagementTrainingTypeEntityModel extends AXPEntityModel<string> {
+    code: string;
+    title: AXPMultiLanguageString;
+    description?: AXPMultiLanguageString | null;
 }
 
-interface AXMLearningManagementTrainingDefinitionEntityModel {
-    id: string;
-    title: string;
-    description?: string | null;
+interface AXMLearningManagementTrainingDefinitionEntityModel extends AXPEntityModel<string> {
+    title: AXPMultiLanguageString;
+    description?: AXPMultiLanguageString | null;
     courseId: string;
     course?: {
         id: string;
-        title: string;
+        title: AXPMultiLanguageString;
     };
     trainingTypeId: string;
     trainingType?: {
         id: string;
-        name: string;
+        title: AXPMultiLanguageString;
     };
     defaultDurationHours?: number | null;
     defaultCapacity?: number | null;
@@ -377,13 +538,10 @@ interface AXMLearningManagementTrainingDefinitionEntityModel {
         title: string;
     };
     isActive: boolean;
-    createdAt?: Date;
-    updatedAt?: Date;
 }
 
 type TrainingStatus = 'Draft' | 'Open' | 'Closed' | 'Cancelled';
-interface AXMLearningManagementTrainingEntityModel {
-    id: string;
+interface AXMLearningManagementTrainingEntityModel extends AXPEntityModel<string> {
     trainingDefinitionId: string;
     courseId: string;
     trainingTypeId: string;
@@ -393,17 +551,18 @@ interface AXMLearningManagementTrainingEntityModel {
     instructorId?: string | null;
     capacity?: number | null;
     status: TrainingStatus;
+    notes?: string | null;
     trainingDefinition?: {
         id: string;
-        title: string;
+        title: AXPMultiLanguageString;
     };
     course?: {
         id: string;
-        title: string;
+        title: AXPMultiLanguageString;
     };
     trainingType?: {
         id: string;
-        name: string;
+        title: AXPMultiLanguageString;
     };
     location?: {
         id: string;
@@ -413,32 +572,27 @@ interface AXMLearningManagementTrainingEntityModel {
         id: string;
         displayName: string;
     };
-    createdAt?: Date;
-    updatedAt?: Date;
 }
 
 type EnrollmentStatus = 'Requested' | 'Approved' | 'Enrolled' | 'Completed' | 'Failed' | 'Cancelled';
-interface AXMLearningManagementEnrollmentEntityModel {
-    id: string;
+interface AXMLearningManagementEnrollmentEntityModel extends AXPEntityModel<string> {
     employeeId: string;
     trainingId: string;
     status: EnrollmentStatus;
     workflowInstanceId?: string | null;
+    notes?: string | null;
     employee?: {
         id: string;
         displayName: string;
     };
     training?: {
         id: string;
-        title: string;
+        title: AXPMultiLanguageString;
     };
-    createdAt?: Date;
-    updatedAt?: Date;
 }
 
 type AttendanceStatus = 'Present' | 'Absent' | 'Late';
-interface AXMLearningManagementAttendanceEntityModel {
-    id: string;
+interface AXMLearningManagementAttendanceEntityModel extends AXPEntityModel<string> {
     enrollmentId: string;
     sessionDate: string;
     status: AttendanceStatus;
@@ -448,43 +602,35 @@ interface AXMLearningManagementAttendanceEntityModel {
         trainingId: string;
     };
     notes?: string | null;
-    createdAt?: Date;
-    updatedAt?: Date;
 }
 
-interface AXMLearningManagementCertificateTypeEntityModel {
-    id: string;
-    name: string;
-    description?: string | null;
+interface AXMLearningManagementCertificateTypeEntityModel extends AXPEntityModel<string> {
+    code: string;
+    title: AXPMultiLanguageString;
+    description?: AXPMultiLanguageString | null;
     validityDays?: number | null;
     templateId?: string | null;
-    createdAt?: Date;
-    updatedAt?: Date;
 }
 
-interface AXMLearningManagementCertificateDefinitionEntityModel {
-    id: string;
-    title: string;
-    description?: string | null;
+interface AXMLearningManagementCertificateDefinitionEntityModel extends AXPEntityModel<string> {
+    title: AXPMultiLanguageString;
+    description?: AXPMultiLanguageString | null;
     certificateTypeId: string;
     certificateType?: {
         id: string;
-        name: string;
+        title: AXPMultiLanguageString;
     };
     courseId?: string | null;
     course?: {
         id: string;
-        title: string;
+        title: AXPMultiLanguageString;
     };
     validityDays?: number | null;
     templateId?: string | null;
     isActive: boolean;
-    createdAt?: Date;
-    updatedAt?: Date;
 }
 
-interface AXMLearningManagementCertificateEntityModel {
-    id: string;
+interface AXMLearningManagementCertificateEntityModel extends AXPEntityModel<string> {
     certificateDefinitionId: string;
     certificateTypeId: string;
     employeeId: string;
@@ -492,13 +638,14 @@ interface AXMLearningManagementCertificateEntityModel {
     issueDate: string;
     expiryDate?: string | null;
     fileId?: string | null;
+    notes?: string | null;
     certificateDefinition?: {
         id: string;
-        title: string;
+        title: AXPMultiLanguageString;
     };
     certificateType?: {
         id: string;
-        name: string;
+        title: AXPMultiLanguageString;
     };
     employee?: {
         id: string;
@@ -506,36 +653,28 @@ interface AXMLearningManagementCertificateEntityModel {
     };
     course?: {
         id: string;
-        title: string;
+        title: AXPMultiLanguageString;
     };
-    createdAt?: Date;
-    updatedAt?: Date;
 }
 
-interface AXMLearningManagementLearningPathEntityModel {
-    id: string;
-    name: string;
-    description?: string | null;
+interface AXMLearningManagementLearningPathEntityModel extends AXPEntityModel<string> {
+    code: string;
+    title: AXPMultiLanguageString;
+    description?: AXPMultiLanguageString | null;
     isActive: boolean;
-    createdAt?: Date;
-    updatedAt?: Date;
 }
 
-interface AXMLearningManagementLearningPathCourseEntityModel {
-    id: string;
+interface AXMLearningManagementLearningPathCourseEntityModel extends AXPEntityModel<string> {
     learningPathId: string;
     courseId: string;
     orderIndex: number;
     course?: {
         id: string;
-        title: string;
+        title: AXPMultiLanguageString;
     };
-    createdAt?: Date;
-    updatedAt?: Date;
 }
 
-interface AXMLearningManagementMandatoryTrainingRuleEntityModel {
-    id: string;
+interface AXMLearningManagementMandatoryTrainingRuleEntityModel extends AXPEntityModel<string> {
     positionId: string;
     courseId: string;
     frequencyMonths?: number | null;
@@ -545,11 +684,9 @@ interface AXMLearningManagementMandatoryTrainingRuleEntityModel {
     };
     course?: {
         id: string;
-        title: string;
+        title: AXPMultiLanguageString;
     };
-    createdAt?: Date;
-    updatedAt?: Date;
 }
 
-export { AXMLearningManagementEntityProvider, AXMLearningManagementMenuKeys, AXMLearningManagementMenuProvider, AXMLearningManagementModule, AXMLearningManagementPermissionDefinitionProvider, AXMLearningManagementPermissionKeys, AXMLearningManagementSearchCommandProvider, RootConfig };
+export { AXLSkillMatrixWidgetEditComponent, AXLSkillMatrixWidgetViewComponent, AXMLearningManagementEntityProvider, AXMLearningManagementMenuKeys, AXMLearningManagementMenuProvider, AXMLearningManagementModule, AXMLearningManagementPermissionDefinitionProvider, AXMLearningManagementPermissionKeys, AXMLearningManagementSearchCommandProvider, AXMLearningManagementSkillMatrixComponent, RootConfig };
 export type { AXMLearningManagementAttendanceEntityModel, AXMLearningManagementCertificateDefinitionEntityModel, AXMLearningManagementCertificateEntityModel, AXMLearningManagementCertificateTypeEntityModel, AXMLearningManagementCourseEntityModel, AXMLearningManagementCourseTypeEntityModel, AXMLearningManagementEnrollmentEntityModel, AXMLearningManagementLearningPathCourseEntityModel, AXMLearningManagementLearningPathEntityModel, AXMLearningManagementMandatoryTrainingRuleEntityModel, AXMLearningManagementSkillEntityModel, AXMLearningManagementSkillLevelEntityModel, AXMLearningManagementTrainingDefinitionEntityModel, AXMLearningManagementTrainingEntityModel, AXMLearningManagementTrainingTypeEntityModel, AttendanceStatus, EnrollmentStatus, TrainingStatus };