@sdcorejs/angular 21.1.3 → 21.1.4

package/types/sdcorejs-angular-modules-layout.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/types/sdcorejs-angular-pipes.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/types/sdcorejs-angular-services-api.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 };

package/types/sdcorejs-angular-services-cache.d.ts

@@ -1,43 +1,79 @@
 import * as i0 from '@angular/core';
 import { InjectionToken } from '@angular/core';
+import { SdPersistenceSerializer, SdPersistenceIdentityCanonicalizer } from '@sdcorejs/angular/services/persistence';
 import { Observable } from 'rxjs';
 
-interface SdCacheOption<T = any> {
+interface SdCacheOption<T = unknown> {
     type?: 'memory' | 'session' | 'local';
     hours?: number;
+    ttlMs?: number;
     default?: T;
-    args?: Record<string, any>;
+    args?: Readonly<Record<string, unknown>>;
+    namespace?: string;
+    version?: string | number;
+    serializer?: SdPersistenceSerializer;
+    identityCanonicalizer?: SdPersistenceIdentityCanonicalizer;
 }
-interface SdCache<T = any> {
-    get: () => T;
+interface SdCache<T = unknown> {
+    get: () => T | undefined;
+    snapshot: () => SdCacheSnapshot<T>;
     set: (data: T) => void;
     has: () => boolean;
     remove: () => void;
+    /** Releases only this facade while preserving its backing cache entry. */
+    release: () => void;
     destroy: () => void;
     observer: Observable<T | undefined>;
     load: (callback: () => Promise<T>) => Promise<T>;
 }
+type SdCacheSnapshot<T> = {
+    present: false;
+} | {
+    present: true;
+    value: T;
+};
+interface SdCacheWithDefault<T> extends Omit<SdCache<T>, 'get' | 'observer'> {
+    get: () => T;
+    observer: Observable<T>;
+}
+interface SdCacheStoredValue<T = unknown> {
+    data: T;
+    createdOn: Date;
+}
+type SdCacheSetCallback = (key: string, value: SdCacheStoredValue<unknown>, option?: SdCacheOption<unknown>) => Promise<void> | void;
+type SdCacheGetCallback = (key: string, option?: SdCacheOption<unknown>) => Promise<SdCacheStoredValue<unknown> | undefined>;
+type SdCacheRemoveCallback = (key: string, option?: SdCacheOption<unknown>) => Promise<void> | void;
 interface ISdCacheConfiguration {
     convertKey?: (key: string) => string;
-    set?: (key: string, value: {
-        data: any;
-        createdOn: Date;
-    }, option?: SdCacheOption) => Promise<void>;
-    get?: (key: string, option?: SdCacheOption) => Promise<{
-        data: any;
-        createdOn: Date;
-    }>;
-    remove?: (key: string, option?: SdCacheOption) => Promise<void>;
+    namespace?: string;
+    version?: string | number;
+    serializer?: SdPersistenceSerializer;
+    identityCanonicalizer?: SdPersistenceIdentityCanonicalizer;
+    set?: SdCacheSetCallback;
+    get?: SdCacheGetCallback;
+    remove?: SdCacheRemoveCallback;
 }
 declare const SD_CACHE_CONFIG: InjectionToken<ISdCacheConfiguration>;
+interface SdLegacyCacheCallbacks<T> {
+    matches: (key: string, option?: SdCacheOption<unknown>) => boolean;
+    isValue: (value: unknown) => value is T;
+    set?: (key: string, value: SdCacheStoredValue<T>, option?: SdCacheOption<unknown>) => Promise<void> | void;
+    get?: (key: string, option?: SdCacheOption<unknown>) => Promise<SdCacheStoredValue<T> | undefined>;
+    remove?: (key: string, option?: SdCacheOption<unknown>) => Promise<void> | void;
+}
+/** @deprecated Prefer globally safe unknown callbacks on `ISdCacheConfiguration`. */
+declare function adaptLegacySdCacheCallbacks<T>(callbacks: SdLegacyCacheCallbacks<T>): ISdCacheConfiguration;
 
 declare class SdCacheService {
     #private;
     constructor();
-    create<T = any>(key: string | object, option?: SdCacheOption<T>): SdCache<T>;
+    create<T>(key: string | object, option: SdCacheOption<T> & {
+        default: T;
+    }): SdCacheWithDefault<T>;
+    create<T = unknown>(key: string | object, option?: SdCacheOption<unknown>): SdCache<T>;
     static ɵfac: i0.ɵɵFactoryDeclaration<SdCacheService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<SdCacheService>;
 }
 
-export { SD_CACHE_CONFIG, SdCacheService };
-export type { ISdCacheConfiguration, SdCache, SdCacheOption };
+export { SD_CACHE_CONFIG, SdCacheService, adaptLegacySdCacheCallbacks };
+export type { ISdCacheConfiguration, SdCache, SdCacheGetCallback, SdCacheOption, SdCacheRemoveCallback, SdCacheSetCallback, SdCacheSnapshot, SdCacheStoredValue, SdCacheWithDefault, SdLegacyCacheCallbacks };

package/types/sdcorejs-angular-services-confirm.d.ts

@@ -1,4 +1,4 @@
-import { MatDialogRef, MatDialog } from '@angular/material/dialog';
+import { MatDialogRef } from '@angular/material/dialog';
 import { Color } from '@sdcorejs/utils/models';
 import * as i0 from '@angular/core';
 
@@ -66,7 +66,8 @@ declare class DialogConfirmComponent {
 declare class SdConfirmService {
     #private;
     private dialog;
-    constructor(dialog: MatDialog);
+    /** Inserted by Angular inject() migration for backwards compatibility */
+    constructor(...args: unknown[]);
     confirm: (message: string, option?: {
         title?: string;
         yesTitle?: string;

package/types/sdcorejs-angular-services-docx.d.ts

@@ -1,5 +1,3 @@
-import { SdNotifyService } from '@sdcorejs/angular/services/notify';
-import { SdLoadingService } from '@sdcorejs/angular/services/loading';
 import * as i0 from '@angular/core';
 
 interface SdDocxConvertOptions {
@@ -16,7 +14,8 @@ declare class SdDocxService {
     #private;
     private notifyService;
     private loadingService;
-    constructor(notifyService: SdNotifyService, loadingService: SdLoadingService);
+    /** Inserted by Angular inject() migration for backwards compatibility */
+    constructor(...args: unknown[]);
     open(options?: SdDocxConvertOptions): Promise<SdDocxConvertResult | null>;
     convertToHtml(input: File | Blob | ArrayBuffer, options?: SdDocxConvertOptions): Promise<SdDocxConvertResult | null>;
     convertToHtmlString(input: File | Blob | ArrayBuffer, options?: SdDocxConvertOptions): Promise<string | null>;