@sdcorejs/angular 20.1.5 → 20.2.0

package/i18n/index.d.ts

@@ -1,5 +1,4 @@
-import { Language } from '@sdcorejs/angular/models';
-export { Language, SUPPORTED_LANGUAGES } from '@sdcorejs/angular/models';
+import { Language } from '@sdcorejs/utils/models';
 import * as i0 from '@angular/core';
 import { Signal, PipeTransform } from '@angular/core';
 
@@ -85,9 +84,6 @@ declare const EN_MESSAGES: {
     readonly 'core.interceptor.no-internet.restored': "Connection restored.";
     readonly 'core.excel.cannot-read-file': "Could not read file content";
     readonly 'core.excel.no-sheet': "Excel file has no data sheet";
-    readonly 'core.docx.invalid-format': "Invalid format. Please select a template in DOC or DOCX format";
-    readonly 'core.docx.size-exceeded': "Template file size exceeds the supported limit. Please try again";
-    readonly 'core.docx.convert-error': "An error occurred while converting the DOCX file";
     readonly 'core.notify.type.success': "Success";
     readonly 'core.notify.type.info': "Information";
     readonly 'core.notify.type.warning': "Warning";
@@ -184,7 +180,6 @@ declare const EN_MESSAGES: {
     readonly 'core.form.time-range.step': "Times must align to a {step}-minute interval";
     readonly 'core.form.time-range.from': "From";
     readonly 'core.form.time-range.to': "To";
-    readonly 'core.form.time-range.clear': "Clear time range";
     readonly 'core.form.time-spinner.hour': "Hour";
     readonly 'core.form.time-spinner.minute': "Minute";
     readonly 'core.form.time-spinner.second': "Second";
@@ -203,6 +198,7 @@ declare const EN_MESSAGES: {
     readonly 'core.form.checkbox.checked': "Yes";
     readonly 'core.form.checkbox.unchecked': "No";
     readonly 'core.form.select.required': "Please enter information";
+    readonly 'core.form.select.selectAll': "All";
     readonly 'core.form.textarea.required': "Please enter information";
     readonly 'core.form.textarea.maxlength': "Maximum characters: {max}";
     readonly 'core.form.textarea.invalid-pattern': "Invalid format";
@@ -216,12 +212,6 @@ declare const EN_MESSAGES: {
     readonly 'core.component.editor.image.max-width': "Image width {width}px exceeds the limit of {max}px";
     readonly 'core.component.editor.image.max-height': "Image height {height}px exceeds the limit of {max}px";
     readonly 'core.component.editor.image.max-per-selection': "You can select at most {max} images per selection";
-    readonly 'core.component.document-builder.page-number.current': "Current page number";
-    readonly 'core.component.document-builder.page-number.total': "Total pages";
-    readonly 'core.component.document-builder.ck-comment.label': "Comment";
-    readonly 'core.component.document-builder.ck-comment.text-too-long': "Text too long ({length} characters). Maximum {max} characters.";
-    readonly 'core.component.document-builder.variable.not-allowed': "Adding variable to the text is not allowed";
-    readonly 'core.component.document-builder.variable.invalid-data': "Invalid variable data";
     readonly 'core.component.form-builder.field-key': "Field key";
     readonly 'core.component.form-builder.display': "Display";
     readonly 'core.component.form-builder.general': "General";
@@ -235,6 +225,7 @@ declare const EN_MESSAGES: {
     readonly 'core.component.form-builder.required-when': "Required when";
     readonly 'core.component.form-builder.confirm': "Confirm";
     readonly 'core.component.form-builder.delete': "Delete";
+    readonly 'core.component.form-builder.select-item': "Select to edit";
     readonly 'core.component.form-builder.save': "Save";
     readonly 'core.component.form-builder.hint': "Hint";
     readonly 'core.component.form-builder.parameter': "Parameters";
@@ -306,9 +297,13 @@ declare const EN_MESSAGES: {
     readonly 'core.component.form-builder.display-label': "Display label";
     readonly 'core.component.form-builder.attribute': "Attribute";
     readonly 'core.component.form-builder.add-variable': "Add variable";
+    readonly 'core.component.form-builder.no-variable': "No variables yet. Add one to use it in condition expressions.";
+    readonly 'core.component.form-builder.no-validation': "No validations yet. Add one to show a warning or an error on a condition.";
     readonly 'core.component.form-builder.add-new': "Add new";
     readonly 'core.component.form-builder.detail': "Details";
     readonly 'core.component.form-builder.create-update': "Create/update";
+    readonly 'core.component.form-builder.update-row': "Update row";
+    readonly 'core.component.form-builder.add-row': "Add row";
     readonly 'core.component.form-builder.default': "Default";
     readonly 'core.component.form-builder.show-more': "Show more";
     readonly 'core.component.form-builder.show-less': "Show less";
@@ -465,6 +460,8 @@ declare const EN_MESSAGES: {
     readonly 'core.component.table.choose-filter-hint': "Please choose a filter to start";
     readonly 'core.component.table.no-data': "No data";
     readonly 'core.component.table.export-excel': "Export Excel";
+    readonly 'core.component.table.exporting': "Exporting...{percent}%";
+    readonly 'core.component.table.export': "Export";
     readonly 'core.component.table.export-csv': "Export CSV";
     readonly 'core.component.table.showing': "Showing:";
     readonly 'core.component.table.paginator.first-page': "First page";
@@ -475,6 +472,8 @@ declare const EN_MESSAGES: {
     readonly 'core.component.table.error-occurred': "An error occurred";
     readonly 'core.component.table.not-an-array': "Data is not an array";
     readonly 'core.component.table.config.confirm-reset': "Confirm reset all settings to defaults";
+    readonly 'core.component.table.config.drag-hint': "Drag the ⠿ handle to reorder columns";
+    readonly 'core.component.table.config.drag-handle': "Drag to reorder column";
     readonly 'core.component.table.popup-export.select-columns': "Please select columns to export";
     readonly 'core.component.table.selector-action.default-msg': "items selected";
     readonly 'core.component.tab-router.too-many-tabs': "You have opened too many tabs.";
@@ -503,6 +502,13 @@ declare const EN_MESSAGES: {
     readonly 'core.module.layout.user.notification': "Notifications";
     readonly 'core.module.layout.sidebar.search': "Search";
     readonly 'core.module.layout.sidebar.toggle': "Toggle sidebar";
+    readonly 'core.module.layout.sidebar.menu-groups': "Menu groups";
+    readonly 'core.module.layout.sidebar.close-menu': "Close menu";
+    readonly 'core.module.layout.sidebar.search-in-group': "Search this group";
+    readonly 'core.module.layout.sidebar.primary-nav': "Primary navigation";
+    readonly 'core.module.layout.sidebar.more-menu': "More menus";
+    readonly 'core.module.layout.sidebar.more': "More";
+    readonly 'core.module.layout.sidebar.search-in-menu': "Search menus";
     readonly 'core.module.layout.greeting.hello': "Hello, {name}";
     readonly 'core.module.layout.weekday.0': "Sunday";
     readonly 'core.module.layout.weekday.1': "Monday";
@@ -519,6 +525,8 @@ declare const EN_MESSAGES: {
     readonly 'core.module.layout.not-found.message': "The page you're looking for doesn't exist or has been removed. Please check the URL or go back to the home page to continue.";
     readonly 'core.module.layout.not-found.back': "Go back";
     readonly 'core.module.layout.home.tab-name': "Home";
+    readonly 'core.module.layout.not-found.tab-name': "Page Not Found";
+    readonly 'core.module.layout.forbidden.tab-name': "Access Denied";
     readonly 'core.module.layout.home.feature.data': "Data";
     readonly 'core.module.layout.home.feature.reports': "Reports";
     readonly 'core.module.layout.home.feature.users': "Users";
@@ -527,6 +535,81 @@ declare const EN_MESSAGES: {
     readonly 'core.module.layout.home.feature.integration': "Integration";
     readonly 'core.module.layout.mock.user.full-name': "Demo User";
     readonly 'core.module.generic.generic-select.detail-link': "details";
+    readonly 'core.component.query-bar.search-placeholder': "Search...";
+    readonly 'core.component.query-bar.no-fields': "No fields configured";
+    readonly 'core.component.query-bar.add-filter': "Add filter";
+    readonly 'core.component.query-bar.clear-all': "Clear all ({count})";
+    readonly 'core.component.query-bar.search': "Search";
+    readonly 'core.component.query-bar.logic-operator': "Logic operator";
+    readonly 'core.component.query-bar.boolean.true': "Yes";
+    readonly 'core.component.query-bar.boolean.false': "No";
+    readonly 'core.component.query-bar.placeholder.value': "value";
+    readonly 'core.component.query-bar.placeholder.text': "type…";
+    readonly 'core.component.query-bar.placeholder.from-number': "From";
+    readonly 'core.component.query-bar.placeholder.to-number': "To";
+    readonly 'core.component.query-bar.placeholder.from-text': "from…";
+    readonly 'core.component.query-bar.placeholder.to-text': "to…";
+    readonly 'core.component.query-bar.swap-field': "Swap field";
+    readonly 'core.component.query-bar.placeholder.select-value': "Select value";
+    readonly 'core.component.query-bar.placeholder.enter-value': "Enter value";
+    readonly 'core.component.query-bar.loading-values': "Loading...";
+    readonly 'core.component.query-bar.field-empty': "No fields configured yet.";
+    readonly 'core.component.query-bar.saved-filters.tooltip': "Saved filters";
+    readonly 'core.component.query-bar.saved-filters.tooltip-disabled': "Requires [savedFiltersKey] to enable";
+    readonly 'core.component.query-bar.saved-filters.delete': "Delete filter";
+    readonly 'core.component.query-bar.saved-filters.empty': "No saved filters yet.";
+    readonly 'core.component.query-bar.saved-filters.save': "Save current filter";
+    readonly 'core.component.query-bar.saved-filters.name-label': "Filter name";
+    readonly 'core.component.query-builder.date-mode.absolute': "Specific date";
+    readonly 'core.component.query-builder.date-mode.now': "Today";
+    readonly 'core.component.query-builder.date-mode.relative': "Relative";
+    readonly 'core.component.query-builder.value-source.literal': "Enter a value";
+    readonly 'core.component.query-builder.value-source.field': "Compare with field";
+    readonly 'core.component.query-builder.relative.hour-previous': "hours ago";
+    readonly 'core.component.query-builder.relative.hour-next': "hours from now";
+    readonly 'core.component.query-builder.relative.day-previous': "days ago";
+    readonly 'core.component.query-builder.relative.day-next': "days from now";
+    readonly 'core.component.query-builder.relative.week-previous': "weeks ago";
+    readonly 'core.component.query-builder.relative.week-next': "weeks from now";
+    readonly 'core.component.query-builder.relative.month-previous': "months ago";
+    readonly 'core.component.query-builder.relative.month-next': "months from now";
+    readonly 'core.component.query-builder.relative.format': "{amount} {phrase}";
+    readonly 'core.component.query-builder.add': "Add";
+    readonly 'core.component.query-builder.add-node': "Add a condition or group";
+    readonly 'core.component.query-builder.condition': "Condition";
+    readonly 'core.component.query-builder.group': "Group";
+    readonly 'core.component.query-builder.remove-group': "Remove group";
+    readonly 'core.component.query-builder.remove-condition': "Remove condition";
+    readonly 'core.component.query-builder.empty': "No conditions yet";
+    readonly 'core.component.query-builder.select-field': "Select field";
+    readonly 'core.component.query-builder.value': "Value";
+    readonly 'core.component.query-builder.from': "From";
+    readonly 'core.component.query-builder.to': "To";
+    readonly 'core.component.query-builder.boolean.true': "Yes";
+    readonly 'core.component.query-builder.boolean.false': "No";
+    readonly 'core.component.tree.selected-count': "{count} item(s) selected";
+    readonly 'core.component.tree.expand': "Expand tree item";
+    readonly 'core.component.tree.collapse': "Collapse tree item";
+    readonly 'core.component.tree.retry-item': "Retry loading tree item";
+    readonly 'core.component.tree.load-error': "Unable to load tree data";
+    readonly 'core.directive.hover-copy.copied': "Copied";
+    readonly 'core.module.layout.sidebar.pinned': "Pinned";
+    readonly 'core.module.layout.sidebar.recent': "Recent";
+    readonly 'core.module.layout.sidebar.all-menu': "All menus";
+    readonly 'core.module.layout.menu.pin': "Pin {title}";
+    readonly 'core.module.layout.menu.unpin': "Unpin {title}";
+    readonly 'core.form.date.open-picker': "Open calendar";
+    readonly 'core.form.datetime.open-picker': "Open calendar";
+    readonly 'core.form.date-range.open-picker': "Open calendar";
+    readonly 'core.form.date-range.clear': "Clear date range";
+    readonly 'core.form.select.search': "Search";
+    readonly 'core.component.table.loading': "Loading table data";
+    readonly 'core.component.upload-file.loading': "Uploading file";
+    readonly 'core.component.import-excel.loading': "Loading data";
+    readonly 'core.component.upload-file.remove': "Remove file";
+    readonly 'core.component.upload-file.zoom': "Zoom image";
+    readonly 'core.component.upload-file.view-all': "View all images";
+    readonly 'core.component.form-builder.canvas': "Form design canvas";
 };
 
 type I18nKey = keyof typeof EN_MESSAGES;
@@ -571,12 +654,12 @@ declare class I18nService {
     static ɵprov: i0.ɵɵInjectableDeclaration<I18nService>;
 }
 
-declare class TranslatePipe implements PipeTransform {
+declare class SdTranslatePipe implements PipeTransform {
     #private;
     transform(key: string, params?: I18nParams): string;
-    static ɵfac: i0.ɵɵFactoryDeclaration<TranslatePipe, never>;
-    static ɵpipe: i0.ɵɵPipeDeclaration<TranslatePipe, "translate", true>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SdTranslatePipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<SdTranslatePipe, "sdTranslate", true>;
 }
 
-export { I18N_MESSAGES, I18N_STORAGE_KEY, I18nService, TranslatePipe };
+export { I18N_MESSAGES, I18N_STORAGE_KEY, I18nService, SdTranslatePipe };
 export type { CustomLanguageProvider, I18nCatalog, I18nKey, I18nParams };

package/index.d.ts

@@ -1,2 +1,11 @@
-
-export { };
+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/interceptors/index.d.ts

@@ -1,11 +1,21 @@
 import { HttpInterceptor, HttpRequest, HttpHandler, HttpEvent } from '@angular/common/http';
-import { Observable } from 'rxjs';
 import * as i0 from '@angular/core';
+import { InjectionToken } from '@angular/core';
+import { Observable } from 'rxjs';
 
+/**
+ * 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).
+ */
+declare const SD_NO_INTERNET_PROBE_URL: InjectionToken<string>;
 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>>;
@@ -23,4 +33,4 @@ declare class SdUnauthorizedInterceptor implements HttpInterceptor {
     static ɵprov: i0.ɵɵInjectableDeclaration<SdUnauthorizedInterceptor>;
 }
 
-export { SdNoInternetInterceptor, SdUnauthorizedInterceptor };
+export { SD_NO_INTERNET_PROBE_URL, SdNoInternetInterceptor, SdUnauthorizedInterceptor };

package/modules/auth/index.d.ts

@@ -5,7 +5,7 @@ import { CanActivate, Router, ActivatedRouteSnapshot, RouterStateSnapshot } from
 import { MaybeAsync } from '@sdcorejs/utils/models';
 import { Observable } from 'rxjs';
 
-interface SdAuthInfo<T = any> {
+interface SdAuthInfo<T = unknown> {
     id?: string;
     username?: string;
     firstName?: string;

package/modules/keycloak/index.d.ts

@@ -40,6 +40,7 @@ interface ISdKeycloakConfiguration {
 declare const SD_KEYCLOAK_CONFIGURATION: InjectionToken<ISdKeycloakConfiguration>;
 
 declare class SdKeycloakService {
+    #private;
     keycloak: Keycloak;
     config: SdKeycloakTenantConfig;
     init(config: SdKeycloakTenantConfig): Promise<boolean>;

package/modules/layout/index.d.ts

@@ -1,5 +1,5 @@
 import * as _angular_core from '@angular/core';
-import { Signal, InjectionToken, PipeTransform } from '@angular/core';
+import { InjectionToken, Signal, PipeTransform } from '@angular/core';
 import * as i1$1 from '@angular/common';
 import * as i1 from '@angular/router';
 import { Params } from '@angular/router';
@@ -57,15 +57,59 @@ interface SdLayoutChildrenMenu {
     tooltipTitle?: string;
 }
 
+/**
+ * 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).
+ */
+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.
+ */
+declare const SD_LAYOUT_STORAGE_NAMESPACE: InjectionToken<SdLayoutStorageNamespace>;
 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[];
@@ -251,10 +295,30 @@ declare function selectPrimaryMenuGroups(menus: SdLayoutMenu[], requestedIds: st
 declare function resolveMenuKeys(menus: SdLayoutMenu[], keys: string[]): (SdLayoutRootMenu | SdLayoutChildrenMenu)[];
 declare function flattenMenuLeaves(menus: SdLayoutMenu[]): SdLayoutRootMenu[];
 
+/**
+ * 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.
+ */
+declare const SD_LAYOUT_DEMO_FALLBACK: InjectionToken<boolean>;
 declare class SdLayoutService {
     #private;
     userInfo: _angular_core.WritableSignal<SdLayoutUserInfo | undefined>;
     sidebar: _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: _angular_core.ɵɵFactoryDeclaration<SdLayoutService, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<SdLayoutService>;
@@ -285,7 +349,7 @@ declare class SdLayoutComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdLayoutComponent, "sd-layout", never, { "menusInput": { "alias": "menus"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
 }
 
-declare class SidebarMobileV1Component {
+declare class SdSidebarMobileV1 {
     #private;
     menus: _angular_core.InputSignal<SdLayoutMenu[]>;
     userInfo: _angular_core.InputSignal<SdLayoutUserInfo>;
@@ -300,11 +364,11 @@ declare class SidebarMobileV1Component {
     onExpandSideBar: () => void;
     onMouseleaveSideBar: () => void;
     onTitleMenuGroupChanged: (title: string | undefined) => void;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SidebarMobileV1Component, never>;
-    static ɵcmp: _angular_core.ɵɵ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: _angular_core.ɵɵFactoryDeclaration<SdSidebarMobileV1, never>;
+    static ɵcmp: _angular_core.ɵɵ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>;
 }
 
-declare class SidebarMobileOverlayComponent {
+declare class SdSidebarMobileOverlay {
     #private;
     isShowSidebar: _angular_core.InputSignal<boolean>;
     menus: _angular_core.InputSignal<SdLayoutMenu[]>;
@@ -332,8 +396,8 @@ declare class SidebarMobileOverlayComponent {
     getQueryParams(menu: SdLayoutMenu): Params;
     onUserMenuOpened: () => void;
     onUserMenuClosed: () => void;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SidebarMobileOverlayComponent, never>;
-    static ɵcmp: _angular_core.ɵɵ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: _angular_core.ɵɵFactoryDeclaration<SdSidebarMobileOverlay, never>;
+    static ɵcmp: _angular_core.ɵɵ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>;
 }
 
 interface SdLayoutMenuTreeNode {
@@ -346,6 +410,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;
 }
 declare class SdLayoutMenuTreeComponent {
     #private;
@@ -416,7 +482,7 @@ interface SidebarV2RailItem {
     key: string;
     title: string;
 }
-declare class SidebarV2Component {
+declare class SdSidebarV2 {
     #private;
     menus: _angular_core.InputSignal<SdLayoutMenu[]>;
     userInfo: _angular_core.InputSignal<SdLayoutUserInfo>;
@@ -440,11 +506,11 @@ declare class SidebarV2Component {
     closeFromNavigation(): void;
     onNavigate(menu: SdLayoutMenu): void;
     onTogglePinned(menu: SdLayoutMenu): void;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SidebarV2Component, never>;
-    static ɵcmp: _angular_core.ɵɵ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: _angular_core.ɵɵFactoryDeclaration<SdSidebarV2, never>;
+    static ɵcmp: _angular_core.ɵɵ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>;
 }
 
-declare class SidebarMobileV2Component {
+declare class SdSidebarMobileV2 {
     #private;
     menus: _angular_core.InputSignal<SdLayoutMenu[]>;
     userInfo: _angular_core.InputSignal<SdLayoutUserInfo>;
@@ -465,11 +531,11 @@ declare class SidebarMobileV2Component {
     onSheetKeydown(event: KeyboardEvent): void;
     onNavigate(menu: SdLayoutMenu): void;
     onTogglePinned(menu: SdLayoutMenu): void;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SidebarMobileV2Component, never>;
-    static ɵcmp: _angular_core.ɵɵ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: _angular_core.ɵɵFactoryDeclaration<SdSidebarMobileV2, never>;
+    static ɵcmp: _angular_core.ɵɵ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>;
 }
 
-declare class SidebarV3Component {
+declare class SdSidebarV3 {
     #private;
     menus: _angular_core.InputSignal<SdLayoutMenu[]>;
     userInfo: _angular_core.InputSignal<SdLayoutUserInfo>;
@@ -492,11 +558,11 @@ declare class SidebarV3Component {
     activateCollapsedMenu(menu: SdLayoutMenu): void;
     navigateMenu(menu: SdLayoutMenu): void;
     onTogglePinned(menu: SdLayoutMenu): void;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SidebarV3Component, never>;
-    static ɵcmp: _angular_core.ɵɵ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: _angular_core.ɵɵFactoryDeclaration<SdSidebarV3, never>;
+    static ɵcmp: _angular_core.ɵɵ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>;
 }
 
-declare class SidebarMobileV3Component {
+declare class SdSidebarMobileV3 {
     #private;
     private readonly trigger;
     menus: _angular_core.InputSignal<SdLayoutMenu[]>;
@@ -518,10 +584,19 @@ declare class SidebarMobileV3Component {
     onDrawerKeydown(event: KeyboardEvent): void;
     navigateMenu(menu: SdLayoutMenu): void;
     onTogglePinned(menu: SdLayoutMenu): void;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SidebarMobileV3Component, never>;
-    static ɵcmp: _angular_core.ɵɵ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: _angular_core.ɵɵFactoryDeclaration<SdSidebarMobileV3, never>;
+    static ɵcmp: _angular_core.ɵɵ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>;
 }
 
+/**
+ * Resolve a translated tab name for `@SdTabComponent`.
+ *
+ * WHY not I18nService: the decorator runs at module-evaluation time, before
+ * Angular's DI exists, so the service cannot be injected. We read the language
+ * the app persisted and look the key up in the static catalog instead.
+ */
+declare function resolveTabName(key: string): string;
+
 declare class MenuPipe implements PipeTransform {
     #private;
     private permissionService;
@@ -556,5 +631,5 @@ declare class SdLayoutModule {
     static ɵinj: _angular_core.ɵɵInjectorDeclaration<SdLayoutModule>;
 }
 
-export { DEFAULT_LAYOUT_MOBILE_BREAKPOINT, ForbiddenModule, HighlightSearchPipe, HomeModule, MenuFocusPipe, MenuPipe, NotFoundModule, SD_LAYOUT_CONFIGURATION, SD_LAYOUT_VIEWPORT, SdLayoutComponent, SdLayoutMenuTreeComponent, SdLayoutModule, SdLayoutNavigationStateService, SdLayoutResponsiveService, SdLayoutService, SdLayoutStorageService, SdLayoutUserMenuComponent, SdPageComponent, SidebarMobileOverlayComponent, SidebarMobileV1Component, SidebarMobileV2Component, SidebarMobileV3Component, SidebarV2Component, SidebarV3Component, flattenMenuLeaves, getMenuStableKey, normalizeLayoutMobileBreakpoint, normalizeSidebarConfiguration, resolveMenuKeys, resolveSidebarV2Interaction, resolveSidebarV3Recent, searchMenuLeaves, selectPrimaryMenuGroups };
-export type { ISdLayoutConfiguration, ISdSidebarConfiguration, Menus, ResolvedSidebarRecentConfiguration, SdLayoutAccountAction, SdLayoutChildrenMenu, SdLayoutMenu, SdLayoutNotificationConfiguration, SdLayoutRootMenu, SdLayoutUserInfo, SdLayoutUserRole, SdLayoutVersionState, SdLayoutViewport, SidebarConfigurationBase, SidebarConfigurationV1, SidebarConfigurationV2, SidebarConfigurationV3 };
+export { DEFAULT_LAYOUT_MOBILE_BREAKPOINT, ForbiddenModule, HighlightSearchPipe, HomeModule, MenuFocusPipe, MenuPipe, NotFoundModule, SD_LAYOUT_CONFIGURATION, SD_LAYOUT_DEMO_FALLBACK, SD_LAYOUT_STORAGE_NAMESPACE, SD_LAYOUT_VIEWPORT, SdLayoutComponent, SdLayoutMenuTreeComponent, SdLayoutModule, SdLayoutNavigationStateService, SdLayoutResponsiveService, SdLayoutService, SdLayoutStorageService, SdLayoutUserMenuComponent, SdPageComponent, SdSidebarMobileOverlay, SdSidebarMobileV1, SdSidebarMobileV2, SdSidebarMobileV3, SdSidebarV2, SdSidebarV3, flattenMenuLeaves, getMenuStableKey, normalizeLayoutMobileBreakpoint, normalizeSidebarConfiguration, resolveMenuKeys, resolveSidebarV2Interaction, resolveSidebarV3Recent, resolveTabName, searchMenuLeaves, selectPrimaryMenuGroups };
+export type { ISdLayoutConfiguration, ISdSidebarConfiguration, Menus, ResolvedSidebarRecentConfiguration, SdLayoutAccountAction, SdLayoutChildrenMenu, SdLayoutMenu, SdLayoutNotificationConfiguration, SdLayoutRootMenu, SdLayoutStorageNamespace, SdLayoutUserInfo, SdLayoutUserRole, SdLayoutVersionState, SdLayoutViewport, SidebarConfigurationBase, SidebarConfigurationV1, SidebarConfigurationV2, SidebarConfigurationV3 };

package/modules/permission/index.d.ts

@@ -49,6 +49,17 @@ 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.
@@ -65,13 +76,64 @@ interface ISdPermissionConfiguration {
  */
 declare const SD_PERMISSION_CONFIGURATION: InjectionToken<ISdPermissionConfiguration | ISdPermissionConfiguration[]>;
 
+/**
+ * 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`.
+ */
+declare const SD_PERMISSION_PUBLIC = "__SD_PERMISSION_PUBLIC__";
+/** Kiểu đầu vào cho `hasPermission` / `[sdPermission]`. */
+type SdPermissionInput = string | string[] | null | undefined;
 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>;
@@ -79,7 +141,7 @@ declare class SdPermissionService {
 
 declare class SdPermissionDirective {
     #private;
-    readonly sdPermission: i0.InputSignal<string | string[] | null | undefined>;
+    readonly sdPermission: i0.InputSignal<SdPermissionInput>;
     readonly sdPermissionKey: i0.InputSignal<string | undefined>;
     constructor();
     static ɵfac: i0.ɵɵFactoryDeclaration<SdPermissionDirective, never>;
@@ -96,5 +158,5 @@ declare class SdPermissionGuard implements CanActivate, CanActivateChild {
     static ɵprov: i0.ɵɵInjectableDeclaration<SdPermissionGuard>;
 }
 
-export { SD_PERMISSION_CONFIGURATION, SdPermissionDirective, SdPermissionGuard, SdPermissionService };
-export type { ISdPermissionConfiguration };
+export { SD_PERMISSION_CONFIGURATION, SD_PERMISSION_PUBLIC, SdPermissionDirective, SdPermissionGuard, SdPermissionService };
+export type { ISdPermissionConfiguration, SdPermissionInput };