cmat 0.0.96 → 0.0.98

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (93) hide show
  1. package/fesm2022/cmat-components-adapter.mjs +9 -9
  2. package/fesm2022/cmat-components-breadcrumb.mjs +9 -9
  3. package/fesm2022/cmat-components-card.mjs +3 -3
  4. package/fesm2022/cmat-components-carousel.mjs +12 -12
  5. package/fesm2022/cmat-components-cascade.mjs +9 -9
  6. package/fesm2022/cmat-components-chip-input.mjs +3 -3
  7. package/fesm2022/cmat-components-code-editor.mjs +3 -3
  8. package/fesm2022/cmat-components-color-picker.mjs +27 -27
  9. package/fesm2022/cmat-components-custom-formly.mjs +150 -121
  10. package/fesm2022/cmat-components-custom-formly.mjs.map +1 -1
  11. package/fesm2022/cmat-components-data-picker.mjs +113 -35
  12. package/fesm2022/cmat-components-data-picker.mjs.map +1 -1
  13. package/fesm2022/cmat-components-date-range.mjs +5 -5
  14. package/fesm2022/cmat-components-date-range.mjs.map +1 -1
  15. package/fesm2022/cmat-components-date-time-display.mjs +3 -3
  16. package/fesm2022/cmat-components-drawer.mjs +6 -6
  17. package/fesm2022/cmat-components-empty-state.mjs +3 -3
  18. package/fesm2022/cmat-components-file-preview.mjs +3 -3
  19. package/fesm2022/cmat-components-filter-toolbar.mjs +3 -3
  20. package/fesm2022/cmat-components-form-actions.mjs +3 -3
  21. package/fesm2022/cmat-components-fullscreen.mjs +3 -3
  22. package/fesm2022/cmat-components-highlight.mjs +6 -6
  23. package/fesm2022/cmat-components-image-viewer.mjs +3 -3
  24. package/fesm2022/cmat-components-inline-loading.mjs +3 -3
  25. package/fesm2022/cmat-components-json-editor.mjs +3 -3
  26. package/fesm2022/cmat-components-knob-input.mjs +3 -3
  27. package/fesm2022/cmat-components-loading-overlay.mjs +26 -0
  28. package/fesm2022/cmat-components-loading-overlay.mjs.map +1 -0
  29. package/fesm2022/cmat-components-masonry.mjs +3 -3
  30. package/fesm2022/cmat-components-material-color-picker.mjs +3 -3
  31. package/fesm2022/cmat-components-material-datetimepicker.mjs +42 -42
  32. package/fesm2022/cmat-components-navigation.mjs +226 -51
  33. package/fesm2022/cmat-components-navigation.mjs.map +1 -1
  34. package/fesm2022/cmat-components-opt-input.mjs +3 -3
  35. package/fesm2022/cmat-components-org-chart.mjs +9 -9
  36. package/fesm2022/cmat-components-page-header.mjs +3 -3
  37. package/fesm2022/cmat-components-pagination.mjs +12 -12
  38. package/fesm2022/cmat-components-password-strength.mjs +9 -9
  39. package/fesm2022/cmat-components-popover.mjs +9 -9
  40. package/fesm2022/cmat-components-progress-bar.mjs +3 -3
  41. package/fesm2022/cmat-components-qrcode.mjs +3 -3
  42. package/fesm2022/cmat-components-rating.mjs +3 -3
  43. package/fesm2022/cmat-components-rich-text-editor.mjs +3 -3
  44. package/fesm2022/cmat-components-select-search.mjs +9 -9
  45. package/fesm2022/cmat-components-select-table.mjs +3 -3
  46. package/fesm2022/cmat-components-select-tree.mjs +3 -3
  47. package/fesm2022/cmat-components-skeleton.mjs +3 -3
  48. package/fesm2022/cmat-components-speed-dial.mjs +9 -9
  49. package/fesm2022/cmat-components-status-tag.mjs +3 -3
  50. package/fesm2022/cmat-components-table-toolbar.mjs +3 -3
  51. package/fesm2022/cmat-components-timeline.mjs +12 -12
  52. package/fesm2022/cmat-components-toast.mjs +9 -9
  53. package/fesm2022/cmat-components-transfer-picker.mjs +18 -18
  54. package/fesm2022/cmat-components-treetable.mjs +6 -6
  55. package/fesm2022/cmat-components-upload.mjs +9 -9
  56. package/fesm2022/cmat-directives-animate-on-scroll.mjs +6 -6
  57. package/fesm2022/cmat-directives-arrow-cursor.mjs +3 -3
  58. package/fesm2022/cmat-directives-autofocus.mjs +3 -3
  59. package/fesm2022/cmat-directives-data-exporter.mjs +21 -21
  60. package/fesm2022/cmat-directives-debounce.mjs +9 -9
  61. package/fesm2022/cmat-directives-digit-only.mjs +6 -6
  62. package/fesm2022/cmat-directives-equal-validator.mjs +3 -3
  63. package/fesm2022/cmat-directives-seamless-auto-scroll.mjs +3 -3
  64. package/fesm2022/cmat-lib-mock-api.mjs +6 -6
  65. package/fesm2022/cmat-pipes-bytes.mjs +3 -3
  66. package/fesm2022/cmat-pipes-date-format.mjs +3 -3
  67. package/fesm2022/cmat-pipes-find-by-key.mjs +3 -3
  68. package/fesm2022/cmat-pipes-group-by.mjs +3 -3
  69. package/fesm2022/cmat-pipes-keys.mjs +3 -3
  70. package/fesm2022/cmat-pipes-secure.mjs +3 -3
  71. package/fesm2022/cmat-pipes-uppercase.mjs +3 -3
  72. package/fesm2022/cmat-services-alert.mjs +60 -3
  73. package/fesm2022/cmat-services-alert.mjs.map +1 -1
  74. package/fesm2022/cmat-services-config.mjs +6 -6
  75. package/fesm2022/cmat-services-confirmation.mjs +6 -6
  76. package/fesm2022/cmat-services-data.mjs +3 -3
  77. package/fesm2022/cmat-services-export-as.mjs +3 -3
  78. package/fesm2022/cmat-services-loading.mjs +6 -6
  79. package/fesm2022/cmat-services-local-storage.mjs +3 -3
  80. package/fesm2022/cmat-services-media-watcher.mjs +3 -3
  81. package/fesm2022/cmat-services-platform.mjs +3 -3
  82. package/fesm2022/cmat-services-splash-screen.mjs +3 -3
  83. package/fesm2022/cmat-services-title.mjs +3 -3
  84. package/fesm2022/cmat-services-translation.mjs +3 -3
  85. package/fesm2022/cmat-services-utils.mjs +3 -3
  86. package/fesm2022/cmat.mjs +949 -610
  87. package/fesm2022/cmat.mjs.map +1 -1
  88. package/package.json +5 -1
  89. package/types/cmat-components-data-picker.d.ts +33 -0
  90. package/types/cmat-components-loading-overlay.d.ts +11 -0
  91. package/types/cmat-components-navigation.d.ts +36 -0
  92. package/types/cmat-services-alert.d.ts +11 -0
  93. package/types/cmat.d.ts +83 -3
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "cmat",
3
- "version": "0.0.96",
3
+ "version": "0.0.98",
4
4
  "author": {
5
5
  "name": "Yu Tao",
6
6
  "email": "916426364@qq.com"
@@ -141,6 +141,10 @@
141
141
  "types": "./types/cmat-components-knob-input.d.ts",
142
142
  "default": "./fesm2022/cmat-components-knob-input.mjs"
143
143
  },
