@sdcorejs/angular 20.1.6 → 20.2.1

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";
@@ -143,6 +139,8 @@ declare const EN_MESSAGES: {
     readonly 'core.form.tree-select.cancel': "Cancel";
     readonly 'core.form.tree-select.apply': "Apply";
     readonly 'core.component.tree.retry': "Retry";
+    readonly 'core.component.section.expand': "Expand {title}";
+    readonly 'core.component.section.collapse': "Collapse {title}";
     readonly 'core.service.unsaved-changes.message': "You have unsaved changes. Discard them and continue?";
     readonly 'core.component.job-progress.status.idle': "Ready";
     readonly 'core.component.job-progress.status.queued': "Queued";
@@ -184,7 +182,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 +200,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 +214,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 +227,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 +299,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";
@@ -477,6 +474,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.";
@@ -505,6 +504,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";
@@ -531,6 +537,159 @@ 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.api-contract-builder.steps': "Contract steps";
+    readonly 'core.component.api-contract-builder.step.general': "General";
+    readonly 'core.component.api-contract-builder.step.input': "Input schema";
+    readonly 'core.component.api-contract-builder.step.request': "Request";
+    readonly 'core.component.api-contract-builder.step.response': "Response";
+    readonly 'core.component.api-contract-builder.step.output': "Output";
+    readonly 'core.component.api-contract-builder.step.review': "Review";
+    readonly 'core.component.api-contract-builder.empty.contract': "No contract yet";
+    readonly 'core.component.api-contract-builder.create-contract': "Create a contract";
+    readonly 'core.component.api-contract-builder.contract.code': "Contract code";
+    readonly 'core.component.api-contract-builder.contract.name': "Name";
+    readonly 'core.component.api-contract-builder.contract.description': "Description";
+    readonly 'core.component.api-contract-builder.contract.version': "Contract version";
+    readonly 'core.component.api-contract-builder.node.name': "Name";
+    readonly 'core.component.api-contract-builder.node.type': "Type";
+    readonly 'core.component.api-contract-builder.node.required': "Required";
+    readonly 'core.component.api-contract-builder.node.label': "Label";
+    readonly 'core.component.api-contract-builder.node.description': "Description";
+    readonly 'core.component.api-contract-builder.node.transform': "Temporal transform";
+    readonly 'core.component.api-contract-builder.node.items': "Item schema";
+    readonly 'core.component.api-contract-builder.node.remove': "Remove";
+    readonly 'core.component.api-contract-builder.node.empty': "No properties yet";
+    readonly 'core.component.api-contract-builder.node.add-property': "Add property";
+    readonly 'core.component.api-contract-builder.node.duplicate-key': "This name is already used by a sibling";
+    readonly 'core.component.api-contract-builder.node.confirm-remove': "Remove \"{name}\" and every field inside it?";
+    readonly 'core.component.api-contract-builder.node.confirm-type': "Changing the type discards the nested fields. Continue?";
+    readonly 'core.component.api-contract-builder.confirm.yes': "Yes";
+    readonly 'core.component.api-contract-builder.confirm.no': "No";
+    readonly 'core.component.api-contract-builder.required.true': "Yes";
+    readonly 'core.component.api-contract-builder.required.false': "No";
+    readonly 'core.component.api-contract-builder.field.required': "Required";
+    readonly 'core.component.api-contract-builder.transform.none': "None";
+    readonly 'core.component.api-contract-builder.mapping.mode': "Value";
+    readonly 'core.component.api-contract-builder.mapping.mode.source': "From source";
+    readonly 'core.component.api-contract-builder.mapping.mode.static': "Static value";
+    readonly 'core.component.api-contract-builder.mapping.mode.advanced': "Advanced";
+    readonly 'core.component.api-contract-builder.mapping.mode.nested': "Map each field";
+    readonly 'core.component.api-contract-builder.mapping.source': "Source expression";
+    readonly 'core.component.api-contract-builder.mapping.value': "Static value";
+    readonly 'core.component.api-contract-builder.mapping.sensitive': "sensitive";
+    readonly 'core.component.api-contract-builder.drawer.add-title': "Add field";
+    readonly 'core.component.api-contract-builder.drawer.edit-title': "Edit field";
+    readonly 'core.component.api-contract-builder.drawer.save': "Save";
+    readonly 'core.component.api-contract-builder.drawer.cancel': "Cancel";
+    readonly 'core.component.api-contract-builder.drawer.discard-confirm': "Discard unsaved changes?";
+    readonly 'core.component.api-contract-builder.summary.unmapped': "unmapped";
+    readonly 'core.component.api-contract-builder.summary.field-count': "{count} field(s)";
+    readonly 'core.component.api-contract-builder.node.name-required': "The field name cannot be empty";
+    readonly 'core.component.api-contract-builder.boolean.true': "True";
+    readonly 'core.component.api-contract-builder.boolean.false': "False";
+    readonly 'core.component.api-contract-builder.request.method': "Method";
+    readonly 'core.component.api-contract-builder.request.url': "URL";
+    readonly 'core.component.api-contract-builder.request.path': "Path parameters";
+    readonly 'core.component.api-contract-builder.request.query': "Query parameters";
+    readonly 'core.component.api-contract-builder.request.headers': "Headers";
+    readonly 'core.component.api-contract-builder.request.body': "Body";
+    readonly 'core.component.api-contract-builder.request.add-body': "Add a body";
+    readonly 'core.component.api-contract-builder.request.remove-body': "Remove the body";
+    readonly 'core.component.api-contract-builder.request.add-entry': "Add";
+    readonly 'core.component.api-contract-builder.response.status': "Success status codes";
+    readonly 'core.component.api-contract-builder.response.status-hint': "Comma separated, for example 200, 201";
+    readonly 'core.component.api-contract-builder.response.headers': "Response headers";
+    readonly 'core.component.api-contract-builder.response.body': "Response body";
+    readonly 'core.component.api-contract-builder.response.add-body': "Add a body";
+    readonly 'core.component.api-contract-builder.response.remove-body': "Remove the body";
+    readonly 'core.component.api-contract-builder.output.schema': "Output schema";
+    readonly 'core.component.api-contract-builder.output.use-response': "Use a response field as the output";
+    readonly 'core.component.api-contract-builder.output.fields': "Fields available to consumers";
+    readonly 'core.component.api-contract-builder.output.no-fields': "No leaf field yet";
+    readonly 'core.component.api-contract-builder.review.valid': "The contract is valid";
+    readonly 'core.component.api-contract-builder.review.errors': "{count} error(s)";
+    readonly 'core.component.api-contract-builder.review.warnings': "{count} warning(s)";
+    readonly 'core.component.api-contract-builder.review.json': "Contract JSON";
+    readonly 'core.component.api-contract-builder.empty.path': "No path parameter yet";
+    readonly 'core.component.api-contract-builder.empty.query': "No query parameter yet";
+    readonly 'core.component.api-contract-builder.empty.headers': "No header yet";
+    readonly 'core.component.api-contract-builder.empty.body': "No body declared";
+    readonly 'core.component.api-contract-builder.empty.section': "This section is missing from the contract";
+    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;
@@ -575,12 +734,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,8 +584,8 @@ 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>;
 }
 
 /**
@@ -565,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, resolveTabName, 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 };