@sdcorejs/angular 21.2.1 → 21.2.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sdcorejs/angular",
-  "version": "21.2.1",
+  "version": "21.2.2",
   "description": "Angular component library: data table, query bar/builder, 20+ signal-based form controls, layout, auth and workflow services. Standalone, OnPush, signals-first. Published in parallel lines for Angular 19, 20 and 21.",
   "keywords": [
     "angular",

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

@@ -588,6 +588,22 @@ declare class SdSidebarMobileV3 {
     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>;
 }
 
+/** Thêm '/' ở cuối để so khớp theo segment: '/appointment' không khớp nhầm '/appointments'. */
+declare const normalizeMenuPath: (path: string) => string;
+/** Route hiện tại có nằm trong nhánh của `path` không (khớp chính xác hoặc khớp phần đầu). */
+declare const isMenuPathMatch: (routePath: string, path: string) => boolean;
+/** Mọi path trong cây menu khớp với route hiện tại. */
+declare const collectMatchedMenuPaths: (menus: SdLayoutMenu[] | null | undefined, routePath: string) => string[];
+/**
+ * Path khớp sát nhất với route hiện tại trong cả cây menu.
+ * Khi cả '/appointment' và '/appointment/cs' cùng khớp route '/appointment/cs',
+ * chỉ path dài nhất được coi là active — path còn lại không được highlight.
+ * Hoà nhau thì lấy path xuất hiện trước theo thứ tự khai báo.
+ */
+declare const resolveActiveMenuPath: (menus: SdLayoutMenu[] | null | undefined, routePath: string) => string | null;
+/** Chính menu này, hoặc bất kỳ menu con nào ở mọi cấp, có đúng path đó. */
+declare const containsMenuPath: (menuItem: SdLayoutMenu, path: string) => boolean;
+
 /**
  * Resolve a translated tab name for `@SdTabComponent`.
  *
@@ -609,8 +625,12 @@ declare class MenuPipe implements PipeTransform {
 }
 
 declare class MenuFocusPipe implements PipeTransform {
-    #private;
-    transform(routePath: string, menuItem: SdLayoutMenu): boolean;
+    /**
+     * @param activeMenuPath Path khớp sát nhất với route hiện tại (xem `resolveActiveMenuPath`).
+     * Truyền vào thì chỉ menu chứa đúng path đó mới focus, nên '/appointment' không sáng khi đang ở
+     * '/appointment/cs'. Bỏ trống thì giữ cách khớp phần đầu cũ.
+     */
+    transform(routePath: string, menuItem: SdLayoutMenu, activeMenuPath?: string | null): boolean;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<MenuFocusPipe, never>;
     static ɵpipe: _angular_core.ɵɵPipeDeclaration<MenuFocusPipe, "menuFocus", true>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<MenuFocusPipe>;
@@ -631,5 +651,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_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 { 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, collectMatchedMenuPaths, containsMenuPath, flattenMenuLeaves, getMenuStableKey, isMenuPathMatch, normalizeLayoutMobileBreakpoint, normalizeMenuPath, normalizeSidebarConfiguration, resolveActiveMenuPath, 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 };