144
+ "./components/loading-overlay": {
145
+ "types": "./types/cmat-components-loading-overlay.d.ts",
146
+ "default": "./fesm2022/cmat-components-loading-overlay.mjs"
147
+ },
144
148
  "./components/masonry": {
145
149
  "types": "./types/cmat-components-masonry.d.ts",
146
150
  "default": "./fesm2022/cmat-components-masonry.mjs"
@@ -45,12 +45,32 @@ interface DataSourceConfig<T = any> {
45
45
  descField?: string;
46
46
  /** 响应数据映射函数 */
47
47
  responseMapper?: (res: any) => PagedResult<T>;
48
+ /**
49
+ * 按 key 批量加载的 API 地址(可选)
50
+ * 用于支持仅传入 key 值时的回填解析
51
+ * 如未提供,则使用主 url 并在参数中添加 keys 字段
52
+ */
53
+ loadByUrl?: string;
54
+ /**
55
+ * 按 key 加载时的参数字段名,默认 'keys'
56
+ */
57
+ keysParam?: string;
58
+ /**
59
+ * 按 key 加载的响应数据映射函数
60
+ * 如未提供,则尝试直接从响应中提取数组
61
+ */
62
+ loadByKeysMapper?: (res: any) => T[];
48
63
  }
49
64
  /**
50
65
  * 数据提供者接口
51
66
  */
52
67
  interface DataPickerProvider<T = any> {
53
68
  loadPage(query: DataPickerQuery): Observable<PagedResult<T>>;
69
+ /**
70
+ * 按 key 批量加载完整对象(可选)
71
+ * 用于支持仅传入 key 值时的回填解析
72
+ */
73
+ loadByKeys?(keys: (string | number)[]): Observable<T[]>;
54
74
  }
55
75
  /**
56
76
  * 列配置
@@ -74,6 +94,10 @@ declare class HttpDataPickerProvider<T = any> implements DataPickerProvider<T> {
74
94
  private _config;
75
95
  constructor(_dataService: CmatDataService, _config: DataSourceConfig<T>);
76
96
  loadPage(query: DataPickerQuery): Observable<PagedResult<T>>;
97
+ /**
98
+ * 按 key 批量加载完整对象
99
+ */
100
+ loadByKeys(keys: (string | number)[]): Observable<T[]>;
77
101
  }
