@masterteam/delegations 0.0.20 → 0.0.22

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@masterteam/delegations",
-  "version": "0.0.20",
+  "version": "0.0.22",
   "publishConfig": {
     "directory": "../../../dist/masterteam/delegations",
     "linkDirectory": false,
@@ -21,8 +21,8 @@
     "tailwindcss-primeui": "^0.6.1",
     "@ngxs/store": "^20.1.0",
     "@masterteam/components": "^0.0.175",
-    "@masterteam/icons": "^0.0.15",
-    "@masterteam/forms": "^0.0.80"
+    "@masterteam/forms": "^0.0.80",
+    "@masterteam/icons": "^0.0.15"
   },
   "sideEffects": false,
   "exports": {

package/types/masterteam-delegations.d.ts

@@ -71,6 +71,10 @@ interface DelegationScopeTarget {
     applicationKey: string;
     targetType: string;
     targetKey: string;
+    parentTargetType?: string | null;
+    parentTargetKey?: string | null;
+    parentDisplayName?: DelegationDisplayValue;
+    parentLevelId?: number | null;
     legacyModuleId?: number | null;
     targetId?: number | null;
     levelId?: number | null;
@@ -79,6 +83,7 @@ interface DelegationScopeTarget {
     moduleKey?: string | null;
     permissionModuleType?: string | null;
     permissionTargetId?: number | null;
+    isDelegable?: boolean;
     displayName?: DelegationDisplayValue;
     displayLabel?: DelegationDisplayValue;
     label?: DelegationDisplayValue;
@@ -95,7 +100,9 @@ interface DelegationScopeAction {
     permissionCommand?: string | null;
     businessActionCode?: string | null;
     isHighRisk?: boolean;
+    isDelegable?: boolean;
     isDelegableSnapshot?: boolean;
+    sortOrder?: number | null;
 }
 interface DelegationScopeFact {
     key?: string | null;
@@ -131,10 +138,25 @@ interface DelegationScopeCombinationRule {
     [extra: string]: unknown;
 }
 /**
- * `scope/options` may come back either as legacy `grants[]` or as the newer
- * catalog facts (`targets + operations + combinationRules`).
+ * `scope/options` now prefers backend-owned `hierarchy` for FE rendering.
+ * Flat `grants[]` / `targets + operations + combinationRules` remain for
+ * compatibility and diagnostics while older environments catch up.
  */
+interface DelegationScopeHierarchyTarget {
+    target: DelegationScopeTarget;
+    operations: DelegationScopeAction[];
+    sortOrder?: number | null;
+}
+interface DelegationScopeHierarchyGroup {
+    groupType: string;
+    groupKey: string;
+    displayName?: DelegationDisplayValue;
+    levelId?: number | null;
+    sortOrder?: number | null;
+    targets: DelegationScopeHierarchyTarget[];
+}
 interface DelegationScopeOptions {
+    hierarchy?: DelegationScopeHierarchyGroup[] | null;
     grants?: DelegationGrant[] | null;
     metadata?: Record<string, unknown>;
     targets?: DelegationScopeTarget[] | null;
@@ -247,6 +269,7 @@ interface RejectDelegationRequest {
 declare enum DelegationsActionKey {
     GetMy = "getMy",
     GetAssigned = "getAssigned",
+    GetAdmin = "getAdmin",
     GetActive = "getActive",
     GetDetail = "getDetail",
     GetScopeOptions = "getScopeOptions",
@@ -260,6 +283,7 @@ declare enum DelegationsActionKey {
 interface DelegationsStateModel extends LoadingStateShape<DelegationsActionKey> {
     my: DelegationPage<DelegationRow> | null;
     assigned: DelegationPage<DelegationRow> | null;
+    admin: DelegationPage<DelegationRow> | null;
     active: DelegationPage<DelegationRow> | null;
     detail: DelegationDetail | null;
     scopeOptions: DelegationScopeOptions | null;
@@ -278,6 +302,7 @@ declare class TopbarDelegationMenu {
     /** Path to the management page, e.g. `/control-panel/delegations` or `/delegations`. */
     readonly managePath: _angular_core.InputSignal<string>;
     readonly compact: _angular_core.InputSignal<boolean>;
+    readonly showManageLink: _angular_core.InputSignal<boolean>;
     private readonly facade;
     private readonly modal;
     private readonly transloco;
@@ -287,7 +312,7 @@ declare class TopbarDelegationMenu {
     protected readonly hasCandidates: _angular_core.Signal<boolean>;
     protected readonly onBehalfOf: _angular_core.Signal<_masterteam_delegations.DelegationParty | null>;
     protected readonly executedBy: _angular_core.Signal<_masterteam_delegations.DelegationParty | null>;
-    protected readonly mode: _angular_core.Signal<"active" | "candidates" | "hidden">;
+    protected readonly mode: _angular_core.Signal<"hidden" | "active" | "candidates">;
     protected formatScopeSummary(summary: DelegationRow['scopeSummary']): string;
     togglePopover(event: Event): void;
     start(row: DelegationRow, event: MouseEvent): void;
@@ -295,7 +320,7 @@ declare class TopbarDelegationMenu {
     endSession(event: MouseEvent): void;
     private openConfirm;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<TopbarDelegationMenu, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TopbarDelegationMenu, "mt-topbar-delegation-menu", never, { "managePath": { "alias": "managePath"; "required": false; "isSignal": true; }; "compact": { "alias": "compact"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TopbarDelegationMenu, "mt-topbar-delegation-menu", never, { "managePath": { "alias": "managePath"; "required": false; "isSignal": true; }; "compact": { "alias": "compact"; "required": false; "isSignal": true; }; "showManageLink": { "alias": "showManageLink"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 interface StatusVisual {
@@ -388,6 +413,11 @@ declare class DelegationsList implements OnInit {
      * `withComponentInputBinding()` — admin passes `data: { adminMode: true }`.
      */
     readonly adminMode: _angular_core.InputSignal<boolean>;
+    readonly surfaceTitleKey: _angular_core.InputSignal<string>;
+    readonly assignedTabLabelKey: _angular_core.InputSignal<string>;
+    readonly assignedDecisionTab: _angular_core.InputSignal<boolean>;
+    readonly assignedEmptyStateKey: _angular_core.InputSignal<string>;
+    readonly assignedStatus: _angular_core.InputSignal<DelegationEffectiveStatus | null>;
     private readonly facade;
     private readonly modal;
     private readonly transloco;
@@ -405,15 +435,19 @@ declare class DelegationsList implements OnInit {
         routerLink?: undefined;
     })[]>;
     protected readonly activeTab: _angular_core.WritableSignal<DelegationTab>;
-    protected readonly tabs: _angular_core.WritableSignal<{
+    protected readonly surfaceTitle: _angular_core.Signal<string>;
+    protected readonly tabs: _angular_core.Signal<{
         value: DelegationTab;
         label: string;
     }[]>;
     protected readonly isLoading: _angular_core.Signal<boolean>;
     protected readonly scopeOptions: _angular_core.Signal<_masterteam_delegations.DelegationScopeOptions | null>;
     protected readonly rows: _angular_core.Signal<DelegationRow[]>;
+    protected readonly emptyStateKey: _angular_core.Signal<string>;
     statusCol: _angular_core.Signal<TemplateRef<unknown>>;
     userCol: _angular_core.Signal<TemplateRef<unknown>>;
+    delegatorCol: _angular_core.Signal<TemplateRef<unknown>>;
+    delegatedUserCol: _angular_core.Signal<TemplateRef<unknown>>;
     scopeCol: _angular_core.Signal<TemplateRef<unknown>>;
     daysCol: _angular_core.Signal<TemplateRef<unknown>>;
     protected readonly canCreate: _angular_core.Signal<boolean>;
@@ -429,6 +463,7 @@ declare class DelegationsList implements OnInit {
     protected has(row: DelegationRow, action: DelegationAllowedAction): boolean;
     protected formatDays(row: DelegationRow): string;
     protected formatScopeSummary(value: DelegationRow['scopeSummary']): string;
+    protected getListedParty(row: DelegationRow): DelegationParty;
     private viewDetails;
     private openForm;
     private approve;
@@ -437,9 +472,18 @@ declare class DelegationsList implements OnInit {
     private startSession;
     private mark;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DelegationsList, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DelegationsList, "mt-delegations-list", never, { "showBreadcrumb": { "alias": "showBreadcrumb"; "required": false; "isSignal": true; }; "adminMode": { "alias": "adminMode"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DelegationsList, "mt-delegations-list", never, { "showBreadcrumb": { "alias": "showBreadcrumb"; "required": false; "isSignal": true; }; "adminMode": { "alias": "adminMode"; "required": false; "isSignal": true; }; "surfaceTitleKey": { "alias": "surfaceTitleKey"; "required": false; "isSignal": true; }; "assignedTabLabelKey": { "alias": "assignedTabLabelKey"; "required": false; "isSignal": true; }; "assignedDecisionTab": { "alias": "assignedDecisionTab"; "required": false; "isSignal": true; }; "assignedEmptyStateKey": { "alias": "assignedEmptyStateKey"; "required": false; "isSignal": true; }; "assignedStatus": { "alias": "assignedStatus"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+interface DelegationFormUserValue {
+    id: string;
+    userId: string;
+    displayName: string;
+    userName: string;
+    email?: string | null;
+    photo?: string | null;
+    isExternal: boolean;
+}
 /**
  * Delegation create/edit form (doc 04). Uses the v2 explicit-scope endpoints so
  * the persisted `DelegationScopeSelection` matches what scope/preview validated.
@@ -472,9 +516,10 @@ declare class DelegationForm implements OnInit {
     isSaving: _angular_core.Signal<boolean>;
     context: HttpContext;
     protected readonly scope: _angular_core.WritableSignal<DelegationScopeSelection>;
-    /** Selected delegator id (admin mode only); drives scope/options + create payload. */
+    protected readonly currentDelegator: _angular_core.WritableSignal<DelegationFormUserValue | null>;
+    /** Selected delegator id drives scope/options loading and the admin payload. */
     protected readonly selectedDelegatorId: _angular_core.Signal<string | undefined>;
-    /** In admin mode the scope picker only loads once a delegator is chosen. */
+    /** Admin mode waits for a chosen delegator; self-service always has one. */
     protected readonly showScopePicker: _angular_core.Signal<boolean>;
     protected readonly specificDaysOptions: _angular_core.WritableSignal<{
         label: string;
@@ -485,6 +530,7 @@ declare class DelegationForm implements OnInit {
     ngOnInit(): void;
     protected readonly canSubmit: _angular_core.Signal<boolean>;
     onSubmit(): void;
+    private mapPartyToUserValue;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DelegationForm, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<DelegationForm, "mt-delegation-form", never, { "delegationForEdit": { "alias": "delegationForEdit"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "adminMode": { "alias": "adminMode"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
@@ -516,19 +562,29 @@ declare class DelegationDetailDrawer implements OnInit {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<DelegationDetailDrawer, "mt-delegation-detail-drawer", never, { "delegationId": { "alias": "delegationId"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
-interface TargetGroup {
+interface DelegationGrantableTargetGroup {
     key: string;
     target: DelegationScopeTarget;
     grants: DelegationGrant[];
+    sortOrder: number;
+}
+interface DelegationGrantableHierarchyGroup {
+    key: string;
+    groupType: string;
+    displayName?: DelegationDisplayValue;
+    sortOrder: number;
+    targets: DelegationGrantableTargetGroup[];
 }
+
 /**
- * Grants-based scope picker (doc 03). Driven entirely by `scope/options`:
- * - lists grantable target/action pairs returned by the backend,
- * - lets the user toggle each grant,
+ * Hierarchy-based scope picker (doc 03). Driven entirely by `scope/options`:
+ * - renders backend-owned Level -> Level Module -> operations hierarchy,
+ * - lets the user toggle each explicit grant,
  * - calls `scope/preview` (debounced) and surfaces summary / warnings / denied.
  *
  * `[(scope)]` two-way binds a `DelegationScopeSelection`. The component never
- * invents permission metadata — it only echoes grants returned by options.
+ * invents permission metadata — it only echoes targets/actions returned by
+ * options.
  */
 declare class ScopePicker {
     readonly scope: _angular_core.ModelSignal<DelegationScopeSelection>;
@@ -546,22 +602,24 @@ declare class ScopePicker {
     protected readonly isLoadingOptions: _angular_core.Signal<boolean>;
     protected readonly isPreviewing: _angular_core.Signal<boolean>;
     protected readonly errorOptions: _angular_core.Signal<string | null>;
-    /** Grantable options grouped by target. */
-    protected readonly groups: _angular_core.Signal<TargetGroup[]>;
+    protected readonly groups: _angular_core.Signal<DelegationGrantableHierarchyGroup[]>;
     /** Selected grant keys for O(1) checkbox state. */
     protected readonly selectedKeys: _angular_core.Signal<Set<string>>;
     private readonly expanded;
     constructor();
-    protected isExpanded(group: TargetGroup): boolean;
-    protected toggleAccordion(group: TargetGroup): void;
+    protected isExpanded(group: DelegationGrantableHierarchyGroup): boolean;
+    protected toggleAccordion(group: DelegationGrantableHierarchyGroup): void;
     protected isSelected(grant: DelegationGrant): boolean;
+    protected getGroupLabel(group: DelegationGrantableHierarchyGroup): string;
     protected getTargetLabel(target: DelegationScopeTarget): string;
     protected getActionLabel(grant: DelegationGrant): string;
+    protected getTargetActions(targetGroup: DelegationGrantableTargetGroup): DelegationGrant[];
     protected getPreviewSummary(summary: DelegationDisplayValue | undefined): string;
     protected formatDeniedOperation(value?: string | null): string;
     protected formatDeniedTarget(value?: string | null): string;
     protected toggleGrant(grant: DelegationGrant): void;
-    protected selectedCount(group: TargetGroup): number;
+    protected selectedCount(group: DelegationGrantableHierarchyGroup): number;
+    protected selectedTargetCount(targetGroup: DelegationGrantableTargetGroup): number;
     private currentLanguage;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ScopePicker, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ScopePicker, "mt-scope-picker", never, { "scope": { "alias": "scope"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "delegatorUserId": { "alias": "delegatorUserId"; "required": false; "isSignal": true; }; }, { "scope": "scopeChange"; }, never, never, true, never>;
@@ -584,6 +642,11 @@ declare class GetAssignedDelegations {
     static readonly type = "[Delegations] Get Assigned Delegations";
     constructor(query?: DelegationListQuery);
 }
+declare class GetAdminDelegations {
+    query: DelegationListQuery;
+    static readonly type = "[Delegations] Get Admin Delegations";
+    constructor(query?: DelegationListQuery);
+}
 declare class GetActiveAssignedDelegations {
     query: DelegationListQuery;
     static readonly type = "[Delegations] Get Active Assigned Delegations";
@@ -673,6 +736,7 @@ declare class DelegationsState {
     private http;
     static getMy(state: DelegationsStateModel): DelegationPage<DelegationRow> | null;
     static getAssigned(state: DelegationsStateModel): DelegationPage<DelegationRow> | null;
+    static getAdmin(state: DelegationsStateModel): DelegationPage<DelegationRow> | null;
     static getActive(state: DelegationsStateModel): DelegationPage<DelegationRow> | null;
     static getDetail(state: DelegationsStateModel): DelegationDetail | null;
     static getScopeOptions(state: DelegationsStateModel): DelegationScopeOptions | null;
@@ -681,6 +745,7 @@ declare class DelegationsState {
     static getErrors(state: DelegationsStateModel): Record<string, string | null | undefined>;
     getMy(ctx: StateContext<DelegationsStateModel>, { query }: GetMyDelegations): rxjs.Observable<Response<DelegationPage<DelegationRow>>>;
     getAssigned(ctx: StateContext<DelegationsStateModel>, { query }: GetAssignedDelegations): rxjs.Observable<Response<DelegationPage<DelegationRow>>>;
+    getAdmin(ctx: StateContext<DelegationsStateModel>, { query }: GetAdminDelegations): rxjs.Observable<Response<DelegationPage<DelegationRow>>>;
     getActive(ctx: StateContext<DelegationsStateModel>, { query }: GetActiveAssignedDelegations): rxjs.Observable<Response<DelegationPage<DelegationRow>>>;
     getDetail(ctx: StateContext<DelegationsStateModel>, { id }: GetDelegationDetail): rxjs.Observable<Response<DelegationDetail>>;
     clearDetail(ctx: StateContext<DelegationsStateModel>): void;
@@ -702,6 +767,7 @@ declare class DelegationsFacade {
     private readonly store;
     readonly myPage: _angular_core.Signal<_masterteam_delegations.DelegationPage<_masterteam_delegations.DelegationRow> | null>;
     readonly assignedPage: _angular_core.Signal<_masterteam_delegations.DelegationPage<_masterteam_delegations.DelegationRow> | null>;
+    readonly adminPage: _angular_core.Signal<_masterteam_delegations.DelegationPage<_masterteam_delegations.DelegationRow> | null>;
     readonly activePage: _angular_core.Signal<_masterteam_delegations.DelegationPage<_masterteam_delegations.DelegationRow> | null>;
     readonly detail: _angular_core.Signal<_masterteam_delegations.DelegationDetail | null>;
     readonly scopeOptions: _angular_core.Signal<_masterteam_delegations.DelegationScopeOptions | null>;
@@ -710,9 +776,11 @@ declare class DelegationsFacade {
     private readonly errors;
     readonly myItems: _angular_core.Signal<_masterteam_delegations.DelegationRow[]>;
     readonly assignedItems: _angular_core.Signal<_masterteam_delegations.DelegationRow[]>;
+    readonly adminItems: _angular_core.Signal<_masterteam_delegations.DelegationRow[]>;
     readonly activeItems: _angular_core.Signal<_masterteam_delegations.DelegationRow[]>;
     readonly isLoadingMy: _angular_core.Signal<boolean>;
     readonly isLoadingAssigned: _angular_core.Signal<boolean>;
+    readonly isLoadingAdmin: _angular_core.Signal<boolean>;
     readonly isLoadingActive: _angular_core.Signal<boolean>;
     readonly isLoadingDetail: _angular_core.Signal<boolean>;
     readonly isLoadingScopeOptions: _angular_core.Signal<boolean>;
@@ -723,11 +791,13 @@ declare class DelegationsFacade {
     readonly isCancelling: _angular_core.Signal<boolean>;
     readonly errorMy: _angular_core.Signal<string | null>;
     readonly errorAssigned: _angular_core.Signal<string | null>;
+    readonly errorAdmin: _angular_core.Signal<string | null>;
     readonly errorDetail: _angular_core.Signal<string | null>;
     readonly errorScopeOptions: _angular_core.Signal<string | null>;
     readonly errorSave: _angular_core.Signal<string | null>;
     getMy(query?: DelegationListQuery): rxjs.Observable<void>;
     getAssigned(query?: DelegationListQuery): rxjs.Observable<void>;
+    getAdmin(query?: DelegationListQuery): rxjs.Observable<void>;
     getActive(query?: DelegationListQuery): rxjs.Observable<void>;
     getDetail(id: number): rxjs.Observable<void>;
     clearDetail(): rxjs.Observable<void>;
@@ -831,5 +901,5 @@ declare class DelegationSessionFacade {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<DelegationSessionFacade>;
 }
 
-export { ApproveDelegation, CancelDelegation, ClearDelegationDetail, ClearScopePreview, CreateDelegationLegacy, CreateDelegationV2, DelegationDetailDrawer, DelegationForm, DelegationSessionActionKey, DelegationSessionFacade, DelegationSessionState, DelegationStatusChip, Delegations, DelegationsActionKey, DelegationsFacade, DelegationsList, DelegationsState, EndDelegationSession, GetActiveAssignedDelegations, GetAssignedDelegations, GetDelegationDetail, GetMyDelegations, GetScopeOptions, LoadDelegationCandidates, PreviewScope, RejectDelegation, RejectDelegationDialog, ScopePicker, StartDelegationSession, StartSessionDialog, SwitchDelegationSession, TopbarDelegationMenu, UpdateDelegationLegacy, UpdateDelegationV2, appDelegationInterceptor };
-export type { ActiveDelegationSession, ApproveDelegationRequest, CreateDelegationLegacyRequest, CreateDelegationV2Request, DelegationAllowedAction, DelegationApprovalInfo, DelegationApprovalStatus, DelegationCancellationInfo, DelegationDayRuleMode, DelegationDetail, DelegationDisplayValue, DelegationDto, DelegationEffectiveStatus, DelegationGrant, DelegationListQuery, DelegationPage, DelegationParty, DelegationRow, DelegationScopeAction, DelegationScopeCombinationRule, DelegationScopeDeniedItem, DelegationScopeFact, DelegationScopeOptions, DelegationScopePreview, DelegationScopeSelection, DelegationScopeTarget, DelegationScopeWarning, DelegationSessionInvalidationReason, DelegationSessionStateModel, DelegationSortDirection, DelegationStatusInfo, DelegationsStateModel, RejectDelegationRequest, UpdateDelegationLegacyRequest, UpdateDelegationV2Request };
+export { ApproveDelegation, CancelDelegation, ClearDelegationDetail, ClearScopePreview, CreateDelegationLegacy, CreateDelegationV2, DelegationDetailDrawer, DelegationForm, DelegationSessionActionKey, DelegationSessionFacade, DelegationSessionState, DelegationStatusChip, Delegations, DelegationsActionKey, DelegationsFacade, DelegationsList, DelegationsState, EndDelegationSession, GetActiveAssignedDelegations, GetAdminDelegations, GetAssignedDelegations, GetDelegationDetail, GetMyDelegations, GetScopeOptions, LoadDelegationCandidates, PreviewScope, RejectDelegation, RejectDelegationDialog, ScopePicker, StartDelegationSession, StartSessionDialog, SwitchDelegationSession, TopbarDelegationMenu, UpdateDelegationLegacy, UpdateDelegationV2, appDelegationInterceptor };
+export type { ActiveDelegationSession, ApproveDelegationRequest, CreateDelegationLegacyRequest, CreateDelegationV2Request, DelegationAllowedAction, DelegationApprovalInfo, DelegationApprovalStatus, DelegationCancellationInfo, DelegationDayRuleMode, DelegationDetail, DelegationDisplayValue, DelegationDto, DelegationEffectiveStatus, DelegationGrant, DelegationListQuery, DelegationPage, DelegationParty, DelegationRow, DelegationScopeAction, DelegationScopeCombinationRule, DelegationScopeDeniedItem, DelegationScopeFact, DelegationScopeHierarchyGroup, DelegationScopeHierarchyTarget, DelegationScopeOptions, DelegationScopePreview, DelegationScopeSelection, DelegationScopeTarget, DelegationScopeWarning, DelegationSessionInvalidationReason, DelegationSessionStateModel, DelegationSortDirection, DelegationStatusInfo, DelegationsStateModel, RejectDelegationRequest, UpdateDelegationLegacyRequest, UpdateDelegationV2Request };