mesauth-angular 1.9.2 → 1.11.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mesauth-angular",
-  "version": "1.9.2",
+  "version": "1.11.0",
   "description": "Angular helper library to connect to a backend API and SignalR hub to surface the current logged-in user and incoming notifications with dark/light theme support",
   "keywords": [
     "angular",

package/types/mesauth-angular.d.ts

@@ -52,6 +52,11 @@ interface IUser {
     perms?: Set<string>;
     employeeCode?: string;
     avatarPath?: string;
+    avatarShape?: 'circle' | 'rounded' | 'rectangle' | 'portrait';
+    avatarFrame?: string | null;
+    avatarSize?: 'sm' | 'md' | 'lg';
+    avatarRatio?: 'ar-11' | 'ar-43' | 'ar-169';
+    avatarStyleAllowed?: boolean;
     loginMethod?: number;
     hrFullNameVn?: string;
     hrFullNameEn?: string;
@@ -145,6 +150,7 @@ declare class MesAuthService {
     /** _ngZone accepted but ignored - not needed in zoneless apps. */
     init(config: MesAuthConfig, httpClient: HttpClient, router?: Router, _ngZone?: unknown): void;
     private injectThemeStylesheet;
+    private updateThemeStylesheetVersion;
     getConfig(): MesAuthConfig | null;
     private fetchCurrentUser;
     getUnreadCount(): Observable<any>;
@@ -168,6 +174,16 @@ declare class MesAuthService {
      * Callers can subscribe to wait for completion before proceeding (e.g., navigating after login).
      */
     refreshUser(): Observable<any>;
+    getAvatarStyle(): Observable<{
+        data: string;
+        allowedActions: string[];
+    }>;
+    updateAvatarStyle(avatarShape: string | null, avatarFrame: string | null, avatarSize: string | null, avatarRatio: string | null): Observable<{
+        avatarShape: string | null;
+        avatarFrame: string | null;
+        avatarSize: string | null;
+        avatarRatio: string | null;
+    }>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<MesAuthService, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<MesAuthService>;
 }
@@ -185,6 +201,35 @@ declare class MesAuthModule {
     static ɵinj: _angular_core.ɵɵInjectorDeclaration<MesAuthModule>;
 }
 
+type AvatarSize = 'sm' | 'md' | 'lg' | 'xl';
+type AvatarShape = 'circle' | 'rounded' | 'rectangle' | 'portrait';
+interface AvatarFrameDef {
+    id: string;
+    label: string;
+}
+declare const AVATAR_FRAMES: ReadonlyArray<AvatarFrameDef>;
+declare class MaAvatarComponent {
+    src: _angular_core.InputSignal<string>;
+    alt: _angular_core.InputSignal<string>;
+    initials: _angular_core.InputSignal<string>;
+    size: _angular_core.InputSignal<AvatarSize>;
+    shape: _angular_core.InputSignal<AvatarShape>;
+    frame: _angular_core.InputSignal<string>;
+    ratio: _angular_core.InputSignal<string>;
+    scale: _angular_core.InputSignal<number>;
+    ring: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    ringActive: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    private themeService;
+    get themeClass(): string;
+    readonly wrapperClass: _angular_core.Signal<string>;
+    readonly wrapperStyle: _angular_core.Signal<{
+        '--avatar-scale': number;
+    }>;
+    readonly showImage: _angular_core.Signal<boolean>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MaAvatarComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MaAvatarComponent, "ma-avatar", never, { "src": { "alias": "src"; "required": false; "isSignal": true; }; "alt": { "alias": "alt"; "required": false; "isSignal": true; }; "initials": { "alias": "initials"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "shape": { "alias": "shape"; "required": false; "isSignal": true; }; "frame": { "alias": "frame"; "required": false; "isSignal": true; }; "ratio": { "alias": "ratio"; "required": false; "isSignal": true; }; "scale": { "alias": "scale"; "required": false; "isSignal": true; }; "ring": { "alias": "ring"; "required": false; "isSignal": true; }; "ringActive": { "alias": "ringActive"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
 declare class UserProfileComponent {
     notificationClick: _angular_core.OutputEmitterRef<void>;
     approvalClick: _angular_core.OutputEmitterRef<void>;
@@ -194,6 +239,11 @@ declare class UserProfileComponent {
     readonly pendingApprovalCount: _angular_core.WritableSignal<number>;
     readonly dropdownOpen: _angular_core.WritableSignal<boolean>;
     readonly avatarRefresh: _angular_core.WritableSignal<number>;
+    readonly navAvatarSize: _angular_core.Signal<AvatarSize>;
+    readonly dropAvatarSize: _angular_core.Signal<AvatarSize>;
+    readonly avatarShape: _angular_core.Signal<"circle" | "rounded" | "rectangle" | "portrait">;
+    readonly avatarFrame: _angular_core.Signal<string>;
+    readonly avatarRatio: _angular_core.Signal<"ar-11" | "ar-43" | "ar-169">;
     private readonly authService;
     private readonly router;
     private readonly themeService;
@@ -205,13 +255,14 @@ declare class UserProfileComponent {
     getAvatarUrl(user: IUser): string;
     getLastNameInitial(user: IUser): string;
     toggleDropdown(): void;
+    closeDropdown(): void;
     onDocumentClick(event: Event): void;
     onLogin(): void;
     onViewProfile(): void;
     onLogout(): void;
     onNotificationClick(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<UserProfileComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<UserProfileComponent, "ma-user-profile", never, {}, { "notificationClick": "notificationClick"; "approvalClick": "approvalClick"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<UserProfileComponent, "ma-user-profile", never, {}, { "notificationClick": "notificationClick"; "approvalClick": "approvalClick"; }, never, ["*"], true, never>;
 }
 
 declare enum ApprovalStepMode {
@@ -444,7 +495,7 @@ declare class MaUserComponent implements AfterViewInit {
     onNotificationRead(): void;
     onApprovalActioned(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<MaUserComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MaUserComponent, "ma-user", never, {}, {}, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MaUserComponent, "ma-user", never, {}, {}, never, ["*"], true, never>;
 }
 
 declare class NotificationBadgeComponent {
@@ -686,6 +737,8 @@ interface MaUiManifest {
     /** Feature flags read by components at runtime. */
     features?: Record<string, boolean>;
 }
+/** Current installed package version — keep in sync with package.json. */
+declare const PACKAGE_VERSION = "1.11.0";
 /**
  * Provides server-driven UI configuration loaded from the hosted manifest.
  * Components read `labels()` and `features()` signals instead of hardcoded strings.
@@ -696,12 +749,15 @@ declare class MaUiConfigService {
     private _labels;
     private _features;
     private _updateRequired;
+    private _manifestVersion;
     /** Reactive map of UI string overrides from the server manifest. */
     readonly labels: _angular_core.Signal<Record<string, string>>;
     /** Reactive map of feature flags from the server manifest. */
     readonly features: _angular_core.Signal<Record<string, boolean>>;
     /** True when the server signals that a package upgrade is needed. */
     readonly updateRequired: _angular_core.Signal<boolean>;
+    /** The manifest version string loaded from the server, or null if not yet loaded. */
+    readonly manifestVersion: _angular_core.Signal<string>;
     /**
      * Returns a label by key, falling back to `defaultValue` when the server
      * manifest has not provided an override.
@@ -768,5 +824,24 @@ declare class MaThemeDirective {
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<MaThemeDirective, "[maTheme]", never, {}, {}, never, never, true, never>;
 }
 
-export { ALL_ACTIONS, ApprovalActionType, ApprovalDocumentStatus, ApprovalStepMode, ApprovalStepStatus, MES_AUTH_CONFIG, MaApprovalPanelComponent, MaApprovalService, MaArvContainerComponent, MaIconComponent, MaThemeDirective, MaUiConfigService, MaUserComponent, MesAuthModule, MesAuthService, NotificationBadgeComponent, NotificationPanelComponent, NotificationType, ThemeService, ToastContainerComponent, ToastService, UserProfileComponent, extractXMaPerm, mesAuthInterceptor, provideMesAuth, withXMaPerm, xMaResource };
-export type { ApprovalDashboardDto, ApprovalDocumentDto, ApprovalDocumentSummaryDto, ApprovalHistoryDto, ApprovalReferenceDto, ApprovalStepDto, ApprovalStepRequest, ApprovalSubmitResult, ApprovalTemplateDto, ApprovalTemplateStepDto, ApprovalTemplateSummaryDto, ApproveRejectRequest, CreateApprovalRequest, CreateApprovalResponseDto, CreateApprovalTemplateRequest, DelegateRequest, FrontEndRoute, IUser, MaUiManifest, MesAuthConfig, NotificationDto, PagedList, PermissionHeader, RealTimeNotificationDto, RequestConfig, RolePreviewUserDto, StepRoleDto, Theme, Toast, UpdateApprovalTemplateRequest, UserFrontEndRoutesGrouped };
+declare enum MaUserMenuColor {
+    Default = "default",
+    Primary = "primary",
+    Success = "success",
+    Warning = "warning",
+    Danger = "danger",
+    Info = "info"
+}
+
+declare class MaUserMenuComponent {
+    name: _angular_core.InputSignal<string>;
+    color: _angular_core.InputSignal<MaUserMenuColor>;
+    disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    itemClick: _angular_core.OutputEmitterRef<void>;
+    onClick(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MaUserMenuComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MaUserMenuComponent, "ma-user-menu", never, { "name": { "alias": "name"; "required": true; "isSignal": true; }; "color": { "alias": "color"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, { "itemClick": "itemClick"; }, never, ["[maUserMenuIcon]"], true, never>;
+}
+
+export { ALL_ACTIONS, AVATAR_FRAMES, ApprovalActionType, ApprovalDocumentStatus, ApprovalStepMode, ApprovalStepStatus, MES_AUTH_CONFIG, MaApprovalPanelComponent, MaApprovalService, MaArvContainerComponent, MaAvatarComponent, MaIconComponent, MaThemeDirective, MaUiConfigService, MaUserComponent, MaUserMenuColor, MaUserMenuComponent, MesAuthModule, MesAuthService, NotificationBadgeComponent, NotificationPanelComponent, NotificationType, PACKAGE_VERSION, ThemeService, ToastContainerComponent, ToastService, UserProfileComponent, extractXMaPerm, mesAuthInterceptor, provideMesAuth, withXMaPerm, xMaResource };
+export type { ApprovalDashboardDto, ApprovalDocumentDto, ApprovalDocumentSummaryDto, ApprovalHistoryDto, ApprovalReferenceDto, ApprovalStepDto, ApprovalStepRequest, ApprovalSubmitResult, ApprovalTemplateDto, ApprovalTemplateStepDto, ApprovalTemplateSummaryDto, ApproveRejectRequest, AvatarFrameDef, AvatarShape, AvatarSize, CreateApprovalRequest, CreateApprovalResponseDto, CreateApprovalTemplateRequest, DelegateRequest, FrontEndRoute, IUser, MaUiManifest, MesAuthConfig, NotificationDto, PagedList, PermissionHeader, RealTimeNotificationDto, RequestConfig, RolePreviewUserDto, StepRoleDto, Theme, Toast, UpdateApprovalTemplateRequest, UserFrontEndRoutesGrouped };