@sd-angular/core 19.0.0-beta.7 → 19.0.0-beta.71

package/modules/keycloak/keycloak.module.d.ts

@@ -0,0 +1,18 @@
+import { ModuleWithProviders, Type, EnvironmentProviders } from '@angular/core';
+import { ISdKeycloakConfiguration } from './keycloak.configuration';
+import * as i0 from "@angular/core";
+export declare function provideSdKeycloak(options: {
+    useClass?: Type<ISdKeycloakConfiguration>;
+    useFactory?: (...args: any[]) => ISdKeycloakConfiguration;
+    deps?: any[];
+}): EnvironmentProviders;
+export declare class SdKeycloakModule {
+    static forRoot(options: {
+        useClass?: Type<ISdKeycloakConfiguration>;
+        useFactory?: (...args: any[]) => ISdKeycloakConfiguration;
+        deps?: any[];
+    }): ModuleWithProviders<SdKeycloakModule>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SdKeycloakModule, never>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<SdKeycloakModule, never, never, never>;
+    static ɵinj: i0.ɵɵInjectorDeclaration<SdKeycloakModule>;
+}

package/modules/keycloak/keycloak.service.d.ts

@@ -0,0 +1,14 @@
+import Keycloak from 'keycloak-js';
+import { SdKeycloakTenantConfig } from './keycloak.configuration';
+import * as i0 from "@angular/core";
+export declare class SdKeycloakService {
+    keycloak: Keycloak;
+    config: SdKeycloakTenantConfig;
+    init(config: SdKeycloakTenantConfig): Promise<boolean>;
+    login(): Promise<void>;
+    logout(): Promise<void>;
+    getToken(): string | undefined;
+    getIsAuthenticated(): boolean;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SdKeycloakService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<SdKeycloakService>;
+}

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

@@ -1,16 +1,11 @@
-import { OnInit } from '@angular/core';
 import { SdLayoutMenu } from '../../services';
-import { MenuPipe } from '../../pipes';
-import { ISdLayoutConfiguration, ISdSidebarConfiguration } from '../../configurations';
 import * as i0 from "@angular/core";
