@acorex-platform/module-risk-management-client 0.0.38 → 0.0.48

package/types/acorex-platform-module-risk-management-client-contracts.d.ts

@@ -1,5 +1,5 @@
+import { AXPModuleManifest, AXPCategoryListItem, AXPMultiLanguageString, AXPSpreadsheetData } from '@acorex-platform/framework-shared/core';
 import { AXPEntityModel } from '@acorex-platform/framework-shared/entity';
-import { AXPSpreadsheetData, AXPCategoryListItem, AXPMultiLanguageString } from '@acorex-platform/framework-shared/core';
 
 /** Hazard catalog scope for environmental and operational risk matrix records. */
 declare const RISK_CATALOG_SCOPE_HAZARD = "risk-management.hazard";
@@ -8,10 +8,10 @@ declare const RISK_CATALOG_SCOPE_PPE_ITEMS = "risk-management.ppe-items";
 
 declare const AXMRiskManagementMenuKeys: {
     readonly Root: "RiskManagement:Menu:Root";
-    readonly RiskLikelihoods: "RiskManagement:Menu:RiskLikelihoods";
-    readonly RiskSeverities: "RiskManagement:Menu:RiskSeverities";
-    readonly RiskRatings: "RiskManagement:Menu:RiskRatings";
-    readonly RiskMatrixCells: "RiskManagement:Menu:RiskMatrixCells";
+    readonly RiskLikelihoodScales: "RiskManagement:Menu:RiskLikelihoodScales";
+    readonly RiskSeverityScales: "RiskManagement:Menu:RiskSeverityScales";
+    readonly RiskRatingScales: "RiskManagement:Menu:RiskRatingScales";
+    readonly RiskMatrices: "RiskManagement:Menu:RiskMatrices";
 };
 
 /**
@@ -33,28 +33,28 @@ declare const AXPSafetyRiskPermissionKeys: {
 declare const AXMRiskManagementPermissionKeys: {
     readonly RiskManagement: {
         readonly Management: "SafetyRisk:Permission:MaintainRisk";
-        readonly RiskLikelihood: {
+        readonly RiskLikelihoodScale: {
             readonly Management: "SafetyRisk:Permission:Setup";
             readonly View: "SafetyRisk:Permission:Setup";
             readonly Create: "SafetyRisk:Permission:Setup";
             readonly Update: "SafetyRisk:Permission:Setup";
             readonly Delete: "SafetyRisk:Permission:Setup";
         };
-        readonly RiskSeverity: {
+        readonly RiskSeverityScale: {
             readonly Management: "SafetyRisk:Permission:Setup";
             readonly View: "SafetyRisk:Permission:Setup";
             readonly Create: "SafetyRisk:Permission:Setup";
             readonly Update: "SafetyRisk:Permission:Setup";
             readonly Delete: "SafetyRisk:Permission:Setup";
         };
-        readonly RiskRating: {
+        readonly RiskRatingScale: {
             readonly Management: "SafetyRisk:Permission:Setup";
             readonly View: "SafetyRisk:Permission:Setup";
             readonly Create: "SafetyRisk:Permission:Setup";
             readonly Update: "SafetyRisk:Permission:Setup";
             readonly Delete: "SafetyRisk:Permission:Setup";
         };
-        readonly RiskMatrixCell: {
+        readonly RiskMatrix: {
             readonly Management: "SafetyRisk:Permission:MaintainRisk";
             readonly View: "SafetyRisk:Permission:MaintainRisk";
             readonly Create: "SafetyRisk:Permission:MaintainRisk";
@@ -64,7 +64,7 @@ declare const AXMRiskManagementPermissionKeys: {
     };
 };
 
-/** Lookup properties on RiskMatrixCell that can be assigned to matrix axes. */
+/** Spreadsheet axis slots. Values are display keys, not RiskMatrix FK field names. */
 type AXMRiskMatrixAxisProperty = 'likelihoodId' | 'severityId' | 'riskRatingId';
 interface AXMRiskMatrixAxisMapping {
     rowProperty: AXMRiskMatrixAxisProperty;
@@ -74,16 +74,6 @@ interface AXMRiskMatrixAxisMapping {
 type AXMRiskMatrixOrientation = 'likelihood-rows' | 'severity-rows';
 declare const RISK_MATRIX_AXIS_PROPERTIES: readonly AXMRiskMatrixAxisProperty[];
 declare const DEFAULT_RISK_MATRIX_AXIS_MAPPING: AXMRiskMatrixAxisMapping;
-declare const RISK_MATRIX_AXIS_PROPERTY_SELECT_OPTIONS: readonly [{
-    readonly id: "likelihoodId";
-    readonly title: "@risk-management:risk-matrix-cells.entities.risk-matrix-cell.fields.likelihood-id.title";
-}, {
-    readonly id: "severityId";
-    readonly title: "@risk-management:risk-matrix-cells.entities.risk-matrix-cell.fields.severity-id.title";
-}, {
-    readonly id: "riskRatingId";
-    readonly title: "@risk-management:risk-matrix-cells.entities.risk-matrix-cell.fields.risk-rating-id.title";
-}];
 declare const DEFAULT_RISK_MATRIX_ORIENTATION: AXMRiskMatrixOrientation;
 declare const RISK_MATRIX_ORIENTATION_OPTIONS: Array<{
     id: AXMRiskMatrixOrientation;
@@ -104,28 +94,28 @@ declare const RootConfig: {
         icon: string;
     };
     entities: {
-        riskLikelihood: {
+        riskLikelihoodScale: {
             name: string;
             source: string;
             title: string;
             titlePlural: string;
             icon: string;
         };
-        riskSeverity: {
+        riskSeverityScale: {
             name: string;
             source: string;
             title: string;
             titlePlural: string;
             icon: string;
         };
-        riskRating: {
+        riskRatingScale: {
             name: string;
             source: string;
             title: string;
             titlePlural: string;
             icon: string;
         };
-        riskMatrixCell: {
+        riskMatrix: {
             name: string;
             source: string;
             title: string;
@@ -135,71 +125,173 @@ declare const RootConfig: {
     };
 };
 
-interface AXMRiskManagementRiskLikelihoodEntityModel extends AXPEntityModel<string> {
+/**
+ * Risk Management module manifest.
+ */
+declare const RiskManagementManifest: AXPModuleManifest;
+
+/**
+ * Likelihood scale level managed via repeater on {@link AXMRiskManagementRiskLikelihoodScaleEntityModel}.
+ * Stable `id` values remain on levels for other lookups; matrix cells key by `code`.
+ */
+interface AXMRiskLikelihoodLevelItemModel {
+    id?: string;
+    /** Level code used as the risk-matrix axis / cell key. */
+    code?: string;
+    title: string;
+    score: number;
+    /**
+     * Optional explicit order. When omitted, repeater array index defines order
+     * (`RepeaterLayout` + `allowReorder`).
+     */
+    order?: number;
+}
+interface AXMRiskManagementRiskLikelihoodScaleEntityModel extends AXPEntityModel<string> {
+    /** Business code from identifier rule `risk-likelihood-scale-code` (`RLS-{date:YYYY}-{seq:4}`). */
     code: string;
     title: string;
     description?: string;
-    levelValue: number;
+    /** Likelihood levels managed via repeater. */
+    levels: AXMRiskLikelihoodLevelItemModel[];
     isArchived?: boolean;
     archivedAt?: Date | string;
 }
 
-interface AXMRiskManagementRiskMatrixCellEntityModel extends AXPEntityModel<string> {
-    /** Business code from identifier rule `risk-matrix-cell-code` (`RMC-{date:YYYY}-{seq:4}`). */
+/** Sorts levels by explicit `order`, then `score`, then array index. */
+declare function sortRiskLikelihoodLevels(levels: AXMRiskLikelihoodLevelItemModel[] | null | undefined): AXMRiskLikelihoodLevelItemModel[];
+/** Returns level codes in display order (skips items without code). */
+declare function resolveRiskLikelihoodLevelCodes(levels: AXMRiskLikelihoodLevelItemModel[] | null | undefined): string[];
+
+/**
+ * Rating scale level managed via repeater on {@link AXMRiskManagementRiskRatingScaleEntityModel}.
+ * Stable `id` values remain on levels for other lookups; matrix cells key by `code`.
+ */
+interface AXMRiskRatingLevelItemModel {
+    id?: string;
+    /** Level code used as the risk-matrix cell rating value. */
+    code?: string;
+    title: string;
+    score: number;
+    /** Surface CSS class from `color-chooser` (`success-lighter-surface` or `axp-hex-4caf50`). */
+    color?: string;
+    /**
+     * Optional explicit order. When omitted, repeater array index defines order
+     * (`RepeaterLayout` + `allowReorder`).
+     */
+    order?: number;
+}
+interface AXMRiskManagementRiskRatingScaleEntityModel extends AXPEntityModel<string> {
+    /** Business code from identifier rule `risk-rating-scale-code` (`RRS-{date:YYYY}-{seq:4}`). */
     code: string;
     title: string;
-    likelihoodIds: string[];
-    likelihoodList?: Array<{
-        id: string;
-        title?: string;
-        code?: string;
-    }>;
-    /** @deprecated Use `likelihoodIds`. Kept so existing documents still resolve in widgets. */
-    likelihoodId?: string[];
-    severityIds: string[];
-    severityList?: Array<{
-        id: string;
-        title?: string;
-        code?: string;
-    }>;
-    /** @deprecated Use `severityIds`. Kept so existing documents still resolve in widgets. */
-    severityId?: string[];
-    /** Likelihood rows × severity columns mapped to risk rating ids. */
-    matrix?: AXPSpreadsheetData;
-    categoryIds?: string[];
-    categories?: AXPCategoryListItem[];
-    /** Registered catalog scope keys (module providers). */
-    catalogScopeKeys?: string[];
-    /** Resolved scope labels for list display (enriched by catalog-scope resolver middleware). */
-    catalogScopes?: Array<{
-        name: string;
-        title: AXPMultiLanguageString | string;
-        cssClass?: string;
-    }>;
+    description?: string;
+    /** Rating levels managed via repeater. */
+    levels: AXMRiskRatingLevelItemModel[];
     isArchived?: boolean;
     archivedAt?: Date | string;
 }
 
-interface AXMRiskManagementRiskRatingEntityModel extends AXPEntityModel<string> {
-    /** Business code from identifier rule `risk-rating-code` (`RR-{date:YYYY}-{seq:4}`). */
+/**
+ * Severity scale level managed via repeater on {@link AXMRiskManagementRiskSeverityScaleEntityModel}.
+ * Stable `id` values remain on levels for other lookups; matrix cells key by `code`.
+ */
+interface AXMRiskSeverityLevelItemModel {
+    id?: string;
+    /** Level code used as the risk-matrix axis / cell key. */
+    code?: string;
+    title: string;
+    score: number;
+    /**
+     * Optional explicit order. When omitted, repeater array index defines order
+     * (`RepeaterLayout` + `allowReorder`).
+     */
+    order?: number;
+}
+interface AXMRiskManagementRiskSeverityScaleEntityModel extends AXPEntityModel<string> {
+    /** Business code from identifier rule `risk-severity-scale-code` (`RSS-{date:YYYY}-{seq:4}`). */
     code: string;
     title: string;
     description?: string;
-    levelValue: number;
-    /** Surface CSS class from `color-chooser` (`success-lighter-surface` or `axp-hex-4caf50`). */
-    color?: string;
+    /** Severity levels managed via repeater. */
+    levels: AXMRiskSeverityLevelItemModel[];
     isArchived?: boolean;
     archivedAt?: Date | string;
 }
 
-interface AXMRiskManagementRiskSeverityEntityModel extends AXPEntityModel<string> {
+/** Lookup expose snapshot for a selected scale (`levels` drive matrix axes). */
+interface AXMRiskMatrixScaleRef<TLevel> {
+    id?: string;
+    title?: string;
+    code?: string;
+    levels?: TLevel[];
+}
+/**
+ * One matrix cell keyed by selected-scale **level codes** (not scale entities or level ids).
+ */
+interface AXMRiskMatrixCellValueObject {
+    likelihoodLevelCode: string;
+    severityLevelCode: string;
+    ratingLevelCode: string;
+}
+/** Alias matching the design name {@link AXMRiskMatrixCellValueObject}. */
+type RiskMatrixCellValueObject = AXMRiskMatrixCellValueObject;
+interface AXMRiskManagementRiskMatrixEntityModel extends AXPEntityModel<string> {
+    /** Business code from identifier rule `risk-matrix-code` (`RMC-{date:YYYY}-{seq:4}`). */
     code: string;
     title: string;
     description?: string;
-    levelValue: number;
+    /** Controls spreadsheet row/column layout only. Persisted `cells` stay likelihood × severity. */
+    matrixOrientation?: AXMRiskMatrixOrientation;
+    /** Selected likelihood scale that supplies axis levels. */
+    likelihoodScaleId: string;
+    likelihoodScale?: AXMRiskMatrixScaleRef<AXMRiskLikelihoodLevelItemModel>;
+    /** Selected severity scale that supplies axis levels. */
+    severityScaleId: string;
+    severityScale?: AXMRiskMatrixScaleRef<AXMRiskSeverityLevelItemModel>;
+    /** Selected rating scale that supplies cell-value levels. */
+    ratingScaleId: string;
+    ratingScale?: AXMRiskMatrixScaleRef<AXMRiskRatingLevelItemModel>;
+    /** Likelihood × severity combinations mapped to rating level codes. */
+    cells: AXMRiskMatrixCellValueObject[];
+    categoryIds?: string[];
+    categories?: AXPCategoryListItem[];
+    /** Registered catalog scope keys (module providers). */
+    catalogScopeKeys?: string[];
+    /** Resolved scope labels for list display (enriched by catalog-scope resolver middleware). */
+    catalogScopes?: Array<{
+        name: string;
+        title: AXPMultiLanguageString | string;
+        cssClass?: string;
+    }>;
     isArchived?: boolean;
     archivedAt?: Date | string;
 }
 
-export { AXMRiskManagementMenuKeys, AXMRiskManagementPermissionKeys, AXPSafetyRiskPermissionKeys, DEFAULT_RISK_MATRIX_AXIS_MAPPING, DEFAULT_RISK_MATRIX_ORIENTATION, RISK_CATALOG_SCOPE_HAZARD, RISK_CATALOG_SCOPE_PPE_ITEMS, RISK_MATRIX_AXIS_PROPERTIES, RISK_MATRIX_AXIS_PROPERTY_SELECT_OPTIONS, RISK_MATRIX_ORIENTATION_OPTIONS, RISK_MATRIX_ORIENTATION_TITLE_KEYS, RootConfig };
-export type { AXMRiskManagementRiskLikelihoodEntityModel, AXMRiskManagementRiskMatrixCellEntityModel, AXMRiskManagementRiskRatingEntityModel, AXMRiskManagementRiskSeverityEntityModel, AXMRiskMatrixAxisMapping, AXMRiskMatrixAxisProperty, AXMRiskMatrixOrientation };
+declare function isRiskMatrixCellValueObject(value: unknown): value is AXMRiskMatrixCellValueObject;
+declare function normalizeRiskMatrixCellValueObject(value: unknown): AXMRiskMatrixCellValueObject | null;
+/** Converts persisted cells into the spreadsheet shape used by the matrix widget. */
+declare function toRiskMatrixSpreadsheetData(cells: AXMRiskMatrixCellValueObject[] | null | undefined): AXPSpreadsheetData;
+/** Converts spreadsheet values (likelihood × severity → rating) into cell value objects. */
+declare function fromRiskMatrixSpreadsheetData(matrix: AXPSpreadsheetData | null | undefined): AXMRiskMatrixCellValueObject[];
+/**
+ * Accepts persisted `cells` or a legacy nested spreadsheet object and returns cell value objects.
+ */
+declare function resolveRiskMatrixCells(value: unknown): AXMRiskMatrixCellValueObject[];
+/**
+ * Drops cells whose level codes are no longer on the selected scales.
+ * Persisted shape stays likelihood × severity → rating.
+ */
+declare function pruneRiskMatrixCells(cells: AXMRiskMatrixCellValueObject[] | null | undefined, likelihoodCodes: string[], severityCodes: string[], ratingCodes?: string[]): AXMRiskMatrixCellValueObject[];
+
+/** Sorts levels by explicit `order`, then `score`, then array index. */
+declare function sortRiskRatingLevels(levels: AXMRiskRatingLevelItemModel[] | null | undefined): AXMRiskRatingLevelItemModel[];
+/** Returns level codes in display order (skips items without code). */
+declare function resolveRiskRatingLevelCodes(levels: AXMRiskRatingLevelItemModel[] | null | undefined): string[];
+
+/** Sorts levels by explicit `order`, then `score`, then array index. */
+declare function sortRiskSeverityLevels(levels: AXMRiskSeverityLevelItemModel[] | null | undefined): AXMRiskSeverityLevelItemModel[];
+/** Returns level codes in display order (skips items without code). */
+declare function resolveRiskSeverityLevelCodes(levels: AXMRiskSeverityLevelItemModel[] | null | undefined): string[];
+
+export { AXMRiskManagementMenuKeys, AXMRiskManagementPermissionKeys, AXPSafetyRiskPermissionKeys, DEFAULT_RISK_MATRIX_AXIS_MAPPING, DEFAULT_RISK_MATRIX_ORIENTATION, RISK_CATALOG_SCOPE_HAZARD, RISK_CATALOG_SCOPE_PPE_ITEMS, RISK_MATRIX_AXIS_PROPERTIES, RISK_MATRIX_ORIENTATION_OPTIONS, RISK_MATRIX_ORIENTATION_TITLE_KEYS, RiskManagementManifest, RootConfig, fromRiskMatrixSpreadsheetData, isRiskMatrixCellValueObject, normalizeRiskMatrixCellValueObject, pruneRiskMatrixCells, resolveRiskLikelihoodLevelCodes, resolveRiskMatrixCells, resolveRiskRatingLevelCodes, resolveRiskSeverityLevelCodes, sortRiskLikelihoodLevels, sortRiskRatingLevels, sortRiskSeverityLevels, toRiskMatrixSpreadsheetData };
+export type { AXMRiskLikelihoodLevelItemModel, AXMRiskManagementRiskLikelihoodScaleEntityModel, AXMRiskManagementRiskMatrixEntityModel, AXMRiskManagementRiskRatingScaleEntityModel, AXMRiskManagementRiskSeverityScaleEntityModel, AXMRiskMatrixAxisMapping, AXMRiskMatrixAxisProperty, AXMRiskMatrixCellValueObject, AXMRiskMatrixOrientation, AXMRiskMatrixScaleRef, AXMRiskRatingLevelItemModel, AXMRiskSeverityLevelItemModel, RiskMatrixCellValueObject };

package/types/acorex-platform-module-risk-management-client.d.ts

@@ -4,8 +4,10 @@ import * as _angular_core from '@angular/core';
 import * as i1 from '@acorex-platform/framework-client/layout/widget-core';
 import { AXPColumnWidgetComponent, AXPValueWidgetComponent } from '@acorex-platform/framework-client/layout/widget-core';
 import * as _acorex_platform_module_risk_management_client_contracts from '@acorex-platform/module-risk-management-client/contracts';
-import { AXMRiskMatrixAxisMapping, AXMRiskMatrixAxisProperty, AXMRiskMatrixOrientation } from '@acorex-platform/module-risk-management-client/contracts';
+import { AXMRiskMatrixAxisMapping, AXMRiskLikelihoodLevelItemModel, AXMRiskSeverityLevelItemModel, AXMRiskRatingLevelItemModel, AXMRiskMatrixCellValueObject, AXMRiskMatrixAxisProperty, AXMRiskMatrixOrientation } from '@acorex-platform/module-risk-management-client/contracts';
 import { AXPSpreadsheetData, AXPSpreadsheetCellChangeEvent, AXPSpreadsheetItem, AXPSpreadsheetColumn } from '@acorex-platform/framework-client/layout/components';
+import * as _acorex_platform_framework_shared_core from '@acorex-platform/framework-shared/core';
+import { AXPSpreadsheetData as AXPSpreadsheetData$1 } from '@acorex-platform/framework-shared/core';
 
 declare class AXMRiskManagementMenuProvider implements AXPMenuProvider {
     private readonly entityService;
@@ -29,18 +31,23 @@ declare class AXMRiskManagementModule {
 
 declare class AXMRiskManagementRiskMatrixComponent {
     private readonly entityService;
-    private readonly likelihoodDataAccessor;
-    private readonly severityDataAccessor;
-    private readonly riskRatingDataAccessor;
+    private readonly likelihoodScaleDataAccessor;
+    private readonly severityScaleDataAccessor;
+    private readonly riskRatingScaleDataAccessor;
     private readonly multiLanguageResolver;
     /** Axis mapping. Defaults to likelihood × severity → risk rating. */
     axisMapping: _angular_core.InputSignal<Partial<AXMRiskMatrixAxisMapping>>;
-    /** Selected axis item ids from the parent matrix record. */
-    likelihoodIds: _angular_core.InputSignal<string[] | null | undefined>;
-    severityIds: _angular_core.InputSignal<string[] | null | undefined>;
-    /** Controls row/column layout only; persisted matrix stays likelihood × severity. */
+    /** Selected scale ids from the parent matrix record. Axes load from that scale's levels. */
+    likelihoodScaleId: _angular_core.InputSignal<string | null | undefined>;
+    severityScaleId: _angular_core.InputSignal<string | null | undefined>;
+    ratingScaleId: _angular_core.InputSignal<string | null | undefined>;
+    /** Lookup expose snapshots — used in create before (or instead of) byKey. */
+    likelihoodScaleLevels: _angular_core.InputSignal<AXMRiskLikelihoodLevelItemModel[] | null | undefined>;
+    severityScaleLevels: _angular_core.InputSignal<AXMRiskSeverityLevelItemModel[] | null | undefined>;
+    ratingScaleLevels: _angular_core.InputSignal<AXMRiskRatingLevelItemModel[] | null | undefined>;
+    /** Controls row/column layout only; persisted cells stay likelihood × severity. */
     matrixOrientation: _angular_core.InputSignal<string | null | undefined>;
-    /** Matrix data: { [likelihoodId]: { [severityId]: riskRatingId } } */
+    /** Spreadsheet data keyed by **level codes**: { [likelihoodCode]: { [severityCode]: ratingCode } } */
     value: _angular_core.InputSignal<AXPSpreadsheetData>;
     readonly: _angular_core.InputSignal<boolean>;
     valueChange: _angular_core.OutputEmitterRef<AXPSpreadsheetData>;
@@ -48,11 +55,14 @@ declare class AXMRiskManagementRiskMatrixComponent {
     private readonly likelihoodItems;
     private readonly severityItems;
     private readonly depthItems;
-    private readonly hasLoadedAxesOnce;
-    protected readonly isLoading: _angular_core.WritableSignal<boolean>;
+    /** Drops overlapping create-mode loads so an earlier request cannot wipe later rating levels. */
+    private loadAxesRequestId;
     protected readonly resolvedMatrixOrientation: _angular_core.Signal<_acorex_platform_module_risk_management_client_contracts.AXMRiskMatrixOrientation>;
     protected readonly resolvedAxisMapping: _angular_core.Signal<AXMRiskMatrixAxisMapping>;
     protected readonly displayMatrix: _angular_core.Signal<AXPSpreadsheetData>;
+    protected readonly spreadsheetIdentity: _angular_core.Signal<string>;
+    /** Create mode: do not open empty cell editors before rating levels are loaded. */
+    protected readonly cellSelectLocked: _angular_core.Signal<boolean>;
     protected readonly matrixTitleKey: _angular_core.Signal<string>;
     protected readonly verticalTitles: _angular_core.Signal<AXPSpreadsheetItem[]>;
     protected readonly horizontalTitles: _angular_core.Signal<AXPSpreadsheetItem[]>;
@@ -63,14 +73,22 @@ declare class AXMRiskManagementRiskMatrixComponent {
     protected readonly spreadsheetRows: _angular_core.Signal<Record<string, unknown>[]>;
     constructor();
     private loadMatrixAxes;
+    private applyAxisItems;
     private queryAxisItems;
-    private getAxisDataAccessor;
+    private readScaleLevels;
+    private mapLikelihoodLevels;
+    private mapSeverityLevels;
+    private mapRatingLevels;
+    private mapAxisLevels;
+    private toAxisLevelKey;
+    private loadScaleWithLevels;
+    private queryScaleById;
     private toSpreadsheetItems;
     private convertSpreadsheetRowsToMatrixData;
     protected handleSpreadsheetChange(rows: Record<string, unknown>[]): void;
     protected handleCellChange(event: AXPSpreadsheetCellChangeEvent): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXMRiskManagementRiskMatrixComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXMRiskManagementRiskMatrixComponent, "axm-risk-matrix", never, { "axisMapping": { "alias": "axisMapping"; "required": false; "isSignal": true; }; "likelihoodIds": { "alias": "likelihoodIds"; "required": false; "isSignal": true; }; "severityIds": { "alias": "severityIds"; "required": false; "isSignal": true; }; "matrixOrientation": { "alias": "matrixOrientation"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; }, { "valueChange": "valueChange"; "cellChange": "cellChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXMRiskManagementRiskMatrixComponent, "axm-risk-matrix", never, { "axisMapping": { "alias": "axisMapping"; "required": false; "isSignal": true; }; "likelihoodScaleId": { "alias": "likelihoodScaleId"; "required": false; "isSignal": true; }; "severityScaleId": { "alias": "severityScaleId"; "required": false; "isSignal": true; }; "ratingScaleId": { "alias": "ratingScaleId"; "required": false; "isSignal": true; }; "likelihoodScaleLevels": { "alias": "likelihoodScaleLevels"; "required": false; "isSignal": true; }; "severityScaleLevels": { "alias": "severityScaleLevels"; "required": false; "isSignal": true; }; "ratingScaleLevels": { "alias": "ratingScaleLevels"; "required": false; "isSignal": true; }; "matrixOrientation": { "alias": "matrixOrientation"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; }, { "valueChange": "valueChange"; "cellChange": "cellChange"; }, never, never, true, never>;
 }
 
 interface AXMRiskMatrixViewerOpenOptions {
@@ -100,29 +118,46 @@ declare class AXMRiskMatrixWidgetColumnComponent extends AXPColumnWidgetComponen
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXMRiskMatrixWidgetColumnComponent, "axm-risk-matrix-widget-column", never, { "rawValue": { "alias": "rawValue"; "required": false; }; "rowData": { "alias": "rowData"; "required": false; }; }, {}, never, never, true, never>;
 }
 
-declare class AXMRiskMatrixWidgetEditComponent extends AXPValueWidgetComponent<AXPSpreadsheetData> {
+declare class AXMRiskMatrixWidgetEditComponent extends AXPValueWidgetComponent<AXMRiskMatrixCellValueObject[]> {
     constructor();
     protected readonly: _angular_core.Signal<boolean>;
     protected axisMapping: _angular_core.Signal<AXMRiskMatrixAxisMapping>;
     protected matrixOrientation: _angular_core.Signal<_acorex_platform_module_risk_management_client_contracts.AXMRiskMatrixOrientation>;
-    protected likelihoodIds: _angular_core.Signal<string[]>;
-    protected severityIds: _angular_core.Signal<string[]>;
-    protected matrixValue: _angular_core.Signal<AXPSpreadsheetData>;
-    protected handleValueChange(data: AXPSpreadsheetData): void;
+    protected likelihoodScaleId: _angular_core.Signal<string | undefined>;
+    protected severityScaleId: _angular_core.Signal<string | undefined>;
+    protected ratingScaleId: _angular_core.Signal<string | undefined>;
+    protected likelihoodScaleLevels: _angular_core.Signal<AXMRiskLikelihoodLevelItemModel[] | undefined>;
+    protected severityScaleLevels: _angular_core.Signal<AXMRiskSeverityLevelItemModel[] | undefined>;
+    protected ratingScaleLevels: _angular_core.Signal<AXMRiskRatingLevelItemModel[] | undefined>;
+    protected likelihoodCodes: _angular_core.Signal<string[]>;
+    protected severityCodes: _angular_core.Signal<string[]>;
+    protected ratingCodes: _angular_core.Signal<string[]>;
+    protected matrixValue: _angular_core.Signal<AXPSpreadsheetData$1>;
+    protected handleValueChange(data: AXPSpreadsheetData$1): void;
+    private resolveScaleId;
+    private resolveScaleLevels;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXMRiskMatrixWidgetEditComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXMRiskMatrixWidgetEditComponent, "axm-risk-matrix-widget-edit", never, {}, {}, never, never, true, never>;
 }
 
-declare class AXMRiskMatrixWidgetViewComponent extends AXPValueWidgetComponent<AXPSpreadsheetData> {
+declare class AXMRiskMatrixWidgetViewComponent extends AXPValueWidgetComponent<AXMRiskMatrixCellValueObject[]> {
     protected axisMapping: _angular_core.Signal<AXMRiskMatrixAxisMapping>;
     protected matrixOrientation: _angular_core.Signal<_acorex_platform_module_risk_management_client_contracts.AXMRiskMatrixOrientation>;
-    protected likelihoodIds: _angular_core.Signal<string[]>;
-    protected severityIds: _angular_core.Signal<string[]>;
-    protected matrixValue: _angular_core.Signal<AXPSpreadsheetData>;
+    protected likelihoodScaleId: _angular_core.Signal<string | undefined>;
+    protected severityScaleId: _angular_core.Signal<string | undefined>;
+    protected ratingScaleId: _angular_core.Signal<string | undefined>;
+    protected likelihoodScaleLevels: _angular_core.Signal<AXMRiskLikelihoodLevelItemModel[] | undefined>;
+    protected severityScaleLevels: _angular_core.Signal<AXMRiskSeverityLevelItemModel[] | undefined>;
+    protected ratingScaleLevels: _angular_core.Signal<AXMRiskRatingLevelItemModel[] | undefined>;
+    protected matrixValue: _angular_core.Signal<_acorex_platform_framework_shared_core.AXPSpreadsheetData>;
+    private resolveScaleId;
+    private resolveScaleLevels;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXMRiskMatrixWidgetViewComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXMRiskMatrixWidgetViewComponent, "axm-risk-matrix-widget-view", never, {}, {}, never, never, true, never>;
 }
 
+type RiskMatrixScaleIdField = 'likelihoodScaleId' | 'severityScaleId' | 'ratingScaleId';
+type RiskMatrixScaleSnapshotField = 'likelihoodScale' | 'severityScale' | 'ratingScale';
 declare function isRiskMatrixAxisProperty(value: unknown): value is AXMRiskMatrixAxisProperty;
 declare function resolveRiskMatrixAxisMapping(mapping?: Partial<AXMRiskMatrixAxisMapping> | null): AXMRiskMatrixAxisMapping;
 declare function isRiskMatrixOrientation(value: unknown): value is AXMRiskMatrixOrientation;
@@ -141,18 +176,29 @@ declare function toDisplayMatrixData(canonical: AXPSpreadsheetData, orientation?
 /** Converts display-oriented matrix data back to canonical likelihood × severity storage. */
 declare function toCanonicalMatrixData(display: AXPSpreadsheetData, orientation?: unknown): AXPSpreadsheetData;
 /**
- * Reads selected axis ids from a risk-matrix-cell record.
- * Prefers `*Ids` (multi-lookup convention), then legacy `*Id`, then joined `*List`.
+ * Reads selected axis **level codes** from a risk-matrix record.
+ * Codes come from the selected scale snapshot (`*.scale.levels`), never from scale entity ids.
  */
-declare function resolveRiskMatrixCellAxisIds(data: unknown, axis: 'likelihood' | 'severity'): string[];
-/** Normalizes lookup axis values (ids or `{ id }` rows) to string ids. */
-declare function normalizeRiskMatrixAxisIds(value: unknown): string[];
+declare function resolveRiskMatrixAxisCodes(data: unknown, axis: 'likelihood' | 'severity' | 'rating'): string[];
+/** Resolves a lookup uuid that may be stored as a string or `{ id }` row. */
+declare function resolveRiskMatrixScaleId(value: unknown): string | undefined;
 /**
- * Drops matrix entries for axes no longer selected on the record.
- * Persisted shape stays likelihood × severity → risk rating.
+ * Create mode may have the snapshot (`ratingScale.id`) before `ratingScaleId` is committed.
+ * Edit mode has both after GET join.
  */
-declare function pruneMatrixToAxes(matrix: AXPSpreadsheetData, likelihoodIds: string[], severityIds: string[]): AXPSpreadsheetData;
+declare function resolveRiskMatrixScaleIdFromRecord(data: unknown, idField: RiskMatrixScaleIdField, snapshotField: RiskMatrixScaleSnapshotField): string | undefined;
+/**
+ * Widget-context scale id: path `getValue` first, then the full record snapshot.
+ */
+declare function resolveRiskMatrixWidgetScaleId(getValue: (path: string) => unknown, data: unknown, idField: RiskMatrixScaleIdField, snapshotField: RiskMatrixScaleSnapshotField): string | undefined;
+/**
+ * Nested `levels` from a lookup expose snapshot (`likelihoodScale.levels`, …).
+ * Empty arrays are treated as missing so create-mode can still fetch by id.
+ */
+declare function resolveRiskMatrixScaleLevels<T>(data: unknown, snapshotField: RiskMatrixScaleSnapshotField, levelsFromPath?: unknown): T[] | undefined;
+/** Widget-context scale levels: nested path, then snapshot on the record. */
+declare function resolveRiskMatrixWidgetScaleLevels<T>(getValue: (path: string) => unknown, data: unknown, snapshotField: RiskMatrixScaleSnapshotField): T[] | undefined;
 declare function validateRiskMatrixAxisMapping(mapping: Partial<AXMRiskMatrixAxisMapping>): boolean;
 
-export { AXMRiskManagementMenuProvider, AXMRiskManagementModule, AXMRiskManagementPermissionDefinitionProvider, AXMRiskManagementRiskMatrixComponent, AXMRiskMatrixViewerService, AXMRiskMatrixWidgetColumnComponent, AXMRiskMatrixWidgetEditComponent, AXMRiskMatrixWidgetViewComponent, isRiskMatrixAxisProperty, isRiskMatrixOrientation, normalizeRiskMatrixAxisIds, pruneMatrixToAxes, resolveRiskMatrixAxisMapping, resolveRiskMatrixAxisMappingFromOrientation, resolveRiskMatrixCellAxisIds, resolveRiskMatrixOrientation, resolveRiskMatrixTitleKey, toCanonicalMatrixData, toDisplayMatrixData, validateRiskMatrixAxisMapping };
+export { AXMRiskManagementMenuProvider, AXMRiskManagementModule, AXMRiskManagementPermissionDefinitionProvider, AXMRiskManagementRiskMatrixComponent, AXMRiskMatrixViewerService, AXMRiskMatrixWidgetColumnComponent, AXMRiskMatrixWidgetEditComponent, AXMRiskMatrixWidgetViewComponent, isRiskMatrixAxisProperty, isRiskMatrixOrientation, resolveRiskMatrixAxisCodes, resolveRiskMatrixAxisMapping, resolveRiskMatrixAxisMappingFromOrientation, resolveRiskMatrixOrientation, resolveRiskMatrixScaleId, resolveRiskMatrixScaleIdFromRecord, resolveRiskMatrixScaleLevels, resolveRiskMatrixTitleKey, resolveRiskMatrixWidgetScaleId, resolveRiskMatrixWidgetScaleLevels, toCanonicalMatrixData, toDisplayMatrixData, validateRiskMatrixAxisMapping };
 export type { AXMRiskMatrixViewerOpenOptions };