78
102
  /**
79
103
  * 创建HTTP数据提供者的工厂函数
@@ -355,6 +379,15 @@ declare class CmatDataPickerComponent<T = any> implements MatFormFieldControl<T
355
379
  * Update selection
356
380
  */
357
381
  private updateSelection;
382
+ /**
383
+ * 检测值是否为原始类型(string/number),即纯 key 值
384
+ */
385
+ private _isPrimitiveValue;
386
+ /**
387
+ * 异步解析纯 key 数组为完整对象
388
+ * 调用 dataProvider.loadByKeys 获取完整数据后更新 selectedItems
389
+ */
390
+ private _resolveKeys;
358
391
  /**
359
392
  * Format template string
360
393
  * 支持两种格式:
@@ -0,0 +1,11 @@
1
+ import * as _angular_core from '@angular/core';
2
+
3
+ declare class CmatLoadingOverlayComponent {
4
+ private readonly _alertService;
5
+ readonly visible: _angular_core.Signal<boolean>;
6
+ readonly message: _angular_core.Signal<string>;
7
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<CmatLoadingOverlayComponent, never>;
8
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<CmatLoadingOverlayComponent, "cmat-loading-overlay", never, {}, {}, never, never, true, never>;
9
+ }
10
+
11
+ export { CmatLoadingOverlayComponent };
@@ -48,6 +48,8 @@ declare class CmatHorizontalNavigationComponent implements OnInit, OnDestroy {
48
48
  readonly name: _angular_core.InputSignal<string>;
49
49
  readonly navigation: _angular_core.InputSignal<CmatNavigationItem[] | undefined>;
50
50
  readonly hasRouteReuseStrategy: _angular_core.InputSignal<boolean | undefined>;
51
+ /** 当前激活的 basic 项 id(基于 id 唯一判定,解决 link 重复导致多项同时高亮的问题) */
52
+ readonly activeBasicItemId: _angular_core.WritableSignal<string | null>;
51
53
  /**
52
54
  * 渲染用导航树:refreshToken变化时重新深拷贝整棵树,使每一级item获得新引用。
53
55
  *
@@ -59,12 +61,29 @@ declare class CmatHorizontalNavigationComponent implements OnInit, OnDestroy {
59
61
  */
