@sdcorejs/angular 19.1.6 → 19.2.0

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,11 @@ export declare class SidebarComponent {
     constructor();
     hasChild: (_: number, node: SdLayoutMenu) => boolean;
     onToggleMenuNode: (menu: SdLayoutMenu) => 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 +55,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.0",
+  "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,10 +70,6 @@
       "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"
@@ -55,6 +78,10 @@
       "types": "./directives/index.d.ts",
       "default": "./fesm2022/sdcorejs-angular-directives.mjs"
     },
+    "./configurations": {
+      "types": "./configurations/index.d.ts",
+      "default": "./fesm2022/sdcorejs-angular-configurations.mjs"
+    },
     "./forms": {
       "types": "./forms/index.d.ts",
       "default": "./fesm2022/sdcorejs-angular-forms.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"
@@ -111,10 +134,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 +158,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 +378,6 @@
       "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"
@@ -383,6 +386,10 @@
       "types": "./services/notify/index.d.ts",
       "default": "./fesm2022/sdcorejs-angular-services-notify.mjs"
     },
+    "./services/excel": {
+      "types": "./services/excel/index.d.ts",
+      "default": "./fesm2022/sdcorejs-angular-services-excel.mjs"
+    },
     "./services/persistence": {
       "types": "./services/persistence/index.d.ts",
       "default": "./fesm2022/sdcorejs-angular-services-persistence.mjs"

package/pipes/src/safe-html.pipe.d.ts

@@ -1,10 +1,32 @@
 import { PipeTransform } from '@angular/core';
+import { SafeHtml } from '@angular/platform-browser';
 import * as i0 from "@angular/core";
+/**
+ * Render an HTML string through `[innerHTML]`.
+ *
+ * why: this pipe used to call `bypassSecurityTrustHtml()` unconditionally, on every value, with no
+ * sanitize step. That turned every call site into a stored-XSS sink — and the library itself pipes
+ * server-supplied table cell data through it
+ * (`components/table/src/components/desktop-cell/view/view.component.html`), while
+ * `components/table/sd-table.md` already described the value as "sanitized via sdSafeHtml".
+ *
+ * Now it **sanitizes by default** and the bypass is an explicit, per-call-site opt-in:
+ *
+ * ```html
+ * <!-- untrusted / server-supplied: script, on* handlers and javascript: urls are stripped -->
+ * <div [innerHTML]="row.note | sdSafeHtml"></div>
+ *
+ * <!-- app-authored markup you control, e.g. an inline SVG sprite -->
+ * <span [innerHTML]="iconSvg | sdSafeHtml: true"></span>
+ * ```
+ *
+ * This mirrors the decision already taken for the toast in `services/notify`: text-safe by default,
+ * opt-in HTML. Auto-detecting "this looks like HTML" is deliberately NOT done — it would escalate
+ * untrusted text that merely contains `<` straight back into the unsanitized sink.
+ */
 export declare class SdSafeHtmlPipe implements PipeTransform {
-    private sanitizer;
-    /** Inserted by Angular inject() migration for backwards compatibility */
-    constructor(...args: unknown[]);
-    transform(html: string | number | undefined | null): import("@angular/platform-browser").SafeHtml | undefined;
+    #private;
+    transform(html: string | number | undefined | null, trusted?: boolean): SafeHtml | string | number | undefined;
     static ɵfac: i0.ɵɵFactoryDeclaration<SdSafeHtmlPipe, never>;
     static ɵpipe: i0.ɵɵPipeDeclaration<SdSafeHtmlPipe, "sdSafeHtml", true>;
     static ɵprov: i0.ɵɵInjectableDeclaration<SdSafeHtmlPipe>;

package/pipes/src/time-different.pipe.d.ts

@@ -2,6 +2,7 @@ import { PipeTransform } from '@angular/core';
 import { Observable } from 'rxjs';
 import * as i0 from "@angular/core";
 export declare class SdTimeDifferentPipe implements PipeTransform {
+    #private;
     private maxSecond;
     private maxMinute;
     private maxHour;

package/public-api.d.ts

@@ -1,10 +1,11 @@
-import '@sdcorejs/angular/configurations';
-import '@sdcorejs/angular/utilities';
-import '@sdcorejs/angular/pipes';
-import '@sdcorejs/angular/directives';
-import '@sdcorejs/angular/services';
-import '@sdcorejs/angular/interceptors';
-import '@sdcorejs/angular/handlers';
-import '@sdcorejs/angular/components';
-import '@sdcorejs/angular/forms';
-import '@sdcorejs/angular/modules';
+export * from '@sdcorejs/angular/configurations';
+export * from '@sdcorejs/angular/i18n';
+export * from '@sdcorejs/angular/utilities';
+export * from '@sdcorejs/angular/pipes';
+export * from '@sdcorejs/angular/directives';
+export * from '@sdcorejs/angular/services';
+export * from '@sdcorejs/angular/interceptors';
+export * from '@sdcorejs/angular/handlers';
+export * from '@sdcorejs/angular/components';
+export * from '@sdcorejs/angular/forms';
+export * from '@sdcorejs/angular/modules';

package/services/api/src/api-host.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Handler nào chịu trách nhiệm cho `url`?
+ *
+ * why: trước đây là `url.startsWith(host)` — so chuỗi thô. Với host `https://api.example.com`,
+ * url `https://api.example.com.attacker.tld/x` cũng "khớp", nên handler chạy `intercept` cho host
+ * giả mạo đó và gắn luôn header auth mà nó đính kèm. `sdMatchesSecureRoute` parse URL rồi so
+ * origin + path prefix theo segment, nên `.attacker.tld` khác origin → không khớp, và
+ * `/api/v1beta` không bị coi là nằm dưới `/api/v1`.
+ *
+ * Việc chọn base origin khi không có `window.location` (SSR/prerender) do
+ * `sdResolveBaseOrigin` trong `url-safety` lo — trước đây file này tự giữ một origin giả riêng,
+ * nhưng `SdKeycloakInterceptor` lại không có, nên nó âm thầm ngừng đính token trên server. Logic
+ * đó giờ nằm ở helper chung để mọi call site cùng hành xử.
+ */
+export declare function sdApiMatchesHandlerHosts(url: string, hosts: readonly string[] | undefined): boolean;

package/services/api/src/api.model.d.ts

@@ -72,4 +72,18 @@ export interface ISdApiConfiguration {
 export declare const SD_API_CONFIG: InjectionToken<ISdApiConfiguration>;
 /** @deprecated Use `SD_API_CONFIG`. This is the same injection token. */
 export declare const SD_API_CONFIGURATION: InjectionToken<ISdApiConfiguration>;
+/**
+ * Lỗi nghiệp vụ: HTTP 200 nhưng body envelope báo thất bại (`{ ok: false, ... }`).
+ *
+ * why: trước đây `SdApiService` `throw body` — một plain object. Hệ quả: `error instanceof Error`
+ * là `false`, `error.message` là `undefined`, nên mọi `catch` của consumer và predicate
+ * `retry.retryWhen` đều bỏ sót nhánh này. Bọc vào một Error thật để envelope lỗi đi chung
+ * đường với lỗi HTTP; body gốc vẫn giữ nguyên ở `.body`.
+ */
+export declare class SdApiError<TBody = unknown> extends Error {
+    readonly name = "SdApiError";
+    /** Body nguyên bản của response (đúng object server trả về). */
+    readonly body: TBody;
+    constructor(body: TBody, message?: string);
+}
 export {};