@sdcorejs/angular 19.1.4 → 19.1.5

package/i18n/src/en.d.ts

@@ -491,7 +491,11 @@ export 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/modules/layout/components/shared/menu-tree/menu-tree.component.d.ts

@@ -9,6 +9,7 @@ interface SdLayoutMenuTreeNode {
     isGroup: boolean;
     isActive: boolean;
     isPinned: boolean;
+    isPinVisible: boolean;
 }
 export declare class SdLayoutMenuTreeComponent {
     #private;
@@ -17,12 +18,16 @@ export declare class SdLayoutMenuTreeComponent {
     activePath: import("@angular/core").InputSignal<string>;
     pinnedKeys: import("@angular/core").InputSignal<string[]>;
     showPin: import("@angular/core").InputSignal<boolean>;
+    pinVisibility: import("@angular/core").InputSignal<"hover" | "always">;
     navigate: import("@angular/core").OutputEmitterRef<SdLayoutRootMenu>;
     togglePinned: import("@angular/core").OutputEmitterRef<SdLayoutMenu>;
     nodes: import("@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: i0.ɵɵFactoryDeclaration<SdLayoutMenuTreeComponent, never>;
-    static ɵcmp: i0.ɵɵ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: i0.ɵɵ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>;
 }
 export {};

package/modules/layout/components/shared/search-field/search-field.component.d.ts

@@ -0,0 +1,9 @@
+import * as i0 from "@angular/core";
+export declare class SdLayoutSearchFieldComponent {
+    model: import("@angular/core").InputSignal<string>;
+    placeholder: import("@angular/core").InputSignal<string>;
+    autoId: import("@angular/core").InputSignal<string>;
+    sdChange: import("@angular/core").OutputEmitterRef<string>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SdLayoutSearchFieldComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SdLayoutSearchFieldComponent, "sd-layout-search-field", never, { "model": { "alias": "model"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": true; "isSignal": true; }; "autoId": { "alias": "autoId"; "required": true; "isSignal": true; }; }, { "sdChange": "sdChange"; }, never, never, true, never>;
+}

package/modules/layout/components/shared/user-menu/user-menu.component.d.ts

@@ -1,18 +1,35 @@
-import { SdLayoutUserInfo } from '../../../configurations';
+import { SdLayoutAccountAction, SdLayoutNotificationConfiguration, SdLayoutUserInfo } from '../../../configurations';
 import * as i0 from "@angular/core";
 export declare class SdLayoutUserMenuComponent {
     #private;
     private readonly trigger;
     private readonly menu;
     userInfo: import("@angular/core").InputSignal<SdLayoutUserInfo>;
-    signout: import("@angular/core").InputSignal<(() => void | Promise<void>) | undefined>;
-    changePassword: import("@angular/core").InputSignal<(() => void | Promise<void>) | undefined>;
+    signout: import("@angular/core").InputSignal<SdLayoutAccountAction | undefined>;
+    changePassword: import("@angular/core").InputSignal<SdLayoutAccountAction | undefined>;
+    updateProfile: import("@angular/core").InputSignal<SdLayoutAccountAction | undefined>;
+    setting: import("@angular/core").InputSignal<SdLayoutAccountAction | undefined>;
+    notification: import("@angular/core").InputSignal<SdLayoutNotificationConfiguration | undefined>;
     compact: import("@angular/core").InputSignal<boolean>;
+    presentation: import("@angular/core").InputSignal<"disclosure" | "mobile" | "mobile-inline">;
+    opened: import("@angular/core").OutputEmitterRef<void>;
+    closed: import("@angular/core").OutputEmitterRef<void>;
     isOpen: import("@angular/core").WritableSignal<boolean>;
     avatar: import("@angular/core").Signal<string | undefined>;
     displayName: import("@angular/core").Signal<string>;
-    signoutAction: import("@angular/core").Signal<(() => void | Promise<void>) | undefined>;
-    changePasswordAction: import("@angular/core").Signal<(() => void | Promise<void>) | undefined>;
+    role: import("@angular/core").Signal<{
+        text: string;
+        icon?: string;
+        color?: string;
+    } | undefined>;
+    signoutAction: import("@angular/core").Signal<SdLayoutAccountAction | undefined>;
+    changePasswordAction: import("@angular/core").Signal<SdLayoutAccountAction | undefined>;
+    updateProfileAction: import("@angular/core").Signal<SdLayoutAccountAction | undefined>;
+    settingAction: import("@angular/core").Signal<SdLayoutAccountAction | undefined>;
+    notificationConfiguration: import("@angular/core").Signal<SdLayoutNotificationConfiguration | undefined>;
+    notificationAction: import("@angular/core").Signal<SdLayoutAccountAction | undefined>;
+    notificationCount: import("@angular/core").Signal<number>;
+    notificationBadge: import("@angular/core").Signal<string | undefined>;
     constructor();
     open(): void;
     toggle(): void;
@@ -20,6 +37,9 @@ export declare class SdLayoutUserMenuComponent {
     onMenuKeydown(event: KeyboardEvent): void;
     runChangePassword(): void;
     runSignout(): void;
+    runUpdateProfile(): void;
+    runSetting(): void;
+    runNotification(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<SdLayoutUserMenuComponent, never>;
-    static ɵcmp: i0.ɵɵ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: i0.ɵɵ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>;
 }

package/modules/layout/components/sidebar-mobile-v1/components/user/user.component.d.ts

@@ -1,7 +1,6 @@
 import { SdLayoutUserInfo } from '../../../../configurations';
 import * as i0 from "@angular/core";
 export declare class LayoutUserComponent {
-    #private;
     isMobileOrTablet: import("@angular/core").InputSignal<boolean>;
     isMenuLock: import("@angular/core").InputSignal<boolean>;
     isShowSidebar: import("@angular/core").InputSignal<boolean>;
@@ -9,16 +8,9 @@ export declare class LayoutUserComponent {
     menuClosed: import("@angular/core").OutputEmitterRef<void>;
     menuOpened: import("@angular/core").OutputEmitterRef<void>;
     toggleMenuLock: import("@angular/core").OutputEmitterRef<Event>;
-    singoutLayoutConfig: () => void | Promise<void>;
-    changePasswordLayoutConfig: (() => void | Promise<void>) | undefined;
-    isExpanded: import("@angular/core").WritableSignal<boolean>;
-    onMenuOpened: () => void;
-    onMenuClosed: () => void;
-    keepOpenWhenClickInsideMenu: (event: Event) => void;
-    toggleExpanded: () => void;
-    logout: () => void;
-    changePassword: () => void;
-    onToggleMenuLock: (event: Event) => void;
+    onMenuOpened(): void;
+    onMenuClosed(): void;
+    onToggleMenuLock(event: Event): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<LayoutUserComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<LayoutUserComponent, "lib-layout-user", never, { "isMobileOrTablet": { "alias": "isMobileOrTablet"; "required": false; "isSignal": true; }; "isMenuLock": { "alias": "isMenuLock"; "required": false; "isSignal": true; }; "isShowSidebar": { "alias": "isShowSidebar"; "required": false; "isSignal": true; }; "userInfo": { "alias": "userInfo"; "required": true; "isSignal": true; }; }, { "menuClosed": "menuClosed"; "menuOpened": "menuOpened"; "toggleMenuLock": "toggleMenuLock"; }, never, never, true, never>;
 }

package/modules/layout/components/sidebar-v1/components/sidebar/sidebar.component.d.ts

@@ -23,6 +23,7 @@ export declare class SidebarComponent {
     menusByGroup: import("@angular/core").WritableSignal<SdLayoutMenu[]>;
     pinnedMenuGroup: import("@angular/core").Signal<SdLayoutChildrenMenu>;
     totalMenuInMenusByGroup: import("@angular/core").Signal<number>;
+    logoUrl: import("@angular/core").Signal<string | undefined>;
     pinnedNodeKeys: import("@angular/core").Signal<Set<string>>;
     isPinnedMenuGroupActive: import("@angular/core").Signal<boolean>;
     dataSource: MatTreeNestedDataSource<SdLayoutMenu>;

package/modules/layout/components/sidebar-v1/components/user/user.component.d.ts

@@ -1,7 +1,6 @@
 import { SdLayoutUserInfo } from '../../../../configurations';
 import * as i0 from "@angular/core";
 export declare class LayoutUserComponent {
-    #private;
     isMobileOrTablet: import("@angular/core").InputSignal<boolean>;
     isMenuLock: import("@angular/core").InputSignal<boolean>;
     isShowSidebar: import("@angular/core").InputSignal<boolean>;
@@ -9,14 +8,9 @@ export declare class LayoutUserComponent {
     menuClosed: import("@angular/core").OutputEmitterRef<void>;
     menuOpened: import("@angular/core").OutputEmitterRef<void>;
     toggleMenuLock: import("@angular/core").OutputEmitterRef<Event>;
-    singoutLayoutConfig: () => void | Promise<void>;
-    changePasswordLayoutConfig: (() => void | Promise<void>) | undefined;
-    onMenuOpened: () => void;
-    onMenuClosed: () => void;
-    keepOpenWhenClickInsideMenu: (event: Event) => void;
-    logout: () => void;
-    changePassword: () => void;
-    onToggleMenuLock: (event: Event) => void;
+    onMenuOpened(): void;
+    onMenuClosed(): void;
+    onToggleMenuLock(event: Event): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<LayoutUserComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<LayoutUserComponent, "lib-layout-user", never, { "isMobileOrTablet": { "alias": "isMobileOrTablet"; "required": false; "isSignal": true; }; "isMenuLock": { "alias": "isMenuLock"; "required": false; "isSignal": true; }; "isShowSidebar": { "alias": "isShowSidebar"; "required": false; "isSignal": true; }; "userInfo": { "alias": "userInfo"; "required": true; "isSignal": true; }; }, { "menuClosed": "menuClosed"; "menuOpened": "menuOpened"; "toggleMenuLock": "toggleMenuLock"; }, never, never, true, never>;
 }

package/modules/layout/components/sidebar-v1/main.component.d.ts

@@ -18,6 +18,7 @@ export declare class SidebarV1Component {
     onPopupOfSideBarClosed: () => void;
     onExpandSideBar: () => void;
     onMouseleaveSideBar: () => void;
+    onSidenavOpenedChange: (opened: boolean) => void;
     onToggle: (data: boolean | null) => void;
     static ɵfac: i0.ɵɵFactoryDeclaration<SidebarV1Component, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<SidebarV1Component, "sidebar-v1", never, { "menus": { "alias": "menus"; "required": false; "isSignal": true; }; "userInfo": { "alias": "userInfo"; "required": true; "isSignal": true; }; "sidebar": { "alias": "sidebar"; "required": true; "isSignal": true; }; "isMobile": { "alias": "isMobile"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;

package/modules/layout/configurations/layout.configuration.d.ts

@@ -1,12 +1,46 @@
-import { InjectionToken } from '@angular/core';
+import { InjectionToken, Signal } from '@angular/core';
 import { MaybeAsync } from '@sdcorejs/utils/models';
+import { Observable } from 'rxjs';
+/** Consumer-owned account action invoked without arguments by the shared user menu. */
+export type SdLayoutAccountAction = () => void | Promise<void>;
+/** Notification badge source and the action that opens the consumer's notification experience. */
+export 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;
+}
 export 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. */
+export interface SdLayoutUserRole {
+    text: string;
+    /** Icon name resolved by `SdIcon`. */
+    icon?: string;
+    /** CSS color applied to the role metadata. */
+    color?: string;
 }
 export interface SdLayoutUserInfo {
     /**
@@ -30,6 +64,11 @@ export 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;
 }
 export declare const DEFAULT_LAYOUT_MOBILE_BREAKPOINT = 1024;
 export interface SidebarConfigurationBase {

package/package.json

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