60
62
  readonly _renderNavigation: _angular_core.Signal<CmatNavigationItem[]>;
61
63
  private _cmatNavigationService;
64
+ private _cmatUtilsService;
65
+ private _router;
66
+ private readonly _destroyRef;
62
67
  constructor();
63
68
  ngOnInit(): void;
64
69
  ngOnDestroy(): void;
65
70
  refresh(): void;
66
71
  trackByFn(index: number, item: CmatNavigationItem): string;
67
72
  goToRouterLink(link: string): void;
73
+ /** basic 项点击时调用,告知父级当前点击的是哪一项 */
74
+ setActiveBasicItemId(id: string | null): void;
75
+ /**
76
+ * 更新 activeBasicItemId:
77
+ * 若当前激活项的 link 仍匹配 URL → 保留(处理重复 link 场景);
78
+ * 否则遍历导航树找首个匹配项。
79
+ */
80
+ private _updateActiveBasicItemId;
81
+ /** 获取导航项的 IsActiveMatchOptions */
82
+ private _getMatchOptions;
83
+ /** 遍历导航树,查找第一个 link 匹配当前 URL 的项 id */
84
+ private _findFirstActiveItemId;
85
+ /** 按 id 在导航树中查找项 */
86
+ private _findItemById;
68
87
  /**
69
88
  * 深拷贝导航项树:每级item及children数组均生成新引用,
70
89
  * 函数属性(hidden等)按引用保留。
@@ -93,6 +112,8 @@ declare class CmatVerticalNavigationComponent implements OnInit, AfterViewInit,
93
112
  readonly transparentOverlay: _angular_core.InputSignal<boolean>;
94
113
  readonly hasRouteReuseStrategy: _angular_core.InputSignal<boolean>;
95
114
  readonly activeAsideItemId: _angular_core.WritableSignal<string | null>;
115
+ /** 当前激活的 basic 项 id(基于 id 唯一判定,解决 link 重复导致多项同时高亮的问题) */
116
+ readonly activeBasicItemId: _angular_core.WritableSignal<string | null>;
96
117
  readonly asideOverlayVisible: _angular_core.WritableSignal<boolean>;
97
118
  onCollapsableItemCollapsed: ReplaySubject<CmatNavigationItem>;
98
119
  onCollapsableItemExpanded: ReplaySubject<CmatNavigationItem>;
@@ -119,6 +140,7 @@ declare class CmatVerticalNavigationComponent implements OnInit, AfterViewInit,
119
140
  private _router;
120
141
  private _scrollStrategyOptions;
121
142
  private _cmatNavigationService;
143
+ private _cmatUtilsService;
122
144
  private readonly _destroyRef;
123
145
  private _asideOverlay;
124
146
  private _asideOverlayClickDestroyFn;
@@ -145,7 +167,21 @@ declare class CmatVerticalNavigationComponent implements OnInit, AfterViewInit,
145
167
  trackByFn(index: number, item: CmatNavigationItem): string;
146
168
  selectItem(item: CmatNavigationItem): void;
147
169
  goToRouterLink(link: string): void;
170
+ /** basic 项点击时调用,告知父级当前点击的是哪一项 */
171
+ setActiveBasicItemId(id: string | null): void;
148
172
  isItemVisible(item: CmatNavigationItem): boolean;
