@sdcorejs/angular 20.1.3 → 20.1.4

package/modules/layout/index.d.ts

@@ -1,9 +1,10 @@
 import * as _angular_core from '@angular/core';
-import { InjectionToken } from '@angular/core';
+import { InjectionToken, PipeTransform } from '@angular/core';
 import * as i1$1 from '@angular/common';
 import * as i1 from '@angular/router';
 import { Params } from '@angular/router';
-import { SdStorage, SdStorageService } from '@sdcorejs/angular/services';
+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';
 
@@ -56,18 +57,43 @@ interface SdLayoutChildrenMenu {
 }
 
 declare class SdLayoutStorageService {
-    private sdStorageService;
-    isShowSidebar: SdStorage<boolean>;
-    menuLockStatus: SdStorage<boolean>;
-    lastActiveMenuGroupId: SdStorage<string>;
-    pinnedMenuGroup: SdStorage<SdLayoutChildrenMenu>;
-    constructor(sdStorageService: SdStorageService);
+    #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>>;
+    readPinnedMenuKeys(menus: SdLayoutMenu[]): string[];
+    writePinnedMenuKeys(keys: string[]): void;
+    readRecentMenuKeys(menus: SdLayoutMenu[], maximum?: number): string[];
+    writeRecentMenuKeys(keys: string[]): void;
+    readVersionState(version: 1 | 2 | 3): SdLayoutVersionState;
+    patchVersionState(version: 1 | 2 | 3, patch: SdLayoutVersionState): SdLayoutVersionState;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<SdLayoutStorageService, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<SdLayoutStorageService>;
 }
