@sdcorejs/angular 19.1.6 → 19.2.1

package/i18n/src/i18n.service.d.ts

@@ -1,5 +1,6 @@
 import { Signal } from '@angular/core';
-import { I18nParams, Language } from './i18n.types';
+import { I18nParams } from './i18n.types';
+import { Language } from '@sdcorejs/utils/models';
 import * as i0 from "@angular/core";
 export declare class I18nService {
     #private;

package/i18n/src/i18n.types.d.ts

@@ -1,7 +1,4 @@
 import type { EN_MESSAGES } from './en';
-import { SUPPORTED_LANGUAGES, type Language } from '@sdcorejs/angular/models';
-export { SUPPORTED_LANGUAGES };
-export type { Language };
 export type I18nKey = keyof typeof EN_MESSAGES;
 export type I18nParams = Record<string, string | number>;
 /**

package/interceptors/no-internet/no-internet.interceptor.d.ts

@@ -1,10 +1,20 @@
 import { HttpEvent, HttpHandler, HttpInterceptor, HttpRequest } from '@angular/common/http';
+import { InjectionToken } from '@angular/core';
 import { Observable } from 'rxjs';
 import * as i0 from "@angular/core";
+/**
+ * URL dùng để dò kết nối khi một request trả về status 0.
+ *
+ * why: bản cũ hard-code `https://jsonplaceholder.typicode.com/todos/1`, không override được. Mọi
+ * app tiêu dùng thư viện đều ping một bên thứ ba lạ mỗi 3 giây khi mất mạng, và vì probe đi qua
+ * NGUYÊN chuỗi interceptor của app nên bất kỳ interceptor nào gắn header auth vô điều kiện đều
+ * rò token ra ngoài origin. Mặc định giờ là một đường dẫn same-origin; app đổi bằng cách provide
+ * lại token này (nên trỏ tới endpoint tĩnh, rẻ, không cần auth).
+ */
+export declare const SD_NO_INTERNET_PROBE_URL: InjectionToken<string>;
 export declare class SdNoInternetInterceptor implements HttpInterceptor {
     #private;
     private snackBar;
-    private injector;
     /** Inserted by Angular inject() migration for backwards compatibility */
     constructor(...args: unknown[]);
     intercept(request: HttpRequest<unknown>, next: HttpHandler): Observable<HttpEvent<unknown>>;

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

@@ -1,4 +1,4 @@
-export interface SdAuthInfo<T = any> {
+export interface SdAuthInfo<T = unknown> {
     id?: string;
     username?: string;
     firstName?: string;

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

@@ -2,6 +2,7 @@ import Keycloak from 'keycloak-js';
 import { SdKeycloakTenantConfig } from './keycloak.configuration';
 import * as i0 from "@angular/core";
 export declare class SdKeycloakService {
+    #private;
     keycloak: Keycloak;
     config: SdKeycloakTenantConfig;
     init(config: SdKeycloakTenantConfig): Promise<boolean>;

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

@@ -10,6 +10,8 @@ interface SdLayoutMenuTreeNode {
     isActive: boolean;
     isPinned: boolean;
     isPinVisible: boolean;
+    /** Accessible name of the pin toggle — already i18n-resolved with the menu title interpolated. */
+    pinLabel: string;
 }
 export declare class SdLayoutMenuTreeComponent {
     #private;

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

@@ -2,7 +2,7 @@ import { Params } from '@angular/router';
 import { SdLayoutUserInfo, SidebarConfigurationV1 } from '../../../../configurations';
 import { SdLayoutMenu } from '../../../../services';
 import * as i0 from "@angular/core";
-export declare class SidebarMobileOverlayComponent {
+export declare class SdSidebarMobileOverlay {
     #private;
     isShowSidebar: import("@angular/core").InputSignal<boolean>;
     menus: import("@angular/core").InputSignal<SdLayoutMenu[]>;
@@ -30,6 +30,6 @@ export declare class SidebarMobileOverlayComponent {
     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>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SdSidebarMobileOverlay, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SdSidebarMobileOverlay, "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/main.component.d.ts

@@ -1,7 +1,7 @@
 import { SdLayoutUserInfo, SidebarConfigurationV1 } from '../../configurations';
 import { SdLayoutMenu } from '../../services';
 import * as i0 from "@angular/core";
-export declare class SidebarMobileV1Component {
+export declare class SdSidebarMobileV1 {
     #private;
     menus: import("@angular/core").InputSignal<SdLayoutMenu[]>;
     userInfo: import("@angular/core").InputSignal<SdLayoutUserInfo>;
@@ -16,6 +16,6 @@ export declare class SidebarMobileV1Component {
     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>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SdSidebarMobileV1, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SdSidebarMobileV1, "sd-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-mobile-v2/main.component.d.ts

@@ -1,7 +1,7 @@
 import { SdLayoutUserInfo, SidebarConfigurationV2 } from '../../configurations';
 import { SdLayoutMenu } from '../../services';
 import * as i0 from "@angular/core";
-export declare class SidebarMobileV2Component {
+export declare class SdSidebarMobileV2 {
     #private;
     menus: import("@angular/core").InputSignal<SdLayoutMenu[]>;
     userInfo: import("@angular/core").InputSignal<SdLayoutUserInfo>;
@@ -22,6 +22,6 @@ export declare class SidebarMobileV2Component {
     onSheetKeydown(event: KeyboardEvent): void;
     onNavigate(menu: SdLayoutMenu): void;
     onTogglePinned(menu: SdLayoutMenu): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<SidebarMobileV2Component, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<SidebarMobileV2Component, "sidebar-mobile-v2", 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>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SdSidebarMobileV2, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SdSidebarMobileV2, "sd-sidebar-mobile-v2", 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-mobile-v3/main.component.d.ts

@@ -1,7 +1,7 @@
 import { SdLayoutUserInfo, SidebarConfigurationV3 } from '../../configurations';
 import { SdLayoutMenu, SdLayoutRootMenu } from '../../services';
 import * as i0 from "@angular/core";
-export declare class SidebarMobileV3Component {
+export declare class SdSidebarMobileV3 {
     #private;
     private readonly trigger;
     menus: import("@angular/core").InputSignal<SdLayoutMenu[]>;
@@ -23,6 +23,6 @@ export declare class SidebarMobileV3Component {
     onDrawerKeydown(event: KeyboardEvent): void;
     navigateMenu(menu: SdLayoutMenu): void;
     onTogglePinned(menu: SdLayoutMenu): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<SidebarMobileV3Component, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<SidebarMobileV3Component, "sidebar-mobile-v3", 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>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SdSidebarMobileV3, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SdSidebarMobileV3, "sd-sidebar-mobile-v3", 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

@@ -4,7 +4,7 @@ import { Params } from '@angular/router';
 import { SdLayoutUserInfo, SidebarConfigurationV1 } from '../../../../configurations';
 import { SdLayoutChildrenMenu, SdLayoutMenu } from '../../../../services';
 import * as i0 from "@angular/core";
-export declare class SidebarComponent {
+export declare class SdSidebarV1Panel {
     #private;
     isShowSidebar: import("@angular/core").InputSignal<boolean>;
     menus: import("@angular/core").InputSignal<SdLayoutMenu[]>;
@@ -31,6 +31,19 @@ export declare class SidebarComponent {
     constructor();
     hasChild: (_: number, node: SdLayoutMenu) => boolean;
     onToggleMenuNode: (menu: SdLayoutMenu) => void;
+    menuNodeHref: (node: {
+        path: string;
+        queryParams?: Params;
+    }) => string;
+    onMenuNodeClick: (event: MouseEvent, node: {
+        path: string;
+        queryParams?: Params;
+    }) => void;
+    onMenuNodeKeydown: (event: KeyboardEvent, node: {
+        path: string;
+        queryParams: Params;
+    }) => void;
+    onToggleMenuNodeKeydown: (event: KeyboardEvent, menu: SdLayoutMenu) => void;
     isPinnedNode: (node: SdLayoutMenu) => boolean;
     isHoveredNode: (node: SdLayoutMenu) => boolean;
     expandPinnedGroup: () => void;
@@ -50,6 +63,6 @@ export declare class SidebarComponent {
     onMouseLeaveMenuGroupNode: (event: MouseEvent, menuNode: SdLayoutMenu) => void;
     onMouseOverMenuNode: (event: MouseEvent, menuItem: SdLayoutMenu) => void;
     onMouseLeaveMenuNode: (event: MouseEvent, menuItem: SdLayoutMenu) => void;
-    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; }; "isMobile": { "alias": "isMobile"; "required": false; "isSignal": true; }; }, { "expandSideBar": "expandSideBar"; "popupUserMenuClosed": "popupUserMenuClosed"; "popupUserMenuOpened": "popupUserMenuOpened"; "showSideBar": "showSideBar"; }, never, never, true, never>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SdSidebarV1Panel, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SdSidebarV1Panel, "sd-sidebar-v1-panel", 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; }; "isMobile": { "alias": "isMobile"; "required": false; "isSignal": true; }; }, { "expandSideBar": "expandSideBar"; "popupUserMenuClosed": "popupUserMenuClosed"; "popupUserMenuOpened": "popupUserMenuOpened"; "showSideBar": "showSideBar"; }, never, never, true, never>;
 }

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

@@ -2,7 +2,7 @@ import { MatSidenav } from '@angular/material/sidenav';
 import { SdLayoutUserInfo, SidebarConfigurationV1 } from '../../configurations';
 import { SdLayoutMenu } from '../../services';
 import * as i0 from "@angular/core";
-export declare class SidebarV1Component {
+export declare class SdSidebarV1 {
     #private;
     sidenav: import("@angular/core").Signal<MatSidenav>;
     menus: import("@angular/core").InputSignal<SdLayoutMenu[]>;
@@ -20,6 +20,6 @@ export declare class SidebarV1Component {
     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>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SdSidebarV1, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SdSidebarV1, "sd-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/components/sidebar-v2/main.component.d.ts

@@ -6,7 +6,7 @@ interface SidebarV2RailItem {
     key: string;
     title: string;
 }
-export declare class SidebarV2Component {
+export declare class SdSidebarV2 {
     #private;
     menus: import("@angular/core").InputSignal<SdLayoutMenu[]>;
     userInfo: import("@angular/core").InputSignal<SdLayoutUserInfo>;
@@ -30,7 +30,7 @@ export declare class SidebarV2Component {
     closeFromNavigation(): void;
     onNavigate(menu: SdLayoutMenu): void;
     onTogglePinned(menu: SdLayoutMenu): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<SidebarV2Component, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<SidebarV2Component, "sidebar-v2", 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>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SdSidebarV2, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SdSidebarV2, "sd-sidebar-v2", 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>;
 }
 export {};

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

@@ -1,7 +1,7 @@
 import { SdLayoutUserInfo, SidebarConfigurationV3 } from '../../configurations';
 import { SdLayoutMenu, SdLayoutRootMenu } from '../../services';
 import * as i0 from "@angular/core";
-export declare class SidebarV3Component {
+export declare class SdSidebarV3 {
     #private;
     menus: import("@angular/core").InputSignal<SdLayoutMenu[]>;
     userInfo: import("@angular/core").InputSignal<SdLayoutUserInfo>;
@@ -24,6 +24,6 @@ export declare class SidebarV3Component {
     activateCollapsedMenu(menu: SdLayoutMenu): void;
     navigateMenu(menu: SdLayoutMenu): void;
     onTogglePinned(menu: SdLayoutMenu): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<SidebarV3Component, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<SidebarV3Component, "sidebar-v3", 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>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SdSidebarV3, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SdSidebarV3, "sd-sidebar-v3", 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/modules/forbidden/pages/root/root.component.d.ts

@@ -4,6 +4,11 @@ export declare class RootComponent {
     readonly url: import("@angular/core").WritableSignal<string>;
     readonly todayInfo: import("@angular/core").WritableSignal<string>;
     userInfo: import("@angular/core").WritableSignal<import("@sdcorejs/angular/modules/layout").SdLayoutUserInfo | undefined>;
+    /**
+     * why: `window.location.href = ''` vừa là global thô (throw khi SSR vì không có `window`), vừa chỉ
+     * reload lại đúng trang lỗi này thay vì rời khỏi nó — trong khi nút mang nhãn "Về trang chủ".
+     * Điều hướng bằng Router tới `homeUrl` mà consumer đã khai trong SD_LAYOUT_CONFIGURATION.
+     */
     reload(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<RootComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<RootComponent, "ng-component", never, {}, {}, never, never, true, never>;

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

@@ -4,6 +4,11 @@ export declare class RootComponent {
     readonly url: import("@angular/core").WritableSignal<string>;
     readonly todayInfo: import("@angular/core").WritableSignal<string>;
     userInfo: import("@angular/core").WritableSignal<import("@sdcorejs/angular/modules/layout").SdLayoutUserInfo | undefined>;
+    /**
+     * why: `window.location.href = ''` vừa là global thô (throw khi SSR vì không có `window`), vừa chỉ
+     * reload lại đúng trang lỗi này thay vì rời khỏi nó — trong khi nút mang nhãn "Quay lại trang chủ".
+     * Điều hướng bằng Router tới `homeUrl` mà consumer đã khai trong SD_LAYOUT_CONFIGURATION.
+     */
     reload(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<RootComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<RootComponent, "ng-component", never, {}, {}, never, never, true, never>;

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

@@ -1,9 +1,30 @@
+import { InjectionToken } from '@angular/core';
 import { ISdSidebarConfiguration, SdLayoutUserInfo } from '../configurations';
 import * as i0 from "@angular/core";
+/**
+ * Bật fallback demo của `SdLayoutService` khi KHÔNG provide `SD_LAYOUT_CONFIGURATION`.
+ *
+ * why: fallback cũ chạy ngầm sau mỗi `console.warn`, nên một app cấu hình thiếu vẫn ship được UI có
+ * user "demo@example.com" đang đăng nhập cùng nút signout không làm gì — người dùng cuối tin là đã
+ * đăng nhập thật. Giờ mặc định là throw; ai thực sự cần demo/playground phải khai báo ý định:
+ *
+ * ```ts
+ * providers: [{ provide: SD_LAYOUT_DEMO_FALLBACK, useValue: true }]
+ * ```
+ *
+ * Cờ nằm ở token riêng chứ không phải field của `ISdLayoutConfiguration`, vì nó phải đọc được ĐÚNG
+ * lúc `SD_LAYOUT_CONFIGURATION` vắng mặt — khi đó không có object configuration nào để đọc field.
+ */
+export declare const SD_LAYOUT_DEMO_FALLBACK: InjectionToken<boolean>;
 export declare class SdLayoutService {
     #private;
     userInfo: import("@angular/core").WritableSignal<SdLayoutUserInfo | undefined>;
     sidebar: import("@angular/core").WritableSignal<ISdSidebarConfiguration | undefined>;
+    /**
+     * Route "về trang chủ" của consumer, lấy từ `ISdLayoutConfiguration.homeUrl`.
+     * why: các trang lỗi (forbidden / not-found) cần một đích điều hướng thật thay vì reload chính nó.
+     */
+    readonly homeUrl: string;
     constructor();
     static ɵfac: i0.ɵɵFactoryDeclaration<SdLayoutService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<SdLayoutService>;

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

@@ -1,15 +1,60 @@
+import { InjectionToken } from '@angular/core';
 import { SdStorage } from '@sdcorejs/angular/services';
 import { SdLayoutChildrenMenu, SdLayoutMenu } from '../menu/menu.model';
 import * as i0 from "@angular/core";
+/**
+ * Namespace áp cho toàn bộ state layout được persist — hằng chuỗi, hoặc hàm resolve lại mỗi lần đọc
+ * (dùng cho danh tính chỉ biết được SAU khi đăng nhập, ví dụ id user hoặc tenant).
+ */
+export type SdLayoutStorageNamespace = string | (() => string | null | undefined);
+/**
+ * Namespace do consumer cung cấp cho toàn bộ state layout được persist (thường là id user hoặc tenant).
+ *
+ * why: các key dưới đây là UUID CỐ ĐỊNH, không gắn với ai cả. Trên máy dùng chung, user A đăng xuất
+ * rồi user B đăng nhập thì `pinnedMenuKeys` / `recentMenuKeys` / `lastActiveMenuGroupId` của A vẫn
+ * còn nguyên trong localStorage và B nhìn thấy đúng những module A đã ghim và vừa truy cập. Cấp
+ * namespace theo user/tenant sẽ tách hẳn không gian lưu trữ.
+ *
+ * ⚠️ `SdLayoutStorageService` là singleton `providedIn: 'root'`, thường được khởi tạo TRƯỚC khi biết
+ * người dùng là ai. Vì vậy hãy cấp một **hàm** — nó được gọi lại ở mỗi lần truy cập handle, nên khi
+ * danh tính đến (hoặc đổi) thì cả bảy handle tự dựng lại trên namespace mới:
+ *
+ * ```ts
+ * providers: [
+ *   {
+ *     provide: SD_LAYOUT_STORAGE_NAMESPACE,
+ *     useFactory: () => {
+ *       const auth = inject(SdAuthService);
+ *       return () => auth.getAuthInfo?.()?.id;
+ *     },
+ *   },
+ * ];
+ * ```
+ *
+ * Đây là biện pháp bổ sung chứ không thay thế `SdLayoutStorageService.clear()` lúc signout.
+ */
+export declare const SD_LAYOUT_STORAGE_NAMESPACE: InjectionToken<SdLayoutStorageNamespace>;
 export declare class SdLayoutStorageService {
     #private;
-    readonly isShowSidebar: SdStorage<boolean>;
-    readonly menuLockStatus: SdStorage<boolean>;
-    readonly lastActiveMenuGroupId: SdStorage<string>;
-    readonly pinnedMenuGroup: SdStorage<SdLayoutChildrenMenu>;
-    readonly pinnedMenuKeys: SdStorage<string[]>;
-    readonly recentMenuKeys: SdStorage<string[]>;
-    readonly versionStates: SdStorage<Record<string, SdLayoutVersionState>>;
+    get isShowSidebar(): SdStorage<boolean>;
+    get menuLockStatus(): SdStorage<boolean>;
+    get lastActiveMenuGroupId(): SdStorage<string>;
+    get pinnedMenuGroup(): SdStorage<SdLayoutChildrenMenu>;
+    get pinnedMenuKeys(): SdStorage<string[]>;
+    get recentMenuKeys(): SdStorage<string[]>;
+    get versionStates(): SdStorage<Record<string, SdLayoutVersionState>>;
+    /**
+     * Xoá toàn bộ state layout đã persist.
+     *
+     * **Consumer PHẢI gọi hàm này trong luồng signout, TRƯỚC khi danh tính bị xoá.** Nếu không,
+     * pinned/recent/last-active của user vừa đăng xuất sẽ còn lại trên trình duyệt và hiện ra cho người
+     * đăng nhập kế tiếp — rò rỉ tên module nội bộ mà người đó có thể không có quyền thấy.
+     *
+     * why: khi đã cấu hình `SD_LAYOUT_STORAGE_NAMESPACE` theo user, namespace được resolve NGAY LÚC GỌI.
+     * Gọi `clear()` sau khi auth info về `undefined` sẽ xoá nhầm partition không-namespace, còn dữ liệu
+     * của user vừa thoát thì vẫn nguyên.
+     */
+    clear(): void;
     readPinnedMenuKeys(menus: SdLayoutMenu[]): string[];
     writePinnedMenuKeys(keys: string[]): void;
     readRecentMenuKeys(menus: SdLayoutMenu[], maximum?: number): string[];

package/modules/permission/src/configurations/permission.configuration.d.ts

@@ -46,6 +46,17 @@ export interface ISdPermissionConfiguration {
      * Hỗ trợ trả về đồng bộ, Promise hoặc Observable.
      */
     getToken?: () => MaybeAsync<string | undefined | null>;
+    /**
+     * Cho phép mirror danh sách mã quyền của key này xuống `sessionStorage` để sống qua reload.
+     *
+     * ⚠️ Mặc định `false` — danh sách quyền CHỈ nằm trong bộ nhớ.
+     *
+     * Bật cờ này nghĩa là chấp nhận: mọi script chạy trên cùng origin đều ĐỌC và GHI được danh sách đó.
+     * Cache KHÔNG phải một ranh giới phân quyền — nó chỉ tiết kiệm một lần gọi API khi reload; backend
+     * vẫn phải kiểm tra quyền cho từng request. Khi bật, nhớ gọi `SdPermissionService.reset()` lúc
+     * signout để xoá cả bản mirror.
+     */
+    persistCache?: boolean;
 }
 /**
  * InjectionToken cho cấu hình permission.

package/modules/permission/src/directives/permission.directive.d.ts

@@ -1,7 +1,8 @@
+import { SdPermissionInput } from '../services';
 import * as i0 from "@angular/core";
 export declare class SdPermissionDirective {
     #private;
-    readonly sdPermission: import("@angular/core").InputSignal<string | string[] | null | undefined>;
+    readonly sdPermission: import("@angular/core").InputSignal<SdPermissionInput>;
     readonly sdPermissionKey: import("@angular/core").InputSignal<string | undefined>;
     constructor();
     static ɵfac: i0.ɵɵFactoryDeclaration<SdPermissionDirective, never>;

package/modules/permission/src/services/permission.service.d.ts

@@ -1,11 +1,62 @@
 import * as i0 from "@angular/core";
+/**
+ * Opt-out TƯỜNG MINH: "chỗ này cố ý không yêu cầu quyền nào".
+ *
+ * Dùng cho `route.data.permission`, `[sdPermission]` hoặc `hasPermission(...)` khi một route/phần tử
+ * thật sự công khai. Mọi giá trị rỗng khác (`undefined`, `null`, `''`, `[]`) đều bị coi là CẤU HÌNH
+ * THIẾU và bị từ chối — xem `SdPermissionService.hasPermission`.
+ */
+export declare const SD_PERMISSION_PUBLIC = "__SD_PERMISSION_PUBLIC__";
+/** Kiểu đầu vào cho `hasPermission` / `[sdPermission]`. */
+export type SdPermissionInput = string | string[] | null | undefined;
 export declare class SdPermissionService {
     #private;
     constructor();
     loadPermissions: (key?: string) => Promise<string[]>;
     loadAllPermissions: () => Promise<void>;
-    hasPermission: (permission: string | string[], key?: string) => boolean;
+    /**
+     * Xoá TOÀN BỘ quyền đã nạp (mọi key) — cả map trong bộ nhớ, cờ "đã nạp" lẫn bản mirror
+     * `sessionStorage` của các key bật `persistCache`.
+     *
+     * ⚠️ BẮT BUỘC gọi khi signout. Service là singleton `providedIn: 'root'`, nên trong một SPA
+     * signout → signin (không reload trang) mà không reset thì `loadPermissions()` sẽ short-circuit
+     * theo key đã cache và user MỚI thừa hưởng nguyên bộ quyền của user CŨ.
+     *
+     * ```ts
+     * auth.signout$?.subscribe(() => permissionService.reset());
+     * ```
+     */
+    reset: () => void;
+    /**
+     * Xoá quyền đã nạp của MỘT key (mặc định là key portal `undefined`), buộc lần
+     * `loadPermissions(key)` kế tiếp gọi lại loader. Dùng khi chỉ một profile/tenant đổi quyền;
+     * signout thì dùng {@link reset}.
+     */
+    invalidate: (key?: string) => void;
+    /**
+     * Kiểm tra quyền (OR cho mảng).
+     *
+     * ⚠️ BREAKING: đầu vào rỗng (`undefined` / `null` / `''` / `[]`) giờ trả `false`.
+     * Muốn "không yêu cầu quyền" thì phải nói ra bằng {@link SD_PERMISSION_PUBLIC}.
+     */
+    hasPermission: (permission: SdPermissionInput, key?: string) => boolean;
     getToken: (key?: string) => Promise<string | null | undefined>;
+    /**
+     * Giải mã phần payload của JWT hiện tại và trả về claim **CHƯA ĐƯỢC XÁC THỰC**.
+     *
+     * ⚠️ KHÔNG kiểm chữ ký, KHÔNG kiểm `exp`/`nbf`/`aud`/`iss`. Đây thuần tuý là base64url-decode: bất
+     * kỳ ai cũng tự tạo được một token có claim tuỳ ý và hàm này sẽ vui vẻ trả về. Vì vậy kết quả CHỈ
+     * dùng cho mục đích hiển thị (tên, avatar, tenant đang chọn…) và TUYỆT ĐỐI không được dùng để ra
+     * quyết định phân quyền — quyền phải do backend xác thực chữ ký rồi trả về.
+     *
+     * Trả `null` khi không có token hoặc payload hỏng.
+     */
+    readUnverifiedTokenClaims: <T>(key?: string) => Promise<T | null>;
+    /**
+     * @deprecated Tên `decodeToken` gợi ý một thao tác đã được kiểm chứng, trong khi thực tế payload
+     * hoàn toàn KHÔNG được xác thực. Dùng {@link readUnverifiedTokenClaims} — alias này chỉ còn để
+     * consumer cũ không vỡ và sẽ bị gỡ ở release sau.
+     */
     decodeToken: <T>(key?: string) => Promise<T | null>;
     static ɵfac: i0.ɵɵFactoryDeclaration<SdPermissionService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<SdPermissionService>;

package/package.json

@@ -1,7 +1,24 @@
 {
   "name": "@sdcorejs/angular",
-  "version": "19.1.6",
+  "version": "19.2.1",
+  "description": "Angular component library: data table, query bar/builder, 20+ signal-based form controls, layout, auth and workflow services. Standalone, OnPush, signals-first. Published in parallel lines for Angular 19, 20 and 21.",
+  "keywords": [
+    "angular",
+    "angular-components",
+    "component-library",
+    "ui-components",
+    "angular-material",
+    "signals",
+    "standalone-components",
+    "data-table",
+    "forms",
+    "query-builder"
+  ],
+  "author": "SDCoreJS",
   "license": "MIT",
+  "engines": {
+    "node": ">=20.11.0"
+  },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/sdcorejs/sdcorejs-angular.git"
@@ -11,18 +28,22 @@
     "url": "https://github.com/sdcorejs/sdcorejs-angular/issues"
   },
   "peerDependencies": {
+    "@angular/animations": "^19.0.0 || ^20.0.0 || ^21.0.0",
+    "@angular/cdk": "^19.0.0 || ^20.0.0 || ^21.0.0",
     "@angular/common": "^19.0.0 || ^20.0.0 || ^21.0.0",
     "@angular/core": "^19.0.0 || ^20.0.0 || ^21.0.0",
+    "@angular/forms": "^19.0.0 || ^20.0.0 || ^21.0.0",
     "@angular/material": "^19.0.0 || ^20.0.0 || ^21.0.0",
-    "@angular/material-date-fns-adapter": "^19.0.0 || ^20.0.0 || ^21.0.0"
+    "@angular/material-date-fns-adapter": "^19.0.0 || ^20.0.0 || ^21.0.0",
+    "@angular/platform-browser": "^19.0.0 || ^20.0.0 || ^21.0.0",
+    "@angular/router": "^19.0.0 || ^20.0.0 || ^21.0.0",
+    "rxjs": "^7.8.0"
   },
   "dependencies": {
     "@sdcorejs/angular-material-datetime": "1.0.3",
     "@sdcorejs/utils": "1.1.4",
     "@lucide/angular": "^1.22.0",
     "@ckeditor/ckeditor5-angular": "11.1.2",
-    "@omer-go/docx-parser-converter-ts": "^1.0.0",
-    "@bjorn3/browser_wasi_shim": "^0.4.2",
     "ckeditor5": "48.0.0",
     "chart.js": "^4.5.1",
     "date-fns": "^3.6.0",
@@ -32,7 +53,13 @@
     "prismjs": "^1.30.0",
     "tslib": "^2.8.0"
   },
-  "sideEffects": false,
+  "sideEffects": [
+    "**/*.css",
+    "**/*.scss",
+    "./fesm2022/sdcorejs-angular-components-chart.mjs",
+    "./fesm2022/sdcorejs-angular-components-code-editor.mjs",
+    "./fesm2022/sdcorejs-angular-components-ckeditor-styles.mjs"
+  ],
   "module": "fesm2022/sdcorejs-angular.mjs",
   "typings": "index.d.ts",
   "exports": {
@@ -43,14 +70,14 @@
       "types": "./index.d.ts",
       "default": "./fesm2022/sdcorejs-angular.mjs"
     },
-    "./configurations": {
-      "types": "./configurations/index.d.ts",
-      "default": "./fesm2022/sdcorejs-angular-configurations.mjs"
-    },
     "./components": {
       "types": "./components/index.d.ts",
       "default": "./fesm2022/sdcorejs-angular-components.mjs"
     },
+    "./configurations": {
+      "types": "./configurations/index.d.ts",
+      "default": "./fesm2022/sdcorejs-angular-configurations.mjs"
+    },
     "./directives": {
       "types": "./directives/index.d.ts",
       "default": "./fesm2022/sdcorejs-angular-directives.mjs"
@@ -71,10 +98,6 @@
       "types": "./interceptors/index.d.ts",
       "default": "./fesm2022/sdcorejs-angular-interceptors.mjs"
     },
-    "./models": {
-      "types": "./models/index.d.ts",
-      "default": "./fesm2022/sdcorejs-angular-models.mjs"
-    },
     "./modules": {
       "types": "./modules/index.d.ts",
       "default": "./fesm2022/sdcorejs-angular-modules.mjs"
@@ -95,6 +118,10 @@
       "types": "./components/anchor/index.d.ts",
       "default": "./fesm2022/sdcorejs-angular-components-anchor.mjs"
     },
+    "./components/api-contract-builder": {
+      "types": "./components/api-contract-builder/index.d.ts",
+      "default": "./fesm2022/sdcorejs-angular-components-api-contract-builder.mjs"
+    },
     "./components/audit-diff": {
       "types": "./components/audit-diff/index.d.ts",
       "default": "./fesm2022/sdcorejs-angular-components-audit-diff.mjs"
@@ -111,10 +138,6 @@
       "types": "./components/badge/index.d.ts",
       "default": "./fesm2022/sdcorejs-angular-components-badge.mjs"
     },
-    "./components/base": {
-      "types": "./components/base/index.d.ts",
-      "default": "./fesm2022/sdcorejs-angular-components-base.mjs"
-    },
     "./components/breadcrumb": {
       "types": "./components/breadcrumb/index.d.ts",
       "default": "./fesm2022/sdcorejs-angular-components-breadcrumb.mjs"
@@ -139,10 +162,6 @@
       "types": "./components/data-state/index.d.ts",
       "default": "./fesm2022/sdcorejs-angular-components-data-state.mjs"
     },
-    "./components/document-builder": {
-      "types": "./components/document-builder/index.d.ts",
-      "default": "./fesm2022/sdcorejs-angular-components-document-builder.mjs"
-    },
     "./components/editor": {
       "types": "./components/editor/index.d.ts",
       "default": "./fesm2022/sdcorejs-angular-components-editor.mjs"
@@ -363,18 +382,10 @@
       "types": "./services/confirm/index.d.ts",
       "default": "./fesm2022/sdcorejs-angular-services-confirm.mjs"
     },
-    "./services/docx": {
-      "types": "./services/docx/index.d.ts",
-      "default": "./fesm2022/sdcorejs-angular-services-docx.mjs"
-    },
     "./services/excel": {
       "types": "./services/excel/index.d.ts",
       "default": "./fesm2022/sdcorejs-angular-services-excel.mjs"
     },
-    "./services/license": {
-      "types": "./services/license/index.d.ts",
-      "default": "./fesm2022/sdcorejs-angular-services-license.mjs"
-    },
     "./services/loading": {
       "types": "./services/loading/index.d.ts",
       "default": "./fesm2022/sdcorejs-angular-services-loading.mjs"