173
+ /**
174
+ * 更新 activeBasicItemId:
175
+ * 若当前激活项的 link 仍匹配 URL → 保留(处理重复 link 场景);
176
+ * 否则遍历导航树找首个匹配项。
177
+ */
178
+ private _updateActiveBasicItemId;
179
+ /** 获取导航项的 IsActiveMatchOptions */
180
+ private _getMatchOptions;
181
+ /** 遍历导航树,查找第一个 link 匹配当前 URL 的项 id */
182
+ private _findFirstActiveItemId;
183
+ /** 按 id 在导航树中查找项 */
184
+ private _findItemById;
149
185
  /**
150
186
  * 深拷贝导航项树:每级item及children数组均生成新引用,
151
187
  * 函数属性(hidden等)按引用保留。
@@ -46,12 +46,19 @@ declare class CmatAlertService {
46
46
  private readonly _bottomMessages;
47
47
  private readonly _dialogs;
48
48
  private readonly _isLoading;
49
+ private readonly _overlayVisible;
50
+ private readonly _overlayMessage;
49
51
  readonly messages: _angular_core.Signal<CmatAlertMessage | null>;
50
52
  readonly stickyMessages: _angular_core.Signal<void | CmatAlertMessage>;
51
53
  readonly bottomMessages: _angular_core.Signal<void | CmatAlertMessage>;
52
54
  readonly dialogs: _angular_core.Signal<CmatAlertDialog | null>;
53
55
  readonly isLoading: _angular_core.Signal<boolean>;
56
+ readonly overlayVisible: _angular_core.Signal<boolean>;
57
+ readonly overlayMessage: _angular_core.Signal<string>;
54
58
  private _loadingMessageId;
59
+ private _overlayShowTimerId;
60
+ private _overlayHideTimerId;
61
+ private _overlayShownAt;
55
62
  showDialog(message: string, type?: CmatDialogType, okCallback?: (val?: unknown) => void, cancelCallback?: () => void, okLabel?: string, cancelLabel?: string, defaultValue?: string): void;
56
63
  showMessage(summary: string): void;
57
64
  showMessage(detail: string | string[] | HttpResponseBase, params: string, severity: CmatMessageSeverity): void;
@@ -62,6 +69,8 @@ declare class CmatAlertService {
62
69
  showStickyMessage(detail: string[] | HttpResponseBase, params: string, severity: CmatMessageSeverity): void;
63
70
  startLoadingMessage(message?: string, caption?: string): void;
64
71
  stopLoadingMessage(): void;
72
+ showOverlay(message?: string): void;
73
+ hideOverlay(): void;
65
74
  logDebug(msg: unknown): void;
66
75
  logError(msg: unknown): void;
67
76
  logInfo(msg: unknown): void;
@@ -73,6 +82,8 @@ declare class CmatAlertService {
73
82
  private _showMessageHelper;
74
83
  private isApiResult;
75
84
  private _clearLoadingMessageTimer;
85
+ private _closeOverlay;
86
+ private _clearOverlayTimers;
76
87
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<CmatAlertService, never>;
77
88
  static ɵprov: _angular_core.ɵɵInjectableDeclaration<CmatAlertService>;
78
89
  }
package/types/cmat.d.ts CHANGED
@@ -1562,12 +1562,32 @@ interface DataSourceConfig<T = any> {
1562
1562
  descField?: string;
1563
1563
  /** 响应数据映射函数 */
1564
1564
  responseMapper?: (res: any) => PagedResult<T>;
1565
+ /**
1566
+ * 按 key 批量加载的 API 地址(可选)
1567
+ * 用于支持仅传入 key 值时的回填解析
1568
+ * 如未提供,则使用主 url 并在参数中添加 keys 字段
1569
+ */
1570
+ loadByUrl?: string;
1571
+ /**
1572
+ * 按 key 加载时的参数字段名,默认 'keys'
1573
+ */
1574
+ keysParam?: string;
1575
+ /**
1576
+ * 按 key 加载的响应数据映射函数
1577
+ * 如未提供,则尝试直接从响应中提取数组
1578
+ */
1579
+ loadByKeysMapper?: (res: any) => T[];
1565
1580
  }
1566
1581
  /**
1567
1582
  * 数据提供者接口
1568
1583
  */
1569
1584
  interface DataPickerProvider<T = any> {
1570
1585
  loadPage(query: DataPickerQuery): Observable<PagedResult<T>>;
1586
+ /**
1587
+ * 按 key 批量加载完整对象(可选)
1588
+ * 用于支持仅传入 key 值时的回填解析
1589
+ */
1590
+ loadByKeys?(keys: (string | number)[]): Observable<T[]>;
1571
1591
  }