-export declare class SdLayoutComponent implements OnInit {
-    private layoutConfig;
-    private menuPipe;
-    constructor(layoutConfig: ISdLayoutConfiguration, menuPipe: MenuPipe);
-    menus: SdLayoutMenu[];
-    set _menus(menus: SdLayoutMenu[]);
-    sidebarConfiguration: ISdSidebarConfiguration;
-    ngOnInit(): Promise<void>;
+export declare class SdLayoutComponent {
+    #private;
+    menusInput: import("@angular/core").InputSignal<SdLayoutMenu[]>;
+    menus: import("@angular/core").Signal<SdLayoutMenu[]>;
+    userInfo: import("@angular/core").WritableSignal<import("@sd-angular/core/modules/layout").SdLayoutUserInfo | undefined>;
+    sidebar: import("@angular/core").WritableSignal<import("@sd-angular/core/modules/layout").SidebarConfigurationV1 | undefined>;
     static ɵfac: i0.ɵɵFactoryDeclaration<SdLayoutComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<SdLayoutComponent, "sd-layout", never, { "_menus": { "alias": "menus"; "required": false; }; }, {}, never, ["*"], true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SdLayoutComponent, "sd-layout", never, { "menusInput": { "alias": "menus"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
 }

package/modules/layout/components/page/page.component.d.ts

@@ -1,12 +1,10 @@
-import { ElementRef } from '@angular/core';
 import * as i0 from "@angular/core";
 export declare class SdPageComponent {
     private el;
-    title?: string;
-    set _title(val: string | undefined | null);
-    noHeader?: boolean;
-    set _noHeader(val: boolean | '' | undefined | null);
-    constructor(el: ElementRef);
+    title: import("@angular/core").InputSignal<string>;
+    description: import("@angular/core").InputSignal<string>;
+    noHeader: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+    constructor();
     static ɵfac: i0.ɵɵFactoryDeclaration<SdPageComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<SdPageComponent, "sd-page", never, { "_title": { "alias": "title"; "required": false; }; "_noHeader": { "alias": "noHeader"; "required": false; }; }, {}, never, ["[headerLeft]", "[headerRight]", "*"], true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SdPageComponent, "sd-page", never, { "title": { "alias": "title"; "required": false; "isSignal": true; }; "description": { "alias": "description"; "required": false; "isSignal": true; }; "noHeader": { "alias": "noHeader"; "required": false; "isSignal": true; }; }, {}, never, ["[headerLeft]", "[headerRight]", "*"], true, never>;
 }

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

@@ -1,38 +1,31 @@
 import { NestedTreeControl } from '@angular/cdk/tree';
-import { Params, Router } from '@angular/router';
 import { MatTreeNestedDataSource } from '@angular/material/tree';
-import { EventEmitter, OnDestroy, OnInit } from '@angular/core';
-import { SdLayoutStorageService, SdLayoutMenu } from '../../../../services';
-import { MenuFocusPipe } from '../../../../pipes';
-import { ISdLayoutConfiguration, ISidebarConfigurationV1 } from '../../../../configurations';
+import { Params } from '@angular/router';
+import { SdLayoutUserInfo, SidebarConfigurationV1 } from '../../../../configurations';
+import { SdLayoutMenu } from '../../../../services';
 import * as i0 from "@angular/core";
-export declare class LayoutSidebarComponent implements OnDestroy, OnInit {
+export declare class SidebarComponent {
     #private;
-    private router;
-    private layoutConfiguration;
-    private layoutStorageService;
-    private menuFocusPipe;
-    isShowSidebar: boolean;
-    set _menus(menus: SdLayoutMenu[]);
-    expandSideBar: EventEmitter<void>;
-    popupUserMenuClosed: EventEmitter<void>;
-    popupUserMenuOpened: EventEmitter<void>;
-    showSideBar: EventEmitter<boolean | null>;
-    menusOrigin: SdLayoutMenu[];
+    isShowSidebar: import("@angular/core").InputSignal<boolean>;
+    menus: import("@angular/core").InputSignal<SdLayoutMenu[]>;
+    userInfo: import("@angular/core").InputSignal<SdLayoutUserInfo>;
+    sidebar: import("@angular/core").InputSignal<SidebarConfigurationV1>;
+    expandSideBar: import("@angular/core").OutputEmitterRef<void>;
+    popupUserMenuClosed: import("@angular/core").OutputEmitterRef<void>;
+    popupUserMenuOpened: import("@angular/core").OutputEmitterRef<void>;
+    showSideBar: import("@angular/core").OutputEmitterRef<boolean | null>;
     screenHeight: number;
-    searchText: string;
-    isMenuLock: boolean;
-    currentPath: string;
-    titleMenuGroup: string | undefined;
     isMobileOrTablet: boolean;
-    sidebar: ISidebarConfigurationV1;
+    isMenuLock: import("@angular/core").WritableSignal<boolean>;
+    currentPath: import("@angular/core").WritableSignal<string>;
+    searchText: import("@angular/core").WritableSignal<string>;
+    titleMenuGroup: import("@angular/core").WritableSignal<string | undefined>;
+    idMenuGroupActive: import("@angular/core").WritableSignal<string | undefined>;
+    menusByGroup: import("@angular/core").WritableSignal<SdLayoutMenu[]>;
+    totalMenuInMenusByGroup: import("@angular/core").Signal<number>;
     dataSource: MatTreeNestedDataSource<SdLayoutMenu>;
-    idMenuGroupActive: string | undefined;
-    menusByGroup: SdLayoutMenu[];
     treeControl: NestedTreeControl<SdLayoutMenu, SdLayoutMenu>;
-    constructor(router: Router, layoutConfiguration: ISdLayoutConfiguration, layoutStorageService: SdLayoutStorageService, menuFocusPipe: MenuFocusPipe);
-    ngOnInit(): Promise<void>;
-    ngOnDestroy(): void;
+    constructor();
     hasChild: (_: number, node: SdLayoutMenu) => boolean;
     onToggleMenuNode: (menu: SdLayoutMenu) => void;
     toggleMenuLock(event: Event): void;
@@ -50,6 +43,6 @@ export declare class LayoutSidebarComponent implements OnDestroy, OnInit {
     onMouseLeaveMenuGroupNode: (event: MouseEvent, menuNode: SdLayoutMenu) => void;
     onMouseOverMenuNode: (event: MouseEvent, menuItem: SdLayoutMenu) => void;
     onMouseLeaveMenuNode: (event: MouseEvent, menuItem: SdLayoutMenu) => void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<LayoutSidebarComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<LayoutSidebarComponent, "lib-layout-sidebar", never, { "isShowSidebar": { "alias": "isShowSidebar"; "required": false; }; "_menus": { "alias": "menus"; "required": false; }; }, { "expandSideBar": "expandSideBar"; "popupUserMenuClosed": "popupUserMenuClosed"; "popupUserMenuOpened": "popupUserMenuOpened"; "showSideBar": "showSideBar"; }, never, never, true, never>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SidebarComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SidebarComponent, "sidebar", never, { "isShowSidebar": { "alias": "isShowSidebar"; "required": true; "isSignal": true; }; "menus": { "alias": "menus"; "required": true; "isSignal": true; }; "userInfo": { "alias": "userInfo"; "required": true; "isSignal": true; }; "sidebar": { "alias": "sidebar"; "required": true; "isSignal": true; }; }, { "expandSideBar": "expandSideBar"; "popupUserMenuClosed": "popupUserMenuClosed"; "popupUserMenuOpened": "popupUserMenuOpened"; "showSideBar": "showSideBar"; }, never, never, true, never>;
 }

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

@@ -1,22 +1,16 @@
-import { EventEmitter } from '@angular/core';
-import { SdLayoutStorageService } from '../../../../services';
-import { ISdLayoutConfiguration } from '../../../../configurations';
+import { SdLayoutUserInfo } from '../../../../configurations';
 import * as i0 from "@angular/core";
 export declare class LayoutUserComponent {
-    private layoutConfig;
-    private layoutStorageService;
-    isMobileOrTablet: boolean;
-    isMenuLock: boolean;
-    isShowSidebar: boolean;
-    menuClosed: EventEmitter<boolean>;
-    menuOpened: EventEmitter<boolean>;
-    toggleMenuLock: EventEmitter<Event>;
-    email: string;
-    username: string;
-    fullName: string;
+    #private;
+    isMobileOrTablet: import("@angular/core").InputSignal<boolean>;
+    isMenuLock: import("@angular/core").InputSignal<boolean>;
+    isShowSidebar: import("@angular/core").InputSignal<boolean>;
+    userInfo: import("@angular/core").InputSignal<SdLayoutUserInfo>;
+    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>;
-    constructor(layoutConfig: ISdLayoutConfiguration, layoutStorageService: SdLayoutStorageService);
+    changePasswordLayoutConfig: (() => void | Promise<void>) | undefined;
     onMenuOpened: () => void;
     onMenuClosed: () => void;
     keepOpenWhenClickInsideMenu: (event: Event) => void;
@@ -24,5 +18,5 @@ export declare class LayoutUserComponent {
     changePassword: () => 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; }; "isMenuLock": { "alias": "isMenuLock"; "required": false; }; "isShowSidebar": { "alias": "isShowSidebar"; "required": false; }; }, { "menuClosed": "menuClosed"; "menuOpened": "menuOpened"; "toggleMenuLock": "toggleMenuLock"; }, never, never, true, 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

@@ -1,24 +1,24 @@
 import { MatSidenav } from '@angular/material/sidenav';
-import { SdLayoutStorageService, SdLayoutMenu } from '../../services';
+import { SdLayoutUserInfo, SidebarConfigurationV1 } from '../../configurations';
+import { SdLayoutMenu } from '../../services';
 import * as i0 from "@angular/core";
-export declare class LayoutSideBarMainV1Component {
+export declare class SidebarV1Component {
     #private;
-    private layoutStorageService;
-    constructor(layoutStorageService: SdLayoutStorageService);
-    sidenav: MatSidenav;
-    menus: SdLayoutMenu[];
-    onhover: boolean;
-    isMenuLock: boolean;
-    isShowSidebar: boolean;
-    isMobileOrTablet: boolean;
-    timerMouseInMenu: ReturnType<typeof setTimeout> | null;
-    timerMouseOutMenu: ReturnType<typeof setTimeout> | null;
+    sidenav: import("@angular/core").Signal<MatSidenav>;
+    menus: import("@angular/core").InputSignal<SdLayoutMenu[]>;
+    userInfo: import("@angular/core").InputSignal<SdLayoutUserInfo>;
+    sidebar: import("@angular/core").InputSignal<SidebarConfigurationV1>;
+    isMobileOrTablet: import("@angular/core").WritableSignal<boolean>;
+    isMenuLock: import("@angular/core").WritableSignal<boolean>;
+    isShowSidebar: import("@angular/core").WritableSignal<boolean>;
+    onhover: import("@angular/core").WritableSignal<boolean>;
+    constructor();
     openSidebar: () => void;
     onPopupOfSideBarOpened: () => void;
     onPopupOfSideBarClosed: () => void;
     onExpandSideBar: () => void;
     onMouseleaveSideBar: () => void;
     onToggle: (data: boolean | null) => void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<LayoutSideBarMainV1Component, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<LayoutSideBarMainV1Component, "lib-layout-sidebar-main-v1", never, { "menus": { "alias": "menus"; "required": false; }; }, {}, never, ["*"], true, never>;
+    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; }; }, {}, never, ["*"], true, never>;
 }

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

@@ -1,16 +1,59 @@
 import { InjectionToken } from '@angular/core';
+import { SdMaybeAsync } from '@sd-angular/core/utilities/models';
 export interface ISdLayoutConfiguration {
     homeUrl?: string;
-    sidebar: ISdSidebarConfiguration | (() => ISdSidebarConfiguration | Promise<ISdSidebarConfiguration>);
+    sidebar: ISdSidebarConfiguration | (() => SdMaybeAsync<ISdSidebarConfiguration>);
+    userInfo: SdLayoutUserInfo | (() => SdMaybeAsync<SdLayoutUserInfo>);
     signout: () => void | Promise<void>;
     changePassword?: () => void | Promise<void>;
 }
-export type ISdSidebarConfiguration = ISidebarConfigurationV1;
-export interface ISidebarConfigurationV1 {
+export interface SdLayoutUserInfo {
+    /**
+     * Tên đăng nhập hoặc tên định danh của người dùng.
+     * Thường dùng làm định danh rút gọn hoặc fallback hiển thị nếu user chưa cập nhật fullName.
+     */
+    username?: string;
+    /**
+     * Địa chỉ thư điện tử của người dùng.
+     * Thường được hiển thị bên dưới tên người dùng trong popup/menu thông tin tài khoản.
+     */
+    email?: string;
+    /**
+     * Họ và tên đầy đủ của người dùng.
+     * Đây là thông tin được ưu tiên hiển thị chính trên giao diện (VD: góc phải màn hình, lời chào).
+     */
+    fullName?: string;
+    /**
+     * Hình đại diện (avatar) của người dùng.
+     * Nếu để trống, hệ thống sẽ tự động lấy ký tự đầu tiên của fullName hoặc username để tạo avatar mặc định.
+     * 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;
+}
+export type ISdSidebarConfiguration = SidebarConfigurationV1;
+export interface SidebarConfigurationV1 {
     version: 1;
+    /**
+     * Màu brand chính.
+     * Nên sử dụng mã màu #HEX hoặc rgb để hỗ trợ opacity khi hover.
+     * Ví dụ: #1890ff, rgb(24,144,255)
+     */
     brandColor?: string;
+    /**
+     * Màu brand nhạt (light).
+     * Dùng cho background, hover nhẹ.
+     */
     brandLightColor?: string;
+    /**
+     * URL logo hiển thị ở sidebar.
+     * Nên đặt trong thư mục public hoặc dùng URL CDN.
+     */
     logoUrl?: string;
+    /**
+     * Title mặc định của hệ thống.
+     * Nếu menu không truyền title thì sẽ dùng giá trị này.
+     * @default "Back Office"
+     */
     defaultTitle?: string;
 }
 export declare const SD_LAYOUT_CONFIGURATION: InjectionToken<ISdLayoutConfiguration>;

package/modules/layout/modules/forbidden/pages/root/root.component.d.ts

@@ -1,14 +1,9 @@
-import { ActivatedRoute } from '@angular/router';
-import { SdLayoutStorageService } from '../../../../services';
 import * as i0 from "@angular/core";
 export declare class RootComponent {
     #private;
-    private route;
-    private layoutStorageService;
-    url: string;
-    email: string;
-    constructor(route: ActivatedRoute, layoutStorageService: SdLayoutStorageService);
-    todayInfo: string;
+    readonly url: import("@angular/core").WritableSignal<string>;
+    readonly todayInfo: import("@angular/core").WritableSignal<string>;
+    userInfo: import("@angular/core").WritableSignal<import("@sd-angular/core/modules/layout").SdLayoutUserInfo | undefined>;
     reload(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<RootComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<RootComponent, "ng-component", never, {}, {}, never, never, true, never>;

package/modules/layout/modules/home/components/home-page/home-page.component.d.ts

@@ -1,11 +1,8 @@
-import { SdLayoutStorageService } from '../../../../services';
 import * as i0 from "@angular/core";
 export declare class HomePageComponent {
     #private;
-    private layoutStorageService;
-    fullName: string;
-    constructor(layoutStorageService: SdLayoutStorageService);
-    todayInfo: string;
+    readonly todayInfo: import("@angular/core").WritableSignal<string>;
+    userInfo: import("@angular/core").WritableSignal<import("@sd-angular/core/modules/layout").SdLayoutUserInfo | undefined>;
     static ɵfac: i0.ɵɵFactoryDeclaration<HomePageComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<HomePageComponent, "app-home-page", never, {}, {}, never, never, true, never>;
 }

package/modules/layout/modules/not-found/pages/root/root.component.d.ts

@@ -1,14 +1,9 @@
-import { ActivatedRoute } from '@angular/router';
-import { SdLayoutStorageService } from '../../../../services';
 import * as i0 from "@angular/core";
 export declare class RootComponent {
     #private;
-    private route;
-    private layoutStorageService;
-    url: string;
-    email: string;
-    constructor(route: ActivatedRoute, layoutStorageService: SdLayoutStorageService);
-    todayInfo: string;
+    readonly url: import("@angular/core").WritableSignal<string>;
+    readonly todayInfo: import("@angular/core").WritableSignal<string>;
+    userInfo: import("@angular/core").WritableSignal<import("@sd-angular/core/modules/layout").SdLayoutUserInfo | undefined>;
     reload(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<RootComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<RootComponent, "ng-component", never, {}, {}, never, never, true, never>;

package/modules/layout/pipes/high-light-search.pipe.d.ts

@@ -2,7 +2,7 @@ import { PipeTransform } from '@angular/core';
 import * as i0 from "@angular/core";
 export declare class HighlightSearchPipe implements PipeTransform {
     #private;
-    transform(value: string, keyword: string, agrs?: {
+    transform(value: string, keyword: string, args?: {
         color?: string;
     }): string;
     static ɵfac: i0.ɵɵFactoryDeclaration<HighlightSearchPipe, never>;

package/modules/layout/services/index.d.ts

@@ -1,2 +1,3 @@
 export * from './menu/menu.model';
 export * from './storage/storage.service';
+export * from './layout.service';

package/modules/layout/services/layout.service.d.ts

@@ -0,0 +1,10 @@
+import { SdLayoutUserInfo } from '../configurations';
+import * as i0 from "@angular/core";
+export declare class SdLayoutService {
+    #private;
+    userInfo: import("@angular/core").WritableSignal<SdLayoutUserInfo | undefined>;
+    sidebar: import("@angular/core").WritableSignal<import("@sd-angular/core/modules/layout").SidebarConfigurationV1 | undefined>;
+    constructor();
+    static ɵfac: i0.ɵɵFactoryDeclaration<SdLayoutService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<SdLayoutService>;
+}

package/modules/layout/services/menu/menu.model.d.ts

@@ -6,6 +6,7 @@ export interface SdLayoutRootMenu {
     path: string;
     queryParams?: Params;
     icon: string;
+    iconUrl?: string;
     title: string;
     permission: string | string[] | boolean | (() => boolean);
     level?: number;
@@ -14,6 +15,7 @@ export interface SdLayoutRootMenu {
 export interface SdLayoutChildrenMenu {
     id?: string;
     icon?: string;
+    iconUrl?: string;
     title?: string;
     children?: (SdLayoutRootMenu | SdLayoutChildrenMenu)[];
     level?: number;

package/modules/layout/services/storage/storage.service.d.ts

@@ -2,9 +2,6 @@ import { SdStorage, SdStorageService } from '@sd-angular/core/services';
 import * as i0 from "@angular/core";
 export declare class SdLayoutStorageService {
     private sdStorageService;
-    email: SdStorage<string>;
-    username: SdStorage<string>;
-    fullName: SdStorage<string>;
     isShowSidebar: SdStorage<boolean>;
     menuLockStatus: SdStorage<boolean>;
     lastActiveMenuGroupId: SdStorage<string>;