@sdcorejs/angular 21.1.4 → 21.1.6

package/package.json

@@ -1,7 +1,15 @@
 {
   "name": "@sdcorejs/angular",
-  "version": "21.1.4",
+  "version": "21.1.6",
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sdcorejs/sdcorejs-angular.git"
+  },
+  "homepage": "https://sdcorejs.github.io/sdcorejs-angular/",
+  "bugs": {
+    "url": "https://github.com/sdcorejs/sdcorejs-angular/issues"
+  },
   "peerDependencies": {
     "@angular/common": "^19.0.0 || ^20.0.0 || ^21.0.0",
     "@angular/core": "^19.0.0 || ^20.0.0 || ^21.0.0",

package/types/sdcorejs-angular-components-table.d.ts

@@ -1187,7 +1187,7 @@ declare class SdTable<T = unknown> implements AfterViewInit, OnDestroy {
     cacheValues: Record<string, unknown[]>;
     treeRevision: _angular_core.WritableSignal<number>;
     exporting: _angular_core.WritableSignal<boolean>;
-    exportTitle: _angular_core.WritableSignal<string>;
+    exportTitle: _angular_core.Signal<string>;
     tableConfiguration: ISdTableConfiguration | null;
     constructor();
     ngAfterViewInit(): void;

package/types/sdcorejs-angular-forms-date.d.ts

@@ -8,6 +8,11 @@ import { SdViewed, SdViewedInput, SdFormControl } from '@sdcorejs/angular/forms/
 import { Size } from '@sdcorejs/utils/models';
 
 type SdDateModelValue = string | number | Date | undefined | null;
+type SdDateKeyupEvent = Event | {
+    target?: {
+        value?: string | null;
+    };
+};
 declare class SdDate implements OnDestroy, OnInit {
     #private;
     id: string;
@@ -81,7 +86,9 @@ declare class SdDate implements OnDestroy, OnInit {
     open: () => void;
     focusInputElement(): void;
     onKeyDown: (event: KeyboardEvent) => boolean;
-    onKeyup: (event: any) => void;
+    onInput: (event: Event) => void;
+    /** Kept as a compatibility entry point for callers that used the old keyup handler. */
+    onKeyup: (event: SdDateKeyupEvent) => void;
     onChange: (event: MatDatepickerInputEvent<Date>) => void;
     clear: ($event: any) => void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<SdDate, never>;

package/types/sdcorejs-angular-forms-models.d.ts

@@ -1,7 +1,10 @@
-import { InjectionToken, Signal } from '@angular/core';
+import * as i0 from '@angular/core';
+import { InjectionToken, Signal, Provider } from '@angular/core';
 import { MatFormFieldAppearance } from '@angular/material/form-field';
 import { FormControl, FormControlState, ValidatorFn, FormControlOptions, AsyncValidatorFn, AbstractControl, FormGroup, NgForm } from '@angular/forms';
 import { Subject } from 'rxjs';
+import { DateFnsAdapter } from '@angular/material-date-fns-adapter';
+import { MatDateFormats } from '@angular/material/core';
 
 interface ISdFormConfiguration {
     appearance?: MatFormFieldAppearance;
@@ -202,5 +205,28 @@ declare function ɵsdCoerceFormGroup(value: unknown): FormGroup | undefined;
  */
 declare function ɵsdFormControlConnector<TModel, TControl>(options: ɵSdFormControlConnectorOptions<TModel, TControl>): ɵSdFormControlConnector<TControl>;
 
-export { HandleSdCustomValidator, SD_FORM_CONFIGURATION, SdFormControl, SdInlineErrorValidator, sdFormControlState, sdViewedInline, sdViewedTransform, ɵsdCoerceFormGroup, ɵsdFormControlConnector };
+/**
+ * DateAdapter từ chối mọi chuỗi người dùng chưa gõ xong.
+ *
+ * WHY cần đến mức này: `<input matInput [matDatepicker]>` khiến Material tự
+ * `parse()` lại ô nhập SAU MỖI PHÍM GÕ rồi ghi thẳng kết quả vào form control.
+ * Adapter mặc định quá dễ dãi trên hai đường:
+ *
+ * 1. `date-fns.parse` nhận năm thiếu chữ số → `11/12/2` thành năm 0002,
+ *    `11/12/20` thành năm 0020. Ô nhập vừa gõ dở đã bị coi là hợp lệ (cờ lỗi
+ *    bị xoá) và control ôm một ngày rác.
+ * 2. `parseISO` coi chuỗi 2 chữ số là thế kỷ → xoá lùi còn `11` ra năm 1100.
+ *
+ * Cả hai đường đều bị chặn ở đây: control chỉ nhận giá trị khi người dùng thực
+ * sự gõ xong.
+ */
+declare class SdStrictDateFnsAdapter extends DateFnsAdapter {
+    parse(value: unknown, parseFormat: string | string[]): Date | null;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SdStrictDateFnsAdapter, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<SdStrictDateFnsAdapter>;
+}
+/** `provideDateFnsAdapter` + ép dùng adapter parse chặt ở trên. */
+declare function provideSdStrictDateFnsAdapter(formats: MatDateFormats): Provider[];
+
+export { HandleSdCustomValidator, SD_FORM_CONFIGURATION, SdFormControl, SdInlineErrorValidator, SdStrictDateFnsAdapter, provideSdStrictDateFnsAdapter, sdFormControlState, sdViewedInline, sdViewedTransform, ɵsdCoerceFormGroup, ɵsdFormControlConnector };
 export type { ISdFormConfiguration, SdCustomValidator, SdFormControlSnapshot, SdSearch, SdSearchReq, SdSelectionData, SdViewed, SdViewedInlineApi, SdViewedInput, ɵSdFormControlConnector, ɵSdFormControlConnectorOptions, ɵSdFormControlConnectorState, ɵSdFormControlParent };

package/types/sdcorejs-angular-i18n.d.ts

@@ -465,6 +465,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";
@@ -498,7 +500,11 @@ declare const EN_MESSAGES: {
     readonly 'core.component.upload-file.preview-title': "Preview image";
     readonly 'core.module.layout.user.change-password': "Change password";
     readonly 'core.module.layout.user.logout': "Sign out";
+    readonly 'core.module.layout.user.update-profile': "Update profile";
+    readonly 'core.module.layout.user.setting': "Settings";
+    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.greeting.hello': "Hello, {name}";
     readonly 'core.module.layout.weekday.0': "Sunday";
     readonly 'core.module.layout.weekday.1': "Monday";
@@ -515,6 +521,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";

package/types/sdcorejs-angular-modules-layout.d.ts

@@ -1,5 +1,5 @@
 import * as _angular_core from '@angular/core';
-import { InjectionToken, PipeTransform } from '@angular/core';
+import { Signal, InjectionToken, PipeTransform } from '@angular/core';
 import * as i1$1 from '@angular/common';
 import * as i1 from '@angular/router';
 import { Params } from '@angular/router';
@@ -7,6 +7,7 @@ import { SdStorage } from '@sdcorejs/angular/services';
 import { SdViewport } from '@sdcorejs/angular/services/viewport';
 import * as _sdcorejs_angular_modules_layout from '@sdcorejs/angular/modules/layout';
 import { MaybeAsync } from '@sdcorejs/utils/models';
+import { Observable } from 'rxjs';
 
 declare class HomeRoutingModule {
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<HomeRoutingModule, never>;
@@ -91,13 +92,46 @@ declare class SdLayoutResponsiveService {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<SdLayoutResponsiveService>;
 }
 
+/** Consumer-owned account action invoked without arguments by the shared user menu. */
+type SdLayoutAccountAction = () => void | Promise<void>;
+/** Notification badge source and the action that opens the consumer's notification experience. */
+interface SdLayoutNotificationConfiguration {
+    /**
+     * Số lượng thông báo chưa đọc. Hỗ trợ giá trị tĩnh hoặc nguồn reactive dài hạn.
+     */
+    count: number | Signal<number> | Observable<number>;
+    /**
+     * Tác vụ do consumer xử lý khi người dùng chọn thông báo.
+     */
+    action: SdLayoutAccountAction;
+}
 interface ISdLayoutConfiguration {
     homeUrl?: string;
     mobileBreakpoint?: number;
     sidebar: ISdSidebarConfiguration | (() => MaybeAsync<ISdSidebarConfiguration>);
     userInfo: SdLayoutUserInfo | (() => MaybeAsync<SdLayoutUserInfo>);
-    signout: () => void | Promise<void>;
-    changePassword?: () => void | Promise<void>;
+    signout: SdLayoutAccountAction;
+    changePassword?: SdLayoutAccountAction;
+    /**
+     * Tác vụ chỉnh sửa hồ sơ do consumer cung cấp.
+     */
+    updateProfile?: SdLayoutAccountAction;
+    /**
+     * Tác vụ mở thiết lập tài khoản do consumer cung cấp.
+     */
+    setting?: SdLayoutAccountAction;
+    /**
+     * Cấu hình số lượng và tác vụ thông báo của tài khoản.
+     */
+    notification?: SdLayoutNotificationConfiguration;
+}
+/** Optional role metadata rendered below the user's email when `text` is non-empty. */
+interface SdLayoutUserRole {
+    text: string;
+    /** Icon name resolved by `SdIcon`. */
+    icon?: string;
+    /** CSS color applied to the role metadata. */
+    color?: string;
 }
 interface SdLayoutUserInfo {
     /**
@@ -121,6 +155,11 @@ interface SdLayoutUserInfo {
      * Hỗ trợ các định dạng: URL (http/https), chuỗi base64 (data:image), hoặc đường dẫn nội bộ.
      */
     avatar?: string;
+    /**
+     * Chức vụ hoặc vai trò hiển thị cùng thông tin người dùng.
+     * Không render khi `text` rỗng.
+     */
+    role?: SdLayoutUserRole;
 }
 declare const DEFAULT_LAYOUT_MOBILE_BREAKPOINT = 1024;
 interface SidebarConfigurationBase {
@@ -306,6 +345,7 @@ interface SdLayoutMenuTreeNode {
     isGroup: boolean;
     isActive: boolean;
     isPinned: boolean;
+    isPinVisible: boolean;
 }
 declare class SdLayoutMenuTreeComponent {
     #private;
@@ -314,13 +354,17 @@ declare class SdLayoutMenuTreeComponent {
     activePath: _angular_core.InputSignal<string>;
     pinnedKeys: _angular_core.InputSignal<string[]>;
     showPin: _angular_core.InputSignal<boolean>;
+    pinVisibility: _angular_core.InputSignal<"hover" | "always">;
     navigate: _angular_core.OutputEmitterRef<SdLayoutRootMenu>;
     togglePinned: _angular_core.OutputEmitterRef<SdLayoutMenu>;
     nodes: _angular_core.Signal<SdLayoutMenuTreeNode[]>;
+    constructor();
     onNavigate(menu: SdLayoutMenu): void;
     onTogglePinned(event: MouseEvent, menu: SdLayoutMenu): void;
+    onPinHoverStart(key: string): void;
+    onPinHoverEnd(key: string): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<SdLayoutMenuTreeComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdLayoutMenuTreeComponent, "sd-layout-menu-tree", never, { "menus": { "alias": "menus"; "required": false; "isSignal": true; }; "query": { "alias": "query"; "required": false; "isSignal": true; }; "activePath": { "alias": "activePath"; "required": false; "isSignal": true; }; "pinnedKeys": { "alias": "pinnedKeys"; "required": false; "isSignal": true; }; "showPin": { "alias": "showPin"; "required": false; "isSignal": true; }; }, { "navigate": "navigate"; "togglePinned": "togglePinned"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdLayoutMenuTreeComponent, "sd-layout-menu-tree", never, { "menus": { "alias": "menus"; "required": false; "isSignal": true; }; "query": { "alias": "query"; "required": false; "isSignal": true; }; "activePath": { "alias": "activePath"; "required": false; "isSignal": true; }; "pinnedKeys": { "alias": "pinnedKeys"; "required": false; "isSignal": true; }; "showPin": { "alias": "showPin"; "required": false; "isSignal": true; }; "pinVisibility": { "alias": "pinVisibility"; "required": false; "isSignal": true; }; }, { "navigate": "navigate"; "togglePinned": "togglePinned"; }, never, never, true, never>;
 }
 
 declare class SdLayoutUserMenuComponent {
@@ -328,14 +372,31 @@ declare class SdLayoutUserMenuComponent {
     private readonly trigger;
     private readonly menu;
     userInfo: _angular_core.InputSignal<SdLayoutUserInfo>;
-    signout: _angular_core.InputSignal<(() => void | Promise<void>) | undefined>;
-    changePassword: _angular_core.InputSignal<(() => void | Promise<void>) | undefined>;
+    signout: _angular_core.InputSignal<SdLayoutAccountAction | undefined>;
+    changePassword: _angular_core.InputSignal<SdLayoutAccountAction | undefined>;
+    updateProfile: _angular_core.InputSignal<SdLayoutAccountAction | undefined>;
+    setting: _angular_core.InputSignal<SdLayoutAccountAction | undefined>;
+    notification: _angular_core.InputSignal<SdLayoutNotificationConfiguration | undefined>;
     compact: _angular_core.InputSignal<boolean>;
+    presentation: _angular_core.InputSignal<"disclosure" | "mobile" | "mobile-inline">;
+    opened: _angular_core.OutputEmitterRef<void>;
+    closed: _angular_core.OutputEmitterRef<void>;
     isOpen: _angular_core.WritableSignal<boolean>;
     avatar: _angular_core.Signal<string | undefined>;
     displayName: _angular_core.Signal<string>;
-    signoutAction: _angular_core.Signal<(() => void | Promise<void>) | undefined>;
-    changePasswordAction: _angular_core.Signal<(() => void | Promise<void>) | undefined>;
+    role: _angular_core.Signal<{
+        text: string;
+        icon?: string;
+        color?: string;
+    } | undefined>;
+    signoutAction: _angular_core.Signal<SdLayoutAccountAction | undefined>;
+    changePasswordAction: _angular_core.Signal<SdLayoutAccountAction | undefined>;
+    updateProfileAction: _angular_core.Signal<SdLayoutAccountAction | undefined>;
+    settingAction: _angular_core.Signal<SdLayoutAccountAction | undefined>;
+    notificationConfiguration: _angular_core.Signal<SdLayoutNotificationConfiguration | undefined>;
+    notificationAction: _angular_core.Signal<SdLayoutAccountAction | undefined>;
+    notificationCount: _angular_core.Signal<number>;
+    notificationBadge: _angular_core.Signal<string | undefined>;
     constructor();
     open(): void;
     toggle(): void;
@@ -343,8 +404,11 @@ declare class SdLayoutUserMenuComponent {
     onMenuKeydown(event: KeyboardEvent): void;
     runChangePassword(): void;
     runSignout(): void;
+    runUpdateProfile(): void;
+    runSetting(): void;
+    runNotification(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<SdLayoutUserMenuComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdLayoutUserMenuComponent, "sd-layout-user-menu", never, { "userInfo": { "alias": "userInfo"; "required": true; "isSignal": true; }; "signout": { "alias": "signout"; "required": false; "isSignal": true; }; "changePassword": { "alias": "changePassword"; "required": false; "isSignal": true; }; "compact": { "alias": "compact"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdLayoutUserMenuComponent, "sd-layout-user-menu", never, { "userInfo": { "alias": "userInfo"; "required": true; "isSignal": true; }; "signout": { "alias": "signout"; "required": false; "isSignal": true; }; "changePassword": { "alias": "changePassword"; "required": false; "isSignal": true; }; "updateProfile": { "alias": "updateProfile"; "required": false; "isSignal": true; }; "setting": { "alias": "setting"; "required": false; "isSignal": true; }; "notification": { "alias": "notification"; "required": false; "isSignal": true; }; "compact": { "alias": "compact"; "required": false; "isSignal": true; }; "presentation": { "alias": "presentation"; "required": false; "isSignal": true; }; }, { "opened": "opened"; "closed": "closed"; }, never, never, true, never>;
 }
 
 interface SidebarV2RailItem {
@@ -458,6 +522,15 @@ declare class SidebarMobileV3Component {
     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>;
 }
 
+/**
+ * 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;
@@ -492,5 +565,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, SdLayoutChildrenMenu, SdLayoutMenu, SdLayoutRootMenu, SdLayoutUserInfo, SdLayoutVersionState, SdLayoutViewport, SidebarConfigurationBase, SidebarConfigurationV1, SidebarConfigurationV2, SidebarConfigurationV3 };
+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 };