1572
1592
  /**
1573
1593
  * 列配置
@@ -1591,6 +1611,10 @@ declare class HttpDataPickerProvider<T = any> implements DataPickerProvider<T> {
1591
1611
  private _config;
1592
1612
  constructor(_dataService: CmatDataService$1, _config: DataSourceConfig<T>);
1593
1613
  loadPage(query: DataPickerQuery): Observable<PagedResult<T>>;
1614
+ /**
1615
+ * 按 key 批量加载完整对象
1616
+ */
1617
+ loadByKeys(keys: (string | number)[]): Observable<T[]>;
1594
1618
  }
1595
1619
  /**
1596
1620
  * 创建HTTP数据提供者的工厂函数
@@ -1788,7 +1812,7 @@ declare class CmatDataPickerComponent<T = any> implements MatFormFieldControl<T
1788
1812
  readonly searchable: _angular_core.InputSignal<boolean>;
1789
1813
  readonly debounceTime: _angular_core.InputSignal<number>;
1790
1814
  readonly pageSize: _angular_core.InputSignal<number>;
1791
- readonly uiMode: _angular_core.InputSignal<"dialog" | "auto" | "drawer" | "bottom-sheet">;
1815
+ readonly uiMode: _angular_core.InputSignal<"auto" | "drawer" | "dialog" | "bottom-sheet">;
1792
1816
  readonly drawerPosition: _angular_core.InputSignal<"start" | "end">;
1793
1817
  readonly drawerWidth: _angular_core.InputSignal<string>;
1794
1818
  readonly dialogWidth: _angular_core.InputSignal<string>;
@@ -1872,6 +1896,15 @@ declare class CmatDataPickerComponent<T = any> implements MatFormFieldControl<T
1872
1896
  * Update selection
1873
1897
  */
1874
1898
  private updateSelection;
1899
+ /**
1900
+ * 检测值是否为原始类型(string/number),即纯 key 值
1901
+ */
1902
+ private _isPrimitiveValue;
1903
+ /**
1904
+ * 异步解析纯 key 数组为完整对象
1905
+ * 调用 dataProvider.loadByKeys 获取完整数据后更新 selectedItems
1906
+ */
1907
+ private _resolveKeys;
1875
1908
  /**
1876
1909
  * Format template string
1877
1910
  * 支持两种格式:
@@ -2067,7 +2100,7 @@ declare class CmatFilterToolbarComponent implements OnInit {
2067
2100
  }
2068
2101
 
2069
2102
  declare class CmatFormActionsComponent {
2070
- readonly align: _angular_core.InputSignal<"center" | "start" | "end">;
2103
+ readonly align: _angular_core.InputSignal<"start" | "end" | "center">;
2071
2104
  readonly divider: _angular_core.InputSignal<boolean>;
2072
2105
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<CmatFormActionsComponent, never>;
2073
2106
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<CmatFormActionsComponent, "cmat-form-actions", never, { "align": { "alias": "align"; "required": false; "isSignal": true; }; "divider": { "alias": "divider"; "required": false; "isSignal": true; }; }, {}, never, ["[cmatFormActionsLeft]", "[cmatFormActions]"], true, never>;
@@ -2839,6 +2872,8 @@ declare class CmatHorizontalNavigationComponent implements OnInit, OnDestroy {
2839
2872
  readonly name: _angular_core.InputSignal<string>;
2840
2873
  readonly navigation: _angular_core.InputSignal<CmatNavigationItem[] | undefined>;
2841
2874
  readonly hasRouteReuseStrategy: _angular_core.InputSignal<boolean | undefined>;
2875
+ /** 当前激活的 basic 项 id(基于 id 唯一判定,解决 link 重复导致多项同时高亮的问题) */
2876
+ readonly activeBasicItemId: _angular_core.WritableSignal<string | null>;
2842
2877
  /**
2843
2878
  * 渲染用导航树:refreshToken变化时重新深拷贝整棵树,使每一级item获得新引用。
2844
2879
  *
@@ -2850,12 +2885,29 @@ declare class CmatHorizontalNavigationComponent implements OnInit, OnDestroy {
2850
2885
  */