+interface SdLayoutVersionState {
+    activeGroupKey?: string;
+    locked?: boolean;
+    collapsed?: boolean;
+}
+
+type SdLayoutViewport = SdViewport;
+declare const SD_LAYOUT_VIEWPORT: _angular_core.InjectionToken<SdViewport | null>;
+/** @deprecated Prefer `SdViewportService` from `@sdcorejs/angular/services/viewport`. */
+declare class SdLayoutResponsiveService {
+    #private;
+    readonly viewportWidth: _angular_core.Signal<number>;
+    isMobile(breakpoint: number): boolean;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SdLayoutResponsiveService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<SdLayoutResponsiveService>;
+}
 
 interface ISdLayoutConfiguration {
     homeUrl?: string;
+    mobileBreakpoint?: number;
     sidebar: ISdSidebarConfiguration | (() => MaybeAsync<ISdSidebarConfiguration>);
     userInfo: SdLayoutUserInfo | (() => MaybeAsync<SdLayoutUserInfo>);
     signout: () => void | Promise<void>;
@@ -96,8 +122,18 @@ interface SdLayoutUserInfo {
      */
     avatar?: string;
 }
-type ISdSidebarConfiguration = SidebarConfigurationV1;
-interface SidebarConfigurationV1 {
+declare const DEFAULT_LAYOUT_MOBILE_BREAKPOINT = 1024;
+interface SidebarConfigurationBase {
+    brandColor?: string;
+    brandLightColor?: string;
+    logoUrl?: string;
+    defaultTitle?: string;
+    pin?: {
+        enabled?: boolean;
+    };
+}
+type ISdSidebarConfiguration = SidebarConfigurationV1 | SidebarConfigurationV2 | SidebarConfigurationV3;
+interface SidebarConfigurationV1 extends SidebarConfigurationBase {
     version: 1;
     /**
      * Màu brand chính.
@@ -130,12 +166,56 @@ interface SidebarConfigurationV1 {
         enabled?: boolean;
     };
 }
+interface SidebarConfigurationV2 extends SidebarConfigurationBase {
+    version: 2;
+    interaction?: 'click' | 'hover-lock';
+    primaryMenuIds?: string[];
+}
+interface SidebarConfigurationV3 extends SidebarConfigurationBase {
+    version: 3;
+    defaultCollapsed?: boolean;
+    recent?: {
+        enabled?: boolean;
+        maxItems?: number;
+    };
+}
+interface ResolvedSidebarRecentConfiguration {
+    enabled: boolean;
+    maxItems: number;
+}
+declare function normalizeLayoutMobileBreakpoint(value: number | undefined): number;
+declare function resolveSidebarV2Interaction(sidebar: SidebarConfigurationV2): 'click' | 'hover-lock';
+declare function resolveSidebarV3Recent(sidebar: SidebarConfigurationV3): ResolvedSidebarRecentConfiguration;
+declare function normalizeSidebarConfiguration(_sidebar: SidebarConfigurationV1): SidebarConfigurationV1;
+declare function normalizeSidebarConfiguration(_sidebar: SidebarConfigurationV2): SidebarConfigurationV2;
+declare function normalizeSidebarConfiguration(_sidebar: SidebarConfigurationV3): SidebarConfigurationV3;
 declare const SD_LAYOUT_CONFIGURATION: InjectionToken<ISdLayoutConfiguration>;
 
+declare class SdLayoutNavigationStateService {
+    #private;
+    readonly pinnedKeys: _angular_core.WritableSignal<string[]>;
+    readonly recentKeys: _angular_core.WritableSignal<string[]>;
+    readonly pinnedMenus: _angular_core.Signal<(_sdcorejs_angular_modules_layout.SdLayoutRootMenu | _sdcorejs_angular_modules_layout.SdLayoutChildrenMenu)[]>;
+    readonly recentMenus: _angular_core.Signal<(_sdcorejs_angular_modules_layout.SdLayoutRootMenu | _sdcorejs_angular_modules_layout.SdLayoutChildrenMenu)[]>;
+    hydrate(menus: SdLayoutMenu[], recentMaximum?: number): void;
+    togglePinned(menu: SdLayoutMenu): void;
+    recordRecent(menu: SdLayoutMenu, configuration: ResolvedSidebarRecentConfiguration): void;
+    patchVersionState(version: 1 | 2 | 3, patch: SdLayoutVersionState): void;
+    versionState(version: 1 | 2 | 3): SdLayoutVersionState;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SdLayoutNavigationStateService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<SdLayoutNavigationStateService>;
+}
+
+declare function getMenuStableKey(menu: SdLayoutMenu | null | undefined, ancestors?: string[]): string;
+declare function searchMenuLeaves(menus: SdLayoutMenu[], query: string): SdLayoutRootMenu[];
+declare function selectPrimaryMenuGroups(menus: SdLayoutMenu[], requestedIds: string[] | undefined, maximum?: number): SdLayoutMenu[];
+declare function resolveMenuKeys(menus: SdLayoutMenu[], keys: string[]): (SdLayoutRootMenu | SdLayoutChildrenMenu)[];
+declare function flattenMenuLeaves(menus: SdLayoutMenu[]): SdLayoutRootMenu[];
+
 declare class SdLayoutService {
     #private;
     userInfo: _angular_core.WritableSignal<SdLayoutUserInfo | undefined>;
-    sidebar: _angular_core.WritableSignal<_sdcorejs_angular_modules_layout.SidebarConfigurationV1 | undefined>;
+    sidebar: _angular_core.WritableSignal<ISdSidebarConfiguration | undefined>;
     constructor();
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<SdLayoutService, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<SdLayoutService>;
@@ -156,8 +236,12 @@ declare class SdLayoutComponent {
     menusInput: _angular_core.InputSignal<SdLayoutMenu[]>;
     menus: _angular_core.Signal<SdLayoutMenu[]>;
     userInfo: _angular_core.WritableSignal<_sdcorejs_angular_modules_layout.SdLayoutUserInfo | undefined>;
-    sidebar: _angular_core.WritableSignal<_sdcorejs_angular_modules_layout.SidebarConfigurationV1 | undefined>;
-    isMobileOrTablet: _angular_core.WritableSignal<boolean>;
+    sidebar: _angular_core.WritableSignal<_sdcorejs_angular_modules_layout.ISdSidebarConfiguration | undefined>;
+    sidebarV1: _angular_core.Signal<SidebarConfigurationV1 | undefined>;
+    sidebarV2: _angular_core.Signal<SidebarConfigurationV2 | undefined>;
+    sidebarV3: _angular_core.Signal<SidebarConfigurationV3 | undefined>;
+    mobileBreakpoint: number;
+    isMobile: _angular_core.Signal<boolean>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<SdLayoutComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdLayoutComponent, "sd-layout", never, { "menusInput": { "alias": "menus"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
 }
@@ -213,11 +297,200 @@ declare class SidebarMobileOverlayComponent {
     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>;
 }
 
+interface SdLayoutMenuTreeNode {
+    menu: SdLayoutMenu;
+    key: string;
+    title: string;
+    depth: number;
+    paddingLeft: number;
+    isGroup: boolean;
+    isActive: boolean;
+    isPinned: boolean;
+}
+declare class SdLayoutMenuTreeComponent {
+    #private;
+    menus: _angular_core.InputSignal<SdLayoutMenu[]>;
+    query: _angular_core.InputSignal<string>;
+    activePath: _angular_core.InputSignal<string>;
+    pinnedKeys: _angular_core.InputSignal<string[]>;
+    showPin: _angular_core.InputSignal<boolean>;
+    navigate: _angular_core.OutputEmitterRef<SdLayoutRootMenu>;
+    togglePinned: _angular_core.OutputEmitterRef<SdLayoutMenu>;
+    nodes: _angular_core.Signal<SdLayoutMenuTreeNode[]>;
+    onNavigate(menu: SdLayoutMenu): void;
+    onTogglePinned(event: MouseEvent, menu: SdLayoutMenu): 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>;
+}
+
+declare class SdLayoutUserMenuComponent {
+    #private;
+    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>;
+    compact: _angular_core.InputSignal<boolean>;
+    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>;
+    constructor();
+    open(): void;
+    toggle(): void;
+    close(restoreFocus?: boolean): void;
+    onMenuKeydown(event: KeyboardEvent): void;
+    runChangePassword(): void;
+    runSignout(): 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>;
+}
+
+interface SidebarV2RailItem {
+    menu: SdLayoutMenu;
+    key: string;
+    title: string;
+}
+declare class SidebarV2Component {
+    #private;
+    menus: _angular_core.InputSignal<SdLayoutMenu[]>;
+    userInfo: _angular_core.InputSignal<SdLayoutUserInfo>;
+    sidebar: _angular_core.InputSignal<SidebarConfigurationV2>;
+    activeGroupKey: _angular_core.WritableSignal<string>;
+    isFlyoutOpen: _angular_core.WritableSignal<boolean>;
+    isFlyoutLocked: _angular_core.WritableSignal<boolean>;
+    searchText: _angular_core.WritableSignal<string>;
+    activePath: _angular_core.WritableSignal<string>;
+    interaction: _angular_core.Signal<"click" | "hover-lock">;
+    railItems: _angular_core.Signal<SidebarV2RailItem[]>;
+    activeGroup: _angular_core.Signal<SdLayoutMenu | undefined>;
+    contextMenus: _angular_core.Signal<SdLayoutMenu[]>;
+    pinnedKeys: _angular_core.WritableSignal<string[]>;
+    constructor();
+    selectGroup(menu: SdLayoutMenu): void;
+    previewGroup(menu: SdLayoutMenu): void;
+    leaveFlyout(): void;
+    closeFromBackdrop(): void;
+    closeFromEscape(): void;
+    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>;
+}
+
+declare class SidebarMobileV2Component {
+    #private;
+    menus: _angular_core.InputSignal<SdLayoutMenu[]>;
+    userInfo: _angular_core.InputSignal<SdLayoutUserInfo>;
+    sidebar: _angular_core.InputSignal<SidebarConfigurationV2>;
+    primaryMenus: _angular_core.Signal<SdLayoutMenu[]>;
+    overflowMenus: _angular_core.Signal<SdLayoutMenu[]>;
+    isSheetOpen: _angular_core.WritableSignal<boolean>;
+    sheetGroupKey: _angular_core.WritableSignal<string>;
+    sheetTitle: _angular_core.WritableSignal<string>;
+    sheetMenus: _angular_core.WritableSignal<SdLayoutMenu[]>;
+    searchText: _angular_core.WritableSignal<string>;
+    activePath: _angular_core.WritableSignal<string>;
+    pinnedKeys: _angular_core.WritableSignal<string[]>;
+    constructor();
+    openMore(trigger?: EventTarget | null): void;
+    activateMenu(menu: SdLayoutMenu, trigger?: EventTarget | null): void;
+    closeSheet(restoreFocus?: boolean): void;
+    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>;
+}
+
+declare class SidebarV3Component {
+    #private;
+    menus: _angular_core.InputSignal<SdLayoutMenu[]>;
+    userInfo: _angular_core.InputSignal<SdLayoutUserInfo>;
+    sidebar: _angular_core.InputSignal<SidebarConfigurationV3>;
+    isCollapsed: _angular_core.WritableSignal<boolean>;
+    searchText: _angular_core.WritableSignal<string>;
+    activePath: _angular_core.WritableSignal<string>;
+    searchResults: _angular_core.Signal<SdLayoutRootMenu[]>;
+    recentConfiguration: _angular_core.Signal<_sdcorejs_angular_modules_layout.ResolvedSidebarRecentConfiguration>;
+    pinnedKeys: _angular_core.WritableSignal<string[]>;
+    pinnedMenus: _angular_core.Signal<(SdLayoutRootMenu | _sdcorejs_angular_modules_layout.SdLayoutChildrenMenu)[]>;
+    recentMenus: _angular_core.Signal<(SdLayoutRootMenu | _sdcorejs_angular_modules_layout.SdLayoutChildrenMenu)[]>;
+    collapsedItems: _angular_core.Signal<{
+        menu: SdLayoutMenu;
+        key: string;
+        title: string;
+    }[]>;
+    constructor();
+    toggleCollapsed(): void;
+    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>;
+}
+
+declare class SidebarMobileV3Component {
+    #private;
+    private readonly trigger;
+    menus: _angular_core.InputSignal<SdLayoutMenu[]>;
+    userInfo: _angular_core.InputSignal<SdLayoutUserInfo>;
+    sidebar: _angular_core.InputSignal<SidebarConfigurationV3>;
+    isDrawerOpen: _angular_core.WritableSignal<boolean>;
+    searchText: _angular_core.WritableSignal<string>;
+    activePath: _angular_core.WritableSignal<string>;
+    searchResults: _angular_core.Signal<SdLayoutRootMenu[]>;
+    recentConfiguration: _angular_core.Signal<_sdcorejs_angular_modules_layout.ResolvedSidebarRecentConfiguration>;
+    pinnedKeys: _angular_core.WritableSignal<string[]>;
+    pinnedMenus: _angular_core.Signal<(SdLayoutRootMenu | _sdcorejs_angular_modules_layout.SdLayoutChildrenMenu)[]>;
+    recentMenus: _angular_core.Signal<(SdLayoutRootMenu | _sdcorejs_angular_modules_layout.SdLayoutChildrenMenu)[]>;
+    constructor();
+    openDrawer(trigger?: EventTarget | null): void;
+    closeFromBackdrop(): void;
+    closeFromEscape(): void;
+    closeFromNavigation(): void;
+    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>;
+}
+
+declare class MenuPipe implements PipeTransform {
+    #private;
+    private permissionService;
+    /** Inserted by Angular inject() migration for backwards compatibility */
+    constructor(...args: unknown[]);
+    transform(menus: SdLayoutMenu[]): SdLayoutMenu[];
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MenuPipe, never>;
+    static ɵpipe: _angular_core.ɵɵPipeDeclaration<MenuPipe, "menu", true>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<MenuPipe>;
+}
+
+declare class MenuFocusPipe implements PipeTransform {
+    #private;
+    transform(routePath: string, menuItem: SdLayoutMenu): boolean;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MenuFocusPipe, never>;
+    static ɵpipe: _angular_core.ɵɵPipeDeclaration<MenuFocusPipe, "menuFocus", true>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<MenuFocusPipe>;
+}
+
+declare class HighlightSearchPipe implements PipeTransform {
+    #private;
+    transform(value: string, keyword: string, args?: {
+        color?: string;
+    }): string;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<HighlightSearchPipe, never>;
+    static ɵpipe: _angular_core.ɵɵPipeDeclaration<HighlightSearchPipe, "highLightSearch", true>;
+}
+
 declare class SdLayoutModule {
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<SdLayoutModule, never>;
     static ɵmod: _angular_core.ɵɵNgModuleDeclaration<SdLayoutModule, never, [typeof i1.RouterModule], never>;
     static ɵinj: _angular_core.ɵɵInjectorDeclaration<SdLayoutModule>;
 }
 
-export { ForbiddenModule, HomeModule, NotFoundModule, SD_LAYOUT_CONFIGURATION, SdLayoutComponent, SdLayoutModule, SdLayoutService, SdLayoutStorageService, SdPageComponent, SidebarMobileOverlayComponent, SidebarMobileV1Component };
-export type { ISdLayoutConfiguration, ISdSidebarConfiguration, Menus, SdLayoutChildrenMenu, SdLayoutMenu, SdLayoutRootMenu, SdLayoutUserInfo, SidebarConfigurationV1 };
+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 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sdcorejs/angular",
-  "version": "20.1.3",
+  "version": "20.1.4",
   "license": "MIT",
   "peerDependencies": {
     "@angular/common": "^19.0.0 || ^20.0.0 || ^21.0.0",
@@ -43,6 +43,10 @@
       "types": "./components/anchor/index.d.ts",
       "default": "./fesm2022/sdcorejs-angular-components-anchor.mjs"
     },
+    "./components/audit-diff": {
+      "types": "./components/audit-diff/index.d.ts",
+      "default": "./fesm2022/sdcorejs-angular-components-audit-diff.mjs"
+    },
     "./components/autoid-inspector": {
       "types": "./components/autoid-inspector/index.d.ts",
       "default": "./fesm2022/sdcorejs-angular-components-autoid-inspector.mjs"
@@ -59,6 +63,10 @@
       "types": "./components/base/index.d.ts",
       "default": "./fesm2022/sdcorejs-angular-components-base.mjs"
     },
+    "./components/breadcrumb": {
+      "types": "./components/breadcrumb/index.d.ts",
+      "default": "./fesm2022/sdcorejs-angular-components-breadcrumb.mjs"
+    },
     "./components/button": {
       "types": "./components/button/index.d.ts",
       "default": "./fesm2022/sdcorejs-angular-components-button.mjs"
@@ -75,6 +83,10 @@
       "types": "./components/code-editor/index.d.ts",
       "default": "./fesm2022/sdcorejs-angular-components-code-editor.mjs"
     },
+    "./components/data-state": {
+      "types": "./components/data-state/index.d.ts",
+      "default": "./fesm2022/sdcorejs-angular-components-data-state.mjs"
+    },
     "./components/document-builder": {
       "types": "./components/document-builder/index.d.ts",
       "default": "./fesm2022/sdcorejs-angular-components-document-builder.mjs"
@@ -99,6 +111,10 @@
       "types": "./components/inform/index.d.ts",
       "default": "./fesm2022/sdcorejs-angular-components-inform.mjs"
     },
+    "./components/job-progress": {
+      "types": "./components/job-progress/index.d.ts",
+      "default": "./fesm2022/sdcorejs-angular-components-job-progress.mjs"
+    },
     "./components/mini-editor": {
       "types": "./components/mini-editor/index.d.ts",
       "default": "./fesm2022/sdcorejs-angular-components-mini-editor.mjs"
@@ -219,6 +235,10 @@
       "types": "./forms/directives/index.d.ts",
       "default": "./fesm2022/sdcorejs-angular-forms-directives.mjs"
     },
+    "./forms/entity-picker": {
+      "types": "./forms/entity-picker/index.d.ts",
+      "default": "./fesm2022/sdcorejs-angular-forms-entity-picker.mjs"
+    },
     "./forms/inline-text": {
       "types": "./forms/inline-text/index.d.ts",
       "default": "./fesm2022/sdcorejs-angular-forms-inline-text.mjs"
@@ -259,6 +279,18 @@
       "types": "./forms/textarea/index.d.ts",
       "default": "./fesm2022/sdcorejs-angular-forms-textarea.mjs"
     },
+    "./forms/time": {
+      "types": "./forms/time/index.d.ts",
+      "default": "./fesm2022/sdcorejs-angular-forms-time.mjs"
+    },
+    "./forms/time-range": {
+      "types": "./forms/time-range/index.d.ts",
+      "default": "./fesm2022/sdcorejs-angular-forms-time-range.mjs"
+    },
+    "./forms/tree-select": {
+      "types": "./forms/tree-select/index.d.ts",
+      "default": "./fesm2022/sdcorejs-angular-forms-tree-select.mjs"
+    },
     "./handlers": {
       "types": "./handlers/index.d.ts",
       "default": "./fesm2022/sdcorejs-angular-handlers.mjs"
@@ -339,10 +371,26 @@
       "types": "./services/notify/index.d.ts",
       "default": "./fesm2022/sdcorejs-angular-services-notify.mjs"
     },
+    "./services/persistence": {
+      "types": "./services/persistence/index.d.ts",
+      "default": "./fesm2022/sdcorejs-angular-services-persistence.mjs"
+    },
     "./services/storage": {
       "types": "./services/storage/index.d.ts",
       "default": "./fesm2022/sdcorejs-angular-services-storage.mjs"
     },
+    "./services/task": {
+      "types": "./services/task/index.d.ts",
+      "default": "./fesm2022/sdcorejs-angular-services-task.mjs"
+    },
+    "./services/unsaved-changes": {
+      "types": "./services/unsaved-changes/index.d.ts",
+      "default": "./fesm2022/sdcorejs-angular-services-unsaved-changes.mjs"
+    },
+    "./services/viewport": {
+      "types": "./services/viewport/index.d.ts",
+      "default": "./fesm2022/sdcorejs-angular-services-viewport.mjs"
+    },
     "./utilities": {
       "types": "./utilities/index.d.ts",
       "default": "./fesm2022/sdcorejs-angular-utilities.mjs"

package/pipes/index.d.ts

@@ -1,7 +1,6 @@
 import * as i0 from '@angular/core';
 import { PipeTransform } from '@angular/core';
 import * as _angular_platform_browser from '@angular/platform-browser';
-import { DomSanitizer } from '@angular/platform-browser';
 import { Observable } from 'rxjs';
 
 declare class SdFormatDatePipe implements PipeTransform {
@@ -28,7 +27,8 @@ declare class SdFormatNumberPipe implements PipeTransform {
 
 declare class SdSafeHtmlPipe implements PipeTransform {
     private sanitizer;
-    constructor(sanitizer: DomSanitizer);
+    /** Inserted by Angular inject() migration for backwards compatibility */
+    constructor(...args: unknown[]);
     transform(html: string | number | undefined | null): _angular_platform_browser.SafeHtml | undefined;
     static ɵfac: i0.ɵɵFactoryDeclaration<SdSafeHtmlPipe, never>;
     static ɵpipe: i0.ɵɵPipeDeclaration<SdSafeHtmlPipe, "sdSafeHtml", true>;

package/services/api/index.d.ts

@@ -1,62 +1,106 @@
-import { HttpRequest, HttpResponse, HttpErrorResponse, HttpClient, HttpInterceptor, HttpHandler, HttpEvent } from '@angular/common/http';
+import { HttpRequest, HttpResponse, HttpErrorResponse, HttpHeaders, HttpContext, HttpParams, HttpClient, HttpInterceptor, HttpHandler, HttpEvent } from '@angular/common/http';
 import * as i0 from '@angular/core';
 import { InjectionToken } from '@angular/core';
 import { SdCacheOption } from '@sdcorejs/angular/services/cache';
 import { Observable } from 'rxjs';
 
+type SdApiResponseType = 'arraybuffer' | 'blob' | 'json' | 'text';
+type SdApiBivariantCallback<TArgument, TResult> = {
+    bivarianceHack(argument: TArgument): TResult;
+}['bivarianceHack'];
+interface SdApiHttpOption {
+    headers?: HttpHeaders | Record<string, string | string[]>;
+    context?: HttpContext;
+    params?: HttpParams | Record<string, string | number | boolean | readonly (string | number | boolean)[]>;
+    observe?: 'body';
+    reportProgress?: boolean;
+    responseType?: SdApiResponseType;
+    withCredentials?: boolean;
+    transferCache?: {
+        includeHeaders?: string[];
+    } | boolean;
+}
+interface SdApiRetryOption {
+    /** Number of retries after the initial request. Values are clamped to a finite safe limit. */
+    attempts: number;
+    /** Delay before the first retry. Defaults to 0. */
+    delayMs?: number;
+    /** Multiplier applied to each subsequent delay. Defaults to 1. */
+    backoff?: number;
+    /** Overrides the default transient HTTP-status predicate. `attempt` is one-based. */
+    retryWhen?: (error: unknown, attempt: number) => boolean;
+    /** Required to retry POST, PUT, PATCH, or DELETE. */
+    mutations?: boolean;
+}
 interface SdApiOption {
     cacheOption?: SdCacheOption;
     timeout?: number;
+    /** Cancels only this caller; a shared HTTP request continues while another caller remains. */
+    signal?: AbortSignal;
+    /** Enables request deduplication. Defaults to true for GET and false for mutations. */
+    dedupe?: boolean;
+    /** Keeps a successful dedupe result replayable for this duration. Defaults to 1000ms. */
+    dedupeWindowMs?: number;
+    /** Opt-in bounded retry policy. The default is no retries. */
+    retry?: SdApiRetryOption;
+    /**
+     * @deprecated Use `dedupe`. When both are provided, `dedupe` takes precedence.
+     * Explicit `true` remains a compatibility opt-in for mutation deduplication.
+     */
     autoCache?: boolean;
 }
-type HttpGetOption = Parameters<HttpClient['get']>[1];
-type SdGetOption = HttpGetOption & SdApiOption;
-type HttpPostOption = Parameters<HttpClient['post']>[2];
-type SdPostOption = HttpPostOption & SdApiOption;
-type HttpPutOption = Parameters<HttpClient['put']>[2];
-type SdPutOption = HttpPutOption & SdApiOption;
-type HttpDeleteOption = Parameters<HttpClient['delete']>[1];
-type SdDeleteOption = HttpDeleteOption & SdApiOption;
+type SdGetOption = SdApiHttpOption & SdApiOption;
+type SdPostOption = SdApiHttpOption & SdApiOption;
+type SdPutOption = SdApiHttpOption & SdApiOption;
+type SdPatchOption = SdApiHttpOption & SdApiOption;
+type SdDeleteOption = SdApiHttpOption & SdApiOption;
+type SdApiRequestUpdate = Parameters<HttpRequest<unknown>['clone']>[0];
 interface SdApiHandler {
     /** Danh sách host URL mà handler này sẽ xử lý */
     hosts: string[];
     /** Can thiệp request: gắn header, token, transform body... */
-    intercept?: (request: HttpRequest<any>) => HttpRequest<any>;
+    intercept?: SdApiBivariantCallback<HttpRequest<unknown>, HttpRequest<unknown> | SdApiRequestUpdate>;
     /** Hook chạy TRƯỚC khi gửi request (dùng để log, tracking...) */
-    beforeRemote?: (request: HttpRequest<any>) => void | Promise<void>;
+    beforeRemote?: SdApiBivariantCallback<HttpRequest<unknown>, void | Promise<void>>;
     /** Hook chạy SAU khi nhận response (xử lý lỗi, notify...) */
-    afterRemote?: (response: HttpResponse<any> | HttpErrorResponse | Error) => void | Promise<void>;
+    afterRemote?: SdApiBivariantCallback<HttpResponse<unknown> | HttpErrorResponse | Error, void | Promise<void>>;
     /** Transform response body thành kiểu dữ liệu mong muốn */
-    mapResponse?: <Tres = any, Tdata = any>(response: Tres) => Tdata;
-    /** Timeout tính bằng milliseconds. Mặc định: 30000 (30 giây) */
+    mapResponse?: SdApiBivariantCallback<unknown, unknown>;
+    /** Timeout tính bằng milliseconds. Mặc định: 60000 (60 giây) */
     timeout?: number;
 }
 interface ISdApiConfiguration {
-    handlers: SdApiHandler[];
+    handlers?: SdApiHandler[];
 }
 declare const SD_API_CONFIG: InjectionToken<ISdApiConfiguration>;
+/** @deprecated Use `SD_API_CONFIG`. This is the same injection token. */
 declare const SD_API_CONFIGURATION: InjectionToken<ISdApiConfiguration>;
 
+/**
+ * Response generics intentionally default to `unknown` for type safety.
+ * Callers should specify `T`; migration guidance is tracked for Task 13.
+ */
 declare class SdApiService {
     #private;
     constructor();
     get http(): HttpClient;
-    get: <T = any>(url: string, option?: SdGetOption) => Promise<T>;
-    post: <T = any>(url: string, body?: any, option?: SdPostOption) => Promise<T>;
-    put: <T = any>(url: string, body?: any, option?: SdPutOption) => Promise<T>;
-    delete: <T = any>(url: string, option?: SdDeleteOption) => Promise<T>;
-    upload: (url: string, option?: {
+    get: <T = unknown>(url: string, option?: SdGetOption) => Promise<T>;
+    post: <T = unknown>(url: string, body?: unknown, option?: SdPostOption) => Promise<T>;
+    put: <T = unknown>(url: string, body?: unknown, option?: SdPutOption) => Promise<T>;
+    patch: <T = unknown>(url: string, body?: unknown, option?: SdPatchOption) => Promise<T>;
+    delete: <T = unknown>(url: string, option?: SdDeleteOption) => Promise<T>;
+    upload: <T = unknown>(url: string, option?: {
         extensions?: string[];
         maxSizeInMb?: number;
-    }) => Promise<any>;
-    uploadFile: (url: string, file: File) => Promise<any>;
+    }) => Promise<T | null | undefined>;
+    uploadFile: <T = unknown>(url: string, file: File | null | undefined) => Promise<T | null>;
     static ɵfac: i0.ɵɵFactoryDeclaration<SdApiService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<SdApiService>;
 }
 
 declare class SdHttpInterceptor implements HttpInterceptor {
     #private;
-    intercept(request: HttpRequest<any>, next: HttpHandler): Observable<HttpEvent<any>>;
+    intercept(request: HttpRequest<unknown>, next: HttpHandler): Observable<HttpEvent<unknown>>;
     static ɵfac: i0.ɵɵFactoryDeclaration<SdHttpInterceptor, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<SdHttpInterceptor>;
 }
@@ -68,4 +112,4 @@ declare class SdApiModule {
 }
 
 export { SD_API_CONFIG, SD_API_CONFIGURATION, SdApiModule, SdApiService, SdHttpInterceptor };
-export type { ISdApiConfiguration, SdApiHandler, SdApiOption, SdDeleteOption, SdGetOption, SdPostOption, SdPutOption };
+export type { ISdApiConfiguration, SdApiHandler, SdApiHttpOption, SdApiOption, SdApiRequestUpdate, SdApiResponseType, SdApiRetryOption, SdDeleteOption, SdGetOption, SdPatchOption, SdPostOption, SdPutOption };