@sd-angular/core 19.0.0-beta.1 → 19.0.0-beta.100

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

@@ -0,0 +1,17 @@
+import { Signal } from '@angular/core';
+import { Observable } from 'rxjs';
+import { ISdAuthConfiguration } from '../configurations';
+import { SdAuthInfo } from './auth.model';
+import * as i0 from "@angular/core";
+export declare class SdAuthService {
+    #private;
+    private authConfiguration;
+    getAuthInfo?: Signal<SdAuthInfo | undefined>;
+    signout$?: Observable<void>;
+    changePassword$?: Observable<void>;
+    constructor(authConfiguration: ISdAuthConfiguration);
+    signout: () => void;
+    changePassword: () => void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SdAuthService, [{ optional: true; }]>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<SdAuthService>;
+}

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

@@ -0,0 +1,2 @@
+export * from './auth.model';
+export * from './auth.service';

package/modules/authom/authom.configuration.d.ts

@@ -0,0 +1,17 @@
+import { InjectionToken } from '@angular/core';
+export interface SdAuthOmTenantConfig {
+    domain: string;
+    clientId: string;
+    redirectUri?: string;
+    audience?: string;
+    organization?: string;
+    scope?: string;
+    secureRoutes?: string[];
+    silentRefreshRedirectUri?: string;
+    refreshThresholdSeconds?: number;
+    authorizeTimeoutInSeconds?: number;
+}
+export interface ISdAuthOmConfiguration {
+    loadTenantConfig: () => Promise<SdAuthOmTenantConfig>;
+}
+export declare const SD_AUTHOM_CONFIGURATION: InjectionToken<ISdAuthOmConfiguration>;

package/modules/authom/authom.interceptor.d.ts

@@ -0,0 +1,3 @@
+import { HttpInterceptorFn } from '@angular/common/http';
+export declare const matchGlob: (pattern: string, url: string) => boolean;
+export declare const SdAuthOmInterceptor: HttpInterceptorFn;

package/modules/authom/authom.module.d.ts

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

package/modules/authom/authom.service.d.ts

@@ -0,0 +1,32 @@
+import { SdAuthOmTenantConfig } from './authom.configuration';
+import * as i0 from "@angular/core";
+export declare class SdAuthOmService {
+    private readonly platformId;
+    private readonly isBrowser;
+    readonly accessToken: import("@angular/core").WritableSignal<string | null>;
+    readonly idTokenClaims: import("@angular/core").WritableSignal<Record<string, unknown> | null>;
+    readonly isAuthenticated: import("@angular/core").Signal<boolean>;
+    config: SdAuthOmTenantConfig;
+    private refreshTimer;
+    getAccessToken(): string | null;
+    private base64UrlEncode;
+    private generateCodeVerifier;
+    private generateCodeChallenge;
+    private buildAuthorizeUrl;
+    private getDefaultRedirectUri;
+    private getSilentRedirectUri;
+    private decodeJwtPayload;
+    login(options?: {
+        returnTo?: string;
+    }): Promise<void>;
+    logout(options?: {
+        returnTo?: string;
+    }): void;
+    private exchangeCode;
+    private scheduleRefresh;
+    silentRefresh(): Promise<boolean>;
+    handleCallback(): Promise<boolean>;
+    init(config: SdAuthOmTenantConfig): Promise<boolean>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SdAuthOmService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<SdAuthOmService>;
+}

package/modules/authom/index.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Module `authom` — OAuth 2.0 + PKCE authentication client cho AuthOM (Auth0-based).
+ *
+ * Cách dùng (standalone):
+ * ```ts
+ * import { provideHttpClient, withInterceptors } from '@angular/common/http';
+ * import { provideSdAuthOm, SdAuthOmInterceptor } from '@sd-angular/core/modules/authom';
+ *
+ * export const appConfig: ApplicationConfig = {
+ *   providers: [
+ *     provideHttpClient(withInterceptors([SdAuthOmInterceptor])),
+ *     provideSdAuthOm({
+ *       useFactory: () => ({
+ *         loadTenantConfig: () => Promise.resolve({
+ *           domain: 'login.example.com',
+ *           clientId: 'YOUR_CLIENT_ID',
+ *           audience: 'https://api.example.com',
+ *           organization: 'org_xxx',
+ *           scope: 'openid profile email offline_access',
+ *           secureRoutes: ['https://api.example.com/*'],
+ *         }),
+ *       }),
+ *     }),
+ *   ],
+ * };
+ * ```
+ *
+ * Yêu cầu setup thêm:
+ * 1. Copy file `silent-authom.html` từ source module này vào thư mục `public/` của app.
+ * 2. App phải chạy trên HTTPS (hoặc localhost) — Web Crypto API yêu cầu secure context.
+ */
+export * from './authom.configuration';
+export * from './authom.service';
+export * from './authom.interceptor';
+export * from './authom.module';

package/modules/index.d.ts

@@ -1,3 +1,5 @@
-export * from '@sd-angular/core/modules/oidc';
+export * from '@sd-angular/core/modules/keycloak';
 export * from '@sd-angular/core/modules/permission';
+export * from '@sd-angular/core/modules/auth';
 export * from '@sd-angular/core/modules/layout';
+export * from '@sd-angular/core/modules/authom';

package/modules/keycloak/index.d.ts

@@ -0,0 +1,4 @@
+export * from './keycloak.configuration';
+export * from './keycloak.service';
+export * from './keycloak.interceptor';
+export * from './keycloak.module';

package/modules/keycloak/keycloak.configuration.d.ts

@@ -0,0 +1,11 @@
+import { InjectionToken } from '@angular/core';
+export interface SdKeycloakTenantConfig {
+    url: string;
+    realm: string;
+    clientId: string;
+    secureRoutes?: string[];
+}
+export interface ISdKeycloakConfiguration {
+    loadTenantConfig: () => Promise<SdKeycloakTenantConfig>;
+}
+export declare const SD_KEYCLOAK_CONFIGURATION: InjectionToken<ISdKeycloakConfiguration>;

package/modules/keycloak/keycloak.interceptor.d.ts

@@ -0,0 +1,2 @@
+import { HttpInterceptorFn } from '@angular/common/http';
+export declare const SdKeycloakInterceptor: HttpInterceptorFn;

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/index.d.ts

@@ -1,2 +1,4 @@
 export * from './page/page.component';
 export * from './layout-main/layout-main.component';
+export * from './sidebar-mobile-v1/main.component';
+export * from './sidebar-mobile-v1/components/sidebar/sidebar.component';

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

@@ -1,16 +1,12 @@
-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>;
+    isMobileOrTablet: import("@angular/core").WritableSignal<boolean>;
     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-mobile-v1/components/sidebar/sidebar.component.d.ts

@@ -0,0 +1,35 @@
+import { Params } from '@angular/router';
+import { SdLayoutUserInfo, SidebarConfigurationV1 } from '../../../../configurations';
+import { SdLayoutMenu } from '../../../../services';
+import * as i0 from "@angular/core";
+export declare class SidebarMobileOverlayComponent {
+    #private;
+    isShowSidebar: import("@angular/core").InputSignal<boolean>;
+    menus: import("@angular/core").InputSignal<SdLayoutMenu[]>;
+    userInfo: import("@angular/core").InputSignal<SdLayoutUserInfo>;
+    sidebar: import("@angular/core").InputSignal<SidebarConfigurationV1>;
+    showSideBar: import("@angular/core").OutputEmitterRef<boolean | null>;
+    expandSideBar: import("@angular/core").OutputEmitterRef<void>;
+    popupUserMenuOpened: import("@angular/core").OutputEmitterRef<void>;
+    popupUserMenuClosed: import("@angular/core").OutputEmitterRef<void>;
+    titleMenuGroupChanged: import("@angular/core").OutputEmitterRef<string | undefined>;
+    titleMenuGroup: import("@angular/core").WritableSignal<string | undefined>;
+    currentPath: import("@angular/core").WritableSignal<string>;
+    expandedMobileGroups: import("@angular/core").WritableSignal<Set<string>>;
+    constructor();
+    toggleMobileGroup(groupId: string | undefined): void;
+    isExpanded(groupId: string | undefined): boolean;
+    navigate(args: {
+        path?: string;
+        queryParams?: Params;
+    }): void;
+    onClose(): void;
+    hasChildren(menu: SdLayoutMenu): boolean;
+    getChildren(menu: SdLayoutMenu): SdLayoutMenu[];
+    getPath(menu: SdLayoutMenu): string | undefined;
+    getQueryParams(menu: SdLayoutMenu): Params;
+    onUserMenuOpened: () => void;
+    onUserMenuClosed: () => void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SidebarMobileOverlayComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SidebarMobileOverlayComponent, "sd-sidebar-mobile-overlay", never, { "isShowSidebar": { "alias": "isShowSidebar"; "required": false; "isSignal": true; }; "menus": { "alias": "menus"; "required": true; "isSignal": true; }; "userInfo": { "alias": "userInfo"; "required": true; "isSignal": true; }; "sidebar": { "alias": "sidebar"; "required": true; "isSignal": true; }; }, { "showSideBar": "showSideBar"; "expandSideBar": "expandSideBar"; "popupUserMenuOpened": "popupUserMenuOpened"; "popupUserMenuClosed": "popupUserMenuClosed"; "titleMenuGroupChanged": "titleMenuGroupChanged"; }, never, never, true, never>;
+}

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

@@ -0,0 +1,24 @@
+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>;
+    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>) | 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;
+    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-mobile-v1/main.component.d.ts

@@ -0,0 +1,21 @@
+import { SdLayoutUserInfo, SidebarConfigurationV1 } from '../../configurations';
+import { SdLayoutMenu } from '../../services';
+import * as i0 from "@angular/core";
+export declare class SidebarMobileV1Component {
+    #private;
+    menus: import("@angular/core").InputSignal<SdLayoutMenu[]>;
+    userInfo: import("@angular/core").InputSignal<SdLayoutUserInfo>;
+    sidebar: import("@angular/core").InputSignal<SidebarConfigurationV1>;
+    isShowSidebar: import("@angular/core").WritableSignal<boolean>;
+    titleMenuGroup: import("@angular/core").WritableSignal<string | undefined>;
+    constructor();
+    openSidebar: () => void;
+    onToggle: (_data: boolean | null) => void;
+    onPopupOfSideBarOpened: () => void;
+    onPopupOfSideBarClosed: () => void;
+    onExpandSideBar: () => void;
+    onMouseleaveSideBar: () => void;
+    onTitleMenuGroupChanged: (title: string | undefined) => void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SidebarMobileV1Component, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SidebarMobileV1Component, "sidebar-mobile-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/components/sidebar-v1/components/sidebar/sidebar.component.d.ts

@@ -1,40 +1,40 @@
 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 { SdLayoutChildrenMenu, 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[]>;
+    pinnedMenuGroup: import("@angular/core").WritableSignal<SdLayoutChildrenMenu>;
+    totalMenuInMenusByGroup: import("@angular/core").Signal<number>;
+    pinnedNodeKeys: import("@angular/core").Signal<Set<string>>;
+    isPinnedMenuGroupActive: import("@angular/core").Signal<boolean>;
     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;
+    isPinnedNode: (node: SdLayoutMenu) => boolean;
+    isHoveredNode: (node: SdLayoutMenu) => boolean;
+    expandPinnedGroup: () => void;
+    onTogglePin: (event: MouseEvent, node: SdLayoutMenu) => void;
     toggleMenuLock(event: Event): void;
     openHomePage: () => void;
     onUserMenuClosed: () => void;
@@ -50,6 +50,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,67 @@
 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;
+    /**
+     * Cấu hình tính năng ghim menu.
+     * - `enabled`: bật/tắt tính năng ghim.
+     * Hệ thống mặc định là false
+     */
+    pin?: {
+        enabled?: boolean;
+    };
 }
 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,33 @@
-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>;
+    readonly features: readonly [{
+        readonly icon: "storage";
+        readonly key: "core.module.layout.home.feature.data";
+        readonly area: "data";
+    }, {
+        readonly icon: "insights";
+        readonly key: "core.module.layout.home.feature.reports";
+        readonly area: "report";
+    }, {
+        readonly icon: "group";
+        readonly key: "core.module.layout.home.feature.users";
+        readonly area: "users";
+    }, {
+        readonly icon: "schema";
+        readonly key: "core.module.layout.home.feature.workflow";
+        readonly area: "flow";
+    }, {
+        readonly icon: "verified_user";
+        readonly key: "core.module.layout.home.feature.audit";
+        readonly area: "audit";
+    }, {
+        readonly icon: "hub";
+        readonly key: "core.module.layout.home.feature.integration";
+        readonly area: "integ";
+    }];
     static ɵfac: i0.ɵɵFactoryDeclaration<HomePageComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<HomePageComponent, "app-home-page", never, {}, {}, never, never, true, never>;
 }