2851
2886
  readonly _renderNavigation: _angular_core.Signal<CmatNavigationItem[]>;
2852
2887
  private _cmatNavigationService;
2888
+ private _cmatUtilsService;
2889
+ private _router;
2890
+ private readonly _destroyRef;
2853
2891
  constructor();
2854
2892
  ngOnInit(): void;
2855
2893
  ngOnDestroy(): void;
2856
2894
  refresh(): void;
2857
2895
  trackByFn(index: number, item: CmatNavigationItem): string;
2858
2896
  goToRouterLink(link: string): void;
2897
+ /** basic 项点击时调用,告知父级当前点击的是哪一项 */
2898
+ setActiveBasicItemId(id: string | null): void;
2899
+ /**
2900
+ * 更新 activeBasicItemId:
2901
+ * 若当前激活项的 link 仍匹配 URL → 保留(处理重复 link 场景);
2902
+ * 否则遍历导航树找首个匹配项。
2903
+ */
2904
+ private _updateActiveBasicItemId;
2905
+ /** 获取导航项的 IsActiveMatchOptions */
2906
+ private _getMatchOptions;
2907
+ /** 遍历导航树,查找第一个 link 匹配当前 URL 的项 id */
2908
+ private _findFirstActiveItemId;
2909
+ /** 按 id 在导航树中查找项 */
2910
+ private _findItemById;
2859
2911
  /**
2860
2912
  * 深拷贝导航项树:每级item及children数组均生成新引用,
2861
2913
  * 函数属性(hidden等)按引用保留。
@@ -2884,6 +2936,8 @@ declare class CmatVerticalNavigationComponent implements OnInit, AfterViewInit,
2884
2936
  readonly transparentOverlay: _angular_core.InputSignal<boolean>;
2885
2937
  readonly hasRouteReuseStrategy: _angular_core.InputSignal<boolean>;
2886
2938
  readonly activeAsideItemId: _angular_core.WritableSignal<string | null>;
2939
+ /** 当前激活的 basic 项 id(基于 id 唯一判定,解决 link 重复导致多项同时高亮的问题) */
2940
+ readonly activeBasicItemId: _angular_core.WritableSignal<string | null>;
2887
2941
  readonly asideOverlayVisible: _angular_core.WritableSignal<boolean>;
2888
2942
  onCollapsableItemCollapsed: ReplaySubject<CmatNavigationItem>;
2889
2943
  onCollapsableItemExpanded: ReplaySubject<CmatNavigationItem>;
@@ -2910,6 +2964,7 @@ declare class CmatVerticalNavigationComponent implements OnInit, AfterViewInit,
2910
2964
  private _router;
2911
2965
  private _scrollStrategyOptions;
2912
2966
  private _cmatNavigationService;
2967
+ private _cmatUtilsService;
2913
2968
  private readonly _destroyRef;
2914
2969
  private _asideOverlay;
2915
2970
  private _asideOverlayClickDestroyFn;
@@ -2936,7 +2991,21 @@ declare class CmatVerticalNavigationComponent implements OnInit, AfterViewInit,
2936
2991
  trackByFn(index: number, item: CmatNavigationItem): string;
2937
2992
  selectItem(item: CmatNavigationItem): void;
2938
2993
  goToRouterLink(link: string): void;
2994
+ /** basic 项点击时调用,告知父级当前点击的是哪一项 */
2995
+ setActiveBasicItemId(id: string | null): void;
2939
2996
  isItemVisible(item: CmatNavigationItem): boolean;
