@sdcorejs/angular 21.1.4 → 21.1.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sdcorejs/angular",
-  "version": "21.1.4",
+  "version": "21.1.5",
   "license": "MIT",
   "peerDependencies": {
     "@angular/common": "^19.0.0 || ^20.0.0 || ^21.0.0",

package/types/sdcorejs-angular-i18n.d.ts

@@ -498,7 +498,11 @@ declare const EN_MESSAGES: {
     readonly 'core.component.upload-file.preview-title': "Preview image";
     readonly 'core.module.layout.user.change-password': "Change password";
     readonly 'core.module.layout.user.logout': "Sign out";
+    readonly 'core.module.layout.user.update-profile': "Update profile";
+    readonly 'core.module.layout.user.setting': "Settings";
+    readonly 'core.module.layout.user.notification': "Notifications";
     readonly 'core.module.layout.sidebar.search': "Search";
+    readonly 'core.module.layout.sidebar.toggle': "Toggle sidebar";
     readonly 'core.module.layout.greeting.hello': "Hello, {name}";
     readonly 'core.module.layout.weekday.0': "Sunday";
     readonly 'core.module.layout.weekday.1': "Monday";

package/types/sdcorejs-angular-modules-layout.d.ts

@@ -1,5 +1,5 @@
 import * as _angular_core from '@angular/core';
-import { InjectionToken, PipeTransform } from '@angular/core';
+import { Signal, InjectionToken, PipeTransform } from '@angular/core';
 import * as i1$1 from '@angular/common';
 import * as i1 from '@angular/router';
 import { Params } from '@angular/router';
@@ -7,6 +7,7 @@ import { SdStorage } from '@sdcorejs/angular/services';
 import { SdViewport } from '@sdcorejs/angular/services/viewport';
 import * as _sdcorejs_angular_modules_layout from '@sdcorejs/angular/modules/layout';
 import { MaybeAsync } from '@sdcorejs/utils/models';
+import { Observable } from 'rxjs';
 
 declare class HomeRoutingModule {
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<HomeRoutingModule, never>;
@@ -91,13 +92,46 @@ declare class SdLayoutResponsiveService {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<SdLayoutResponsiveService>;
 }
 
+/** Consumer-owned account action invoked without arguments by the shared user menu. */
+type SdLayoutAccountAction = () => void | Promise<void>;
+/** Notification badge source and the action that opens the consumer's notification experience. */
+interface SdLayoutNotificationConfiguration {
+    /**
+     * Số lượng thông báo chưa đọc. Hỗ trợ giá trị tĩnh hoặc nguồn reactive dài hạn.
+     */
+    count: number | Signal<number> | Observable<number>;
+    /**
+     * Tác vụ do consumer xử lý khi người dùng chọn thông báo.
+     */
+    action: SdLayoutAccountAction;
+}
 interface ISdLayoutConfiguration {
     homeUrl?: string;
     mobileBreakpoint?: number;
     sidebar: ISdSidebarConfiguration | (() => MaybeAsync<ISdSidebarConfiguration>);
     userInfo: SdLayoutUserInfo | (() => MaybeAsync<SdLayoutUserInfo>);
-    signout: () => void | Promise<void>;
-    changePassword?: () => void | Promise<void>;
+    signout: SdLayoutAccountAction;
+    changePassword?: SdLayoutAccountAction;
+    /**
+     * Tác vụ chỉnh sửa hồ sơ do consumer cung cấp.
+     */
+    updateProfile?: SdLayoutAccountAction;
+    /**
+     * Tác vụ mở thiết lập tài khoản do consumer cung cấp.
+     */
+    setting?: SdLayoutAccountAction;
+    /**
+     * Cấu hình số lượng và tác vụ thông báo của tài khoản.
+     */
+    notification?: SdLayoutNotificationConfiguration;
+}
+/** Optional role metadata rendered below the user's email when `text` is non-empty. */
+interface SdLayoutUserRole {
+    text: string;
+    /** Icon name resolved by `SdIcon`. */
+    icon?: string;
+    /** CSS color applied to the role metadata. */
+    color?: string;
 }
 interface SdLayoutUserInfo {
     /**
@@ -121,6 +155,11 @@ interface SdLayoutUserInfo {
      * Hỗ trợ các định dạng: URL (http/https), chuỗi base64 (data:image), hoặc đường dẫn nội bộ.
      */
     avatar?: string;
+    /**
+     * Chức vụ hoặc vai trò hiển thị cùng thông tin người dùng.
+     * Không render khi `text` rỗng.
+     */
+    role?: SdLayoutUserRole;
 }
 declare const DEFAULT_LAYOUT_MOBILE_BREAKPOINT = 1024;
 interface SidebarConfigurationBase {
@@ -306,6 +345,7 @@ interface SdLayoutMenuTreeNode {
     isGroup: boolean;
     isActive: boolean;
     isPinned: boolean;
+    isPinVisible: boolean;
 }
 declare class SdLayoutMenuTreeComponent {
     #private;
@@ -314,13 +354,17 @@ declare class SdLayoutMenuTreeComponent {
     activePath: _angular_core.InputSignal<string>;
     pinnedKeys: _angular_core.InputSignal<string[]>;
     showPin: _angular_core.InputSignal<boolean>;
+    pinVisibility: _angular_core.InputSignal<"hover" | "always">;
     navigate: _angular_core.OutputEmitterRef<SdLayoutRootMenu>;
     togglePinned: _angular_core.OutputEmitterRef<SdLayoutMenu>;
     nodes: _angular_core.Signal<SdLayoutMenuTreeNode[]>;
+    constructor();
     onNavigate(menu: SdLayoutMenu): void;
     onTogglePinned(event: MouseEvent, menu: SdLayoutMenu): void;
+    onPinHoverStart(key: string): void;
+    onPinHoverEnd(key: string): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<SdLayoutMenuTreeComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdLayoutMenuTreeComponent, "sd-layout-menu-tree", never, { "menus": { "alias": "menus"; "required": false; "isSignal": true; }; "query": { "alias": "query"; "required": false; "isSignal": true; }; "activePath": { "alias": "activePath"; "required": false; "isSignal": true; }; "pinnedKeys": { "alias": "pinnedKeys"; "required": false; "isSignal": true; }; "showPin": { "alias": "showPin"; "required": false; "isSignal": true; }; }, { "navigate": "navigate"; "togglePinned": "togglePinned"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdLayoutMenuTreeComponent, "sd-layout-menu-tree", never, { "menus": { "alias": "menus"; "required": false; "isSignal": true; }; "query": { "alias": "query"; "required": false; "isSignal": true; }; "activePath": { "alias": "activePath"; "required": false; "isSignal": true; }; "pinnedKeys": { "alias": "pinnedKeys"; "required": false; "isSignal": true; }; "showPin": { "alias": "showPin"; "required": false; "isSignal": true; }; "pinVisibility": { "alias": "pinVisibility"; "required": false; "isSignal": true; }; }, { "navigate": "navigate"; "togglePinned": "togglePinned"; }, never, never, true, never>;
 }
 
 declare class SdLayoutUserMenuComponent {
@@ -328,14 +372,31 @@ declare class SdLayoutUserMenuComponent {
     private readonly trigger;
     private readonly menu;
     userInfo: _angular_core.InputSignal<SdLayoutUserInfo>;
-    signout: _angular_core.InputSignal<(() => void | Promise<void>) | undefined>;
-    changePassword: _angular_core.InputSignal<(() => void | Promise<void>) | undefined>;
+    signout: _angular_core.InputSignal<SdLayoutAccountAction | undefined>;
+    changePassword: _angular_core.InputSignal<SdLayoutAccountAction | undefined>;
+    updateProfile: _angular_core.InputSignal<SdLayoutAccountAction | undefined>;
+    setting: _angular_core.InputSignal<SdLayoutAccountAction | undefined>;
+    notification: _angular_core.InputSignal<SdLayoutNotificationConfiguration | undefined>;
     compact: _angular_core.InputSignal<boolean>;
+    presentation: _angular_core.InputSignal<"disclosure" | "mobile" | "mobile-inline">;
+    opened: _angular_core.OutputEmitterRef<void>;
+    closed: _angular_core.OutputEmitterRef<void>;
     isOpen: _angular_core.WritableSignal<boolean>;
     avatar: _angular_core.Signal<string | undefined>;
     displayName: _angular_core.Signal<string>;
-    signoutAction: _angular_core.Signal<(() => void | Promise<void>) | undefined>;
-    changePasswordAction: _angular_core.Signal<(() => void | Promise<void>) | undefined>;
+    role: _angular_core.Signal<{
+        text: string;
+        icon?: string;
+        color?: string;
+    } | undefined>;
+    signoutAction: _angular_core.Signal<SdLayoutAccountAction | undefined>;
+    changePasswordAction: _angular_core.Signal<SdLayoutAccountAction | undefined>;
+    updateProfileAction: _angular_core.Signal<SdLayoutAccountAction | undefined>;
+    settingAction: _angular_core.Signal<SdLayoutAccountAction | undefined>;
+    notificationConfiguration: _angular_core.Signal<SdLayoutNotificationConfiguration | undefined>;
+    notificationAction: _angular_core.Signal<SdLayoutAccountAction | undefined>;
+    notificationCount: _angular_core.Signal<number>;
+    notificationBadge: _angular_core.Signal<string | undefined>;
     constructor();
     open(): void;
     toggle(): void;
@@ -343,8 +404,11 @@ declare class SdLayoutUserMenuComponent {
     onMenuKeydown(event: KeyboardEvent): void;
     runChangePassword(): void;
     runSignout(): void;
+    runUpdateProfile(): void;
+    runSetting(): void;
+    runNotification(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<SdLayoutUserMenuComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdLayoutUserMenuComponent, "sd-layout-user-menu", never, { "userInfo": { "alias": "userInfo"; "required": true; "isSignal": true; }; "signout": { "alias": "signout"; "required": false; "isSignal": true; }; "changePassword": { "alias": "changePassword"; "required": false; "isSignal": true; }; "compact": { "alias": "compact"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdLayoutUserMenuComponent, "sd-layout-user-menu", never, { "userInfo": { "alias": "userInfo"; "required": true; "isSignal": true; }; "signout": { "alias": "signout"; "required": false; "isSignal": true; }; "changePassword": { "alias": "changePassword"; "required": false; "isSignal": true; }; "updateProfile": { "alias": "updateProfile"; "required": false; "isSignal": true; }; "setting": { "alias": "setting"; "required": false; "isSignal": true; }; "notification": { "alias": "notification"; "required": false; "isSignal": true; }; "compact": { "alias": "compact"; "required": false; "isSignal": true; }; "presentation": { "alias": "presentation"; "required": false; "isSignal": true; }; }, { "opened": "opened"; "closed": "closed"; }, never, never, true, never>;
 }
 
 interface SidebarV2RailItem {
@@ -493,4 +557,4 @@ declare class SdLayoutModule {
 }
 
 export { DEFAULT_LAYOUT_MOBILE_BREAKPOINT, ForbiddenModule, HighlightSearchPipe, HomeModule, MenuFocusPipe, MenuPipe, NotFoundModule, SD_LAYOUT_CONFIGURATION, SD_LAYOUT_VIEWPORT, SdLayoutComponent, SdLayoutMenuTreeComponent, SdLayoutModule, SdLayoutNavigationStateService, SdLayoutResponsiveService, SdLayoutService, SdLayoutStorageService, SdLayoutUserMenuComponent, SdPageComponent, SidebarMobileOverlayComponent, SidebarMobileV1Component, SidebarMobileV2Component, SidebarMobileV3Component, SidebarV2Component, SidebarV3Component, flattenMenuLeaves, getMenuStableKey, normalizeLayoutMobileBreakpoint, normalizeSidebarConfiguration, resolveMenuKeys, resolveSidebarV2Interaction, resolveSidebarV3Recent, searchMenuLeaves, selectPrimaryMenuGroups };
-export type { ISdLayoutConfiguration, ISdSidebarConfiguration, Menus, ResolvedSidebarRecentConfiguration, SdLayoutChildrenMenu, SdLayoutMenu, SdLayoutRootMenu, SdLayoutUserInfo, SdLayoutVersionState, SdLayoutViewport, SidebarConfigurationBase, SidebarConfigurationV1, SidebarConfigurationV2, SidebarConfigurationV3 };
+export type { ISdLayoutConfiguration, ISdSidebarConfiguration, Menus, ResolvedSidebarRecentConfiguration, SdLayoutAccountAction, SdLayoutChildrenMenu, SdLayoutMenu, SdLayoutNotificationConfiguration, SdLayoutRootMenu, SdLayoutUserInfo, SdLayoutUserRole, SdLayoutVersionState, SdLayoutViewport, SidebarConfigurationBase, SidebarConfigurationV1, SidebarConfigurationV2, SidebarConfigurationV3 };