2997
+ /**
2998
+ * 更新 activeBasicItemId:
2999
+ * 若当前激活项的 link 仍匹配 URL → 保留(处理重复 link 场景);
3000
+ * 否则遍历导航树找首个匹配项。
3001
+ */
3002
+ private _updateActiveBasicItemId;
3003
+ /** 获取导航项的 IsActiveMatchOptions */
3004
+ private _getMatchOptions;
3005
+ /** 遍历导航树,查找第一个 link 匹配当前 URL 的项 id */
3006
+ private _findFirstActiveItemId;
3007
+ /** 按 id 在导航树中查找项 */
3008
+ private _findItemById;
2940
3009
  /**
2941
3010
  * 深拷贝导航项树:每级item及children数组均生成新引用,
2942
3011
  * 函数属性(hidden等)按引用保留。
@@ -3100,7 +3169,7 @@ declare class CmatPageHeaderComponent {
3100
3169
  readonly description: _angular_core.InputSignal<string>;
3101
3170
  readonly eyebrow: _angular_core.InputSignal<string>;
3102
3171
  readonly divider: _angular_core.InputSignal<boolean>;
3103
- readonly align: _angular_core.InputSignal<"center" | "start">;
3172
+ readonly align: _angular_core.InputSignal<"start" | "center">;
3104
3173
  readonly isCentered: _angular_core.Signal<boolean>;
3105
3174
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<CmatPageHeaderComponent, never>;
3106
3175
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<CmatPageHeaderComponent, "cmat-page-header", never, { "title": { "alias": "title"; "required": false; "isSignal": true; }; "description": { "alias": "description"; "required": false; "isSignal": true; }; "eyebrow": { "alias": "eyebrow"; "required": false; "isSignal": true; }; "divider": { "alias": "divider"; "required": false; "isSignal": true; }; "align": { "alias": "align"; "required": false; "isSignal": true; }; }, {}, never, ["[cmatPageHeaderActions]"], true, never>;
@@ -4811,12 +4880,19 @@ declare class CmatAlertService {
4811
4880
  private readonly _bottomMessages;
4812
4881
  private readonly _dialogs;
4813
4882
  private readonly _isLoading;
4883
+ private readonly _overlayVisible;
4884
+ private readonly _overlayMessage;
4814
4885
  readonly messages: _angular_core.Signal<CmatAlertMessage | null>;
4815
4886
  readonly stickyMessages: _angular_core.Signal<void | CmatAlertMessage>;
4816
4887
  readonly bottomMessages: _angular_core.Signal<void | CmatAlertMessage>;
4817
4888
  readonly dialogs: _angular_core.Signal<CmatAlertDialog | null>;
4818
4889
  readonly isLoading: _angular_core.Signal<boolean>;
4890
+ readonly overlayVisible: _angular_core.Signal<boolean>;
4891
+ readonly overlayMessage: _angular_core.Signal<string>;
4819
4892
  private _loadingMessageId;
4893
+ private _overlayShowTimerId;
4894
+ private _overlayHideTimerId;
4895
+ private _overlayShownAt;
4820
4896
  showDialog(message: string, type?: CmatDialogType, okCallback?: (val?: unknown) => void, cancelCallback?: () => void, okLabel?: string, cancelLabel?: string, defaultValue?: string): void;
4821
4897
  showMessage(summary: string): void;
4822
4898
  showMessage(detail: string | string[] | HttpResponseBase, params: string, severity: CmatMessageSeverity): void;
@@ -4827,6 +4903,8 @@ declare class CmatAlertService {
4827
4903
  showStickyMessage(detail: string[] | HttpResponseBase, params: string, severity: CmatMessageSeverity): void;
4828
4904
  startLoadingMessage(message?: string, caption?: string): void;
4829
4905
  stopLoadingMessage(): void;
4906
+ showOverlay(message?: string): void;
4907
+ hideOverlay(): void;
4830
4908
  logDebug(msg: unknown): void;
4831
4909
  logError(msg: unknown): void;
4832
4910
  logInfo(msg: unknown): void;
@@ -4838,6 +4916,8 @@ declare class CmatAlertService {
4838
4916
  private _showMessageHelper;
4839
4917
  private isApiResult;
4840
4918
  private _clearLoadingMessageTimer;
4919
+ private _closeOverlay;
4920
+ private _clearOverlayTimers;
4841
4921
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<CmatAlertService, never>;
4842
4922
  static ɵprov: _angular_core.ɵɵInjectableDeclaration<CmatAlertService>;
4843
4923
  }