@angular/material 19.2.2 → 19.2.3

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 (194) hide show
  1. package/autocomplete/index.d.ts +83 -124
  2. package/autocomplete/testing/index.d.ts +5 -11
  3. package/badge/index.d.ts +17 -30
  4. package/badge/testing/index.d.ts +5 -8
  5. package/bottom-sheet/index.d.ts +88 -103
  6. package/bottom-sheet/testing/index.d.ts +4 -6
  7. package/button/index.d.ts +109 -148
  8. package/button/testing/index.d.ts +6 -10
  9. package/button-toggle/index.d.ts +116 -142
  10. package/button-toggle/testing/index.d.ts +34 -36
  11. package/card/index.d.ts +79 -117
  12. package/card/testing/index.d.ts +11 -15
  13. package/checkbox/index.d.ts +55 -85
  14. package/checkbox/testing/index.d.ts +6 -10
  15. package/chips/index.d.ts +592 -690
  16. package/chips/testing/index.d.ts +78 -93
  17. package/core/index.d.ts +565 -669
  18. package/core/testing/index.d.ts +28 -32
  19. package/datepicker/index.d.ts +1323 -1479
  20. package/datepicker/testing/index.d.ts +109 -119
  21. package/dialog/index.d.ts +194 -246
  22. package/dialog/testing/index.d.ts +17 -26
  23. package/divider/index.d.ts +4 -10
  24. package/divider/testing/index.d.ts +4 -6
  25. package/expansion/index.d.ts +137 -189
  26. package/expansion/testing/index.d.ts +25 -31
  27. package/fesm2022/autocomplete/testing.mjs.map +1 -1
  28. package/fesm2022/autocomplete.mjs +26 -17
  29. package/fesm2022/autocomplete.mjs.map +1 -1
  30. package/fesm2022/badge/testing.mjs.map +1 -1
  31. package/fesm2022/badge.mjs +3 -7
  32. package/fesm2022/badge.mjs.map +1 -1
  33. package/fesm2022/bottom-sheet/testing.mjs.map +1 -1
  34. package/fesm2022/bottom-sheet.mjs +0 -4
  35. package/fesm2022/bottom-sheet.mjs.map +1 -1
  36. package/fesm2022/button/testing.mjs.map +1 -1
  37. package/fesm2022/button-toggle/testing.mjs.map +1 -1
  38. package/fesm2022/button-toggle.mjs +5 -4
  39. package/fesm2022/button-toggle.mjs.map +1 -1
  40. package/fesm2022/button.mjs +6 -6
  41. package/fesm2022/button.mjs.map +1 -1
  42. package/fesm2022/card/testing.mjs.map +1 -1
  43. package/fesm2022/card.mjs +0 -4
  44. package/fesm2022/card.mjs.map +1 -1
  45. package/fesm2022/checkbox/testing.mjs.map +1 -1
  46. package/fesm2022/checkbox.mjs +5 -5
  47. package/fesm2022/checkbox.mjs.map +1 -1
  48. package/fesm2022/chips/testing.mjs.map +1 -1
  49. package/fesm2022/chips.mjs +0 -4
  50. package/fesm2022/chips.mjs.map +1 -1
  51. package/fesm2022/core/testing.mjs.map +1 -1
  52. package/fesm2022/core.mjs +7 -7
  53. package/fesm2022/core.mjs.map +1 -1
  54. package/fesm2022/datepicker/testing.mjs.map +1 -1
  55. package/fesm2022/datepicker.mjs +42 -18
  56. package/fesm2022/datepicker.mjs.map +1 -1
  57. package/fesm2022/dialog/testing.mjs.map +1 -1
  58. package/fesm2022/dialog.mjs +4 -8
  59. package/fesm2022/dialog.mjs.map +1 -1
  60. package/fesm2022/divider/testing.mjs.map +1 -1
  61. package/fesm2022/divider.mjs +0 -4
  62. package/fesm2022/divider.mjs.map +1 -1
  63. package/fesm2022/expansion/testing.mjs.map +1 -1
  64. package/fesm2022/expansion.mjs +2 -6
  65. package/fesm2022/expansion.mjs.map +1 -1
  66. package/fesm2022/form-field/testing.mjs +0 -2
  67. package/fesm2022/form-field/testing.mjs.map +1 -1
  68. package/fesm2022/form-field.mjs +0 -4
  69. package/fesm2022/form-field.mjs.map +1 -1
  70. package/fesm2022/grid-list/testing.mjs.map +1 -1
  71. package/fesm2022/grid-list.mjs +0 -4
  72. package/fesm2022/grid-list.mjs.map +1 -1
  73. package/fesm2022/icon/testing.mjs +0 -4
  74. package/fesm2022/icon/testing.mjs.map +1 -1
  75. package/fesm2022/icon.mjs +15 -7
  76. package/fesm2022/icon.mjs.map +1 -1
  77. package/fesm2022/input/testing.mjs.map +1 -1
  78. package/fesm2022/input.mjs +0 -4
  79. package/fesm2022/input.mjs.map +1 -1
  80. package/fesm2022/list/testing.mjs +1 -1
  81. package/fesm2022/list/testing.mjs.map +1 -1
  82. package/fesm2022/list.mjs +2 -6
  83. package/fesm2022/list.mjs.map +1 -1
  84. package/fesm2022/menu/testing.mjs.map +1 -1
  85. package/fesm2022/menu.mjs +15 -7
  86. package/fesm2022/menu.mjs.map +1 -1
  87. package/fesm2022/paginator/testing.mjs.map +1 -1
  88. package/fesm2022/paginator.mjs +10 -6
  89. package/fesm2022/paginator.mjs.map +1 -1
  90. package/fesm2022/progress-bar/testing.mjs +0 -4
  91. package/fesm2022/progress-bar/testing.mjs.map +1 -1
  92. package/fesm2022/progress-bar.mjs +5 -5
  93. package/fesm2022/progress-bar.mjs.map +1 -1
  94. package/fesm2022/progress-spinner/testing.mjs +0 -4
  95. package/fesm2022/progress-spinner/testing.mjs.map +1 -1
  96. package/fesm2022/progress-spinner.mjs +5 -5
  97. package/fesm2022/progress-spinner.mjs.map +1 -1
  98. package/fesm2022/radio/testing.mjs.map +1 -1
  99. package/fesm2022/radio.mjs +5 -4
  100. package/fesm2022/radio.mjs.map +1 -1
  101. package/fesm2022/select/testing.mjs.map +1 -1
  102. package/fesm2022/select.mjs +14 -10
  103. package/fesm2022/select.mjs.map +1 -1
  104. package/fesm2022/sidenav/testing.mjs +1 -1
  105. package/fesm2022/sidenav/testing.mjs.map +1 -1
  106. package/fesm2022/sidenav.mjs +9 -9
  107. package/fesm2022/sidenav.mjs.map +1 -1
  108. package/fesm2022/slide-toggle/testing.mjs.map +1 -1
  109. package/fesm2022/slide-toggle.mjs +0 -4
  110. package/fesm2022/slide-toggle.mjs.map +1 -1
  111. package/fesm2022/slider/testing.mjs.map +1 -1
  112. package/fesm2022/slider.mjs +0 -4
  113. package/fesm2022/slider.mjs.map +1 -1
  114. package/fesm2022/snack-bar/testing.mjs.map +1 -1
  115. package/fesm2022/snack-bar.mjs +5 -5
  116. package/fesm2022/snack-bar.mjs.map +1 -1
  117. package/fesm2022/sort/testing.mjs.map +1 -1
  118. package/fesm2022/sort.mjs +10 -6
  119. package/fesm2022/sort.mjs.map +1 -1
  120. package/fesm2022/stepper/testing.mjs.map +1 -1
  121. package/fesm2022/stepper.mjs +10 -6
  122. package/fesm2022/stepper.mjs.map +1 -1
  123. package/fesm2022/table/testing.mjs.map +1 -1
  124. package/fesm2022/table.mjs +0 -4
  125. package/fesm2022/table.mjs.map +1 -1
  126. package/fesm2022/tabs/testing.mjs.map +1 -1
  127. package/fesm2022/tabs.mjs +8 -15
  128. package/fesm2022/tabs.mjs.map +1 -1
  129. package/fesm2022/timepicker/testing.mjs.map +1 -1
  130. package/fesm2022/timepicker.mjs +1 -5
  131. package/fesm2022/timepicker.mjs.map +1 -1
  132. package/fesm2022/toolbar/testing.mjs.map +1 -1
  133. package/fesm2022/toolbar.mjs +0 -4
  134. package/fesm2022/toolbar.mjs.map +1 -1
  135. package/fesm2022/tooltip/testing.mjs.map +1 -1
  136. package/fesm2022/tooltip.mjs +15 -7
  137. package/fesm2022/tooltip.mjs.map +1 -1
  138. package/fesm2022/tree/testing.mjs.map +1 -1
  139. package/fesm2022/tree.mjs +0 -4
  140. package/fesm2022/tree.mjs.map +1 -1
  141. package/form-field/index.d.ts +251 -318
  142. package/form-field/testing/control/index.d.ts +2 -2
  143. package/form-field/testing/index.d.ts +14 -21
  144. package/grid-list/index.d.ts +124 -150
  145. package/grid-list/testing/index.d.ts +39 -44
  146. package/icon/index.d.ts +87 -108
  147. package/icon/testing/index.d.ts +38 -43
  148. package/index.d.ts +2 -3
  149. package/input/index.d.ts +27 -61
  150. package/input/testing/index.d.ts +16 -19
  151. package/list/index.d.ts +158 -241
  152. package/list/testing/index.d.ts +157 -179
  153. package/menu/index.d.ts +180 -231
  154. package/menu/testing/index.d.ts +17 -23
  155. package/package.json +2 -2
  156. package/paginator/index.d.ts +84 -97
  157. package/paginator/testing/index.d.ts +10 -14
  158. package/progress-bar/index.d.ts +38 -58
  159. package/progress-bar/testing/index.d.ts +7 -10
  160. package/progress-spinner/index.d.ts +38 -51
  161. package/progress-spinner/testing/index.d.ts +7 -10
  162. package/radio/index.d.ts +145 -168
  163. package/radio/testing/index.d.ts +61 -67
  164. package/schematics/ng-add/index.js +1 -1
  165. package/schematics/ng-add/index.mjs +1 -1
  166. package/schematics/ng-generate/theme-color/index_bundled.js +2 -2
  167. package/schematics/ng-generate/theme-color/schema.json +10 -0
  168. package/schematics/ng-update/index_bundled.js +31 -31
  169. package/select/index.d.ts +77 -130
  170. package/select/testing/index.d.ts +10 -15
  171. package/sidenav/index.d.ts +47 -91
  172. package/sidenav/testing/index.d.ts +58 -63
  173. package/slide-toggle/index.d.ts +51 -84
  174. package/slide-toggle/testing/index.d.ts +17 -21
  175. package/slider/index.d.ts +277 -327
  176. package/slider/testing/index.d.ts +42 -47
  177. package/snack-bar/index.d.ts +147 -185
  178. package/snack-bar/testing/index.d.ts +7 -9
  179. package/sort/index.d.ts +94 -124
  180. package/sort/testing/index.d.ts +21 -24
  181. package/stepper/index.d.ts +108 -165
  182. package/stepper/testing/index.d.ts +43 -52
  183. package/table/index.d.ts +87 -153
  184. package/table/testing/index.d.ts +64 -78
  185. package/tabs/index.d.ts +306 -382
  186. package/tabs/testing/index.d.ts +67 -76
  187. package/timepicker/index.d.ts +123 -159
  188. package/timepicker/testing/index.d.ts +20 -26
  189. package/toolbar/index.d.ts +13 -25
  190. package/toolbar/testing/index.d.ts +13 -16
  191. package/tooltip/index.d.ts +88 -117
  192. package/tooltip/testing/index.d.ts +7 -10
  193. package/tree/index.d.ts +116 -163
  194. package/tree/testing/index.d.ts +52 -58
package/menu/index.d.ts CHANGED
@@ -1,96 +1,159 @@
1
- import { AfterContentInit } from '@angular/core';
2
- import { AfterViewInit } from '@angular/core';
3
- import { Direction } from '@angular/cdk/bidi';
4
- import { EventEmitter } from '@angular/core';
5
- import { FocusableOption } from '@angular/cdk/a11y';
6
- import { FocusOrigin } from '@angular/cdk/a11y';
7
1
  import * as i0 from '@angular/core';
8
- import * as i1 from '@angular/material/core';
2
+ import { InjectionToken, OnDestroy, TemplateRef, EventEmitter, AfterViewInit, AfterContentInit, OnInit, QueryList } from '@angular/core';
3
+ import { FocusOrigin, FocusableOption } from '@angular/cdk/a11y';
4
+ import { Direction } from '@angular/cdk/bidi';
5
+ import { Subject, Observable } from 'rxjs';
9
6
  import * as i2 from '@angular/cdk/overlay';
10
- import * as i7 from '@angular/cdk/scrolling';
11
- import { InjectionToken } from '@angular/core';
12
- import { Observable } from 'rxjs';
13
- import { OnDestroy } from '@angular/core';
14
- import { OnInit } from '@angular/core';
15
- import { Overlay } from '@angular/cdk/overlay';
16
- import { QueryList } from '@angular/core';
17
- import { ScrollStrategy } from '@angular/cdk/overlay';
18
- import { Subject } from 'rxjs';
19
- import { TemplateRef } from '@angular/core';
20
-
21
- /**
22
- * @deprecated
23
- * @breaking-change 8.0.0
24
- * @docs-private
25
- */
26
- export declare const fadeInItems: any;
27
-
28
- declare namespace i3 {
29
- export {
30
- MAT_MENU_DEFAULT_OPTIONS_FACTORY,
31
- MenuCloseReason,
32
- MatMenuDefaultOptions,
33
- MAT_MENU_DEFAULT_OPTIONS,
34
- MatMenu
35
- }
36
- }
37
-
38
- declare namespace i4 {
39
- export {
40
- MatMenuItem
41
- }
42
- }
43
-
44
- declare namespace i5 {
45
- export {
46
- MAT_MENU_CONTENT,
47
- MatMenuContent
48
- }
49
- }
7
+ import { ScrollStrategy, Overlay } from '@angular/cdk/overlay';
8
+ import * as i1 from '@angular/material/core';
9
+ import * as i2$1 from '@angular/cdk/scrolling';
50
10
 
51
- declare namespace i6 {
52
- export {
53
- MAT_MENU_SCROLL_STRATEGY_FACTORY,
54
- MAT_MENU_SCROLL_STRATEGY,
55
- MAT_MENU_SCROLL_STRATEGY_FACTORY_PROVIDER,
56
- MENU_PANEL_TOP_PADDING,
57
- MatMenuTrigger
58
- }
59
- }
11
+ type MenuPositionX = 'before' | 'after';
12
+ type MenuPositionY = 'above' | 'below';
60
13
 
61
14
  /**
62
15
  * Injection token that can be used to reference instances of `MatMenuContent`. It serves
63
16
  * as alternative token to the actual `MatMenuContent` class which could cause unnecessary
64
17
  * retention of the class and its directive metadata.
65
18
  */
66
- export declare const MAT_MENU_CONTENT: InjectionToken<MatMenuContent>;
67
-
68
- /** Injection token to be used to override the default options for `mat-menu`. */
69
- export declare const MAT_MENU_DEFAULT_OPTIONS: InjectionToken<MatMenuDefaultOptions>;
70
-
71
- /** @docs-private */
72
- declare function MAT_MENU_DEFAULT_OPTIONS_FACTORY(): MatMenuDefaultOptions;
19
+ declare const MAT_MENU_CONTENT: InjectionToken<MatMenuContent>;
20
+ /** Menu content that will be rendered lazily once the menu is opened. */
21
+ declare class MatMenuContent implements OnDestroy {
22
+ private _template;
23
+ private _appRef;
24
+ private _injector;
25
+ private _viewContainerRef;
26
+ private _document;
27
+ private _changeDetectorRef;
28
+ private _portal;
29
+ private _outlet;
30
+ /** Emits when the menu content has been attached. */
31
+ readonly _attached: Subject<void>;
32
+ constructor(...args: unknown[]);
33
+ /**
34
+ * Attaches the content with a particular context.
35
+ * @docs-private
36
+ */
37
+ attach(context?: any): void;
38
+ /**
39
+ * Detaches the content.
40
+ * @docs-private
41
+ */
42
+ detach(): void;
43
+ ngOnDestroy(): void;
44
+ static ɵfac: i0.ɵɵFactoryDeclaration<MatMenuContent, never>;
45
+ static ɵdir: i0.ɵɵDirectiveDeclaration<MatMenuContent, "ng-template[matMenuContent]", never, {}, {}, never, never, true, never>;
46
+ }
73
47
 
74
48
  /**
75
49
  * Injection token used to provide the parent menu to menu-specific components.
76
50
  * @docs-private
77
51
  */
78
- export declare const MAT_MENU_PANEL: InjectionToken<MatMenuPanel<any>>;
79
-
80
- /** Injection token that determines the scroll handling while the menu is open. */
81
- export declare const MAT_MENU_SCROLL_STRATEGY: InjectionToken<() => ScrollStrategy>;
82
-
83
- /** @docs-private */
84
- declare function MAT_MENU_SCROLL_STRATEGY_FACTORY(overlay: Overlay): () => ScrollStrategy;
52
+ declare const MAT_MENU_PANEL: InjectionToken<MatMenuPanel<any>>;
53
+ /**
54
+ * Interface for a custom menu panel that can be used with `matMenuTriggerFor`.
55
+ * @docs-private
56
+ */
57
+ interface MatMenuPanel<T = any> {
58
+ xPosition: MenuPositionX;
59
+ yPosition: MenuPositionY;
60
+ overlapTrigger: boolean;
61
+ templateRef: TemplateRef<any>;
62
+ readonly close: EventEmitter<void | 'click' | 'keydown' | 'tab'>;
63
+ parentMenu?: MatMenuPanel | undefined;
64
+ direction?: Direction;
65
+ focusFirstItem: (origin?: FocusOrigin) => void;
66
+ resetActiveItem: () => void;
67
+ setPositionClasses?: (x: MenuPositionX, y: MenuPositionY) => void;
68
+ /**
69
+ * @deprecated No longer used and will be removed.
70
+ * @breaking-change 21.0.0
71
+ */
72
+ setElevation?(depth: number): void;
73
+ lazyContent?: MatMenuContent;
74
+ backdropClass?: string;
75
+ overlayPanelClass?: string | string[];
76
+ hasBackdrop?: boolean;
77
+ readonly panelId?: string;
78
+ /**
79
+ * @deprecated To be removed.
80
+ * @breaking-change 8.0.0
81
+ */
82
+ addItem?: (item: T) => void;
83
+ /**
84
+ * @deprecated To be removed.
85
+ * @breaking-change 8.0.0
86
+ */
87
+ removeItem?: (item: T) => void;
88
+ }
85
89
 
86
- /** @docs-private */
87
- export declare const MAT_MENU_SCROLL_STRATEGY_FACTORY_PROVIDER: {
88
- provide: InjectionToken<() => ScrollStrategy>;
89
- deps: (typeof Overlay)[];
90
- useFactory: typeof MAT_MENU_SCROLL_STRATEGY_FACTORY;
91
- };
90
+ /**
91
+ * Single item inside a `mat-menu`. Provides the menu item styling and accessibility treatment.
92
+ */
93
+ declare class MatMenuItem implements FocusableOption, AfterViewInit, OnDestroy {
94
+ private _elementRef;
95
+ private _document;
96
+ private _focusMonitor;
97
+ _parentMenu?: MatMenuPanel<MatMenuItem> | null | undefined;
98
+ private _changeDetectorRef;
99
+ /** ARIA role for the menu item. */
100
+ role: 'menuitem' | 'menuitemradio' | 'menuitemcheckbox';
101
+ /** Whether the menu item is disabled. */
102
+ disabled: boolean;
103
+ /** Whether ripples are disabled on the menu item. */
104
+ disableRipple: boolean;
105
+ /** Stream that emits when the menu item is hovered. */
106
+ readonly _hovered: Subject<MatMenuItem>;
107
+ /** Stream that emits when the menu item is focused. */
108
+ readonly _focused: Subject<MatMenuItem>;
109
+ /** Whether the menu item is highlighted. */
110
+ _highlighted: boolean;
111
+ /** Whether the menu item acts as a trigger for a sub-menu. */
112
+ _triggersSubmenu: boolean;
113
+ constructor(...args: unknown[]);
114
+ /** Focuses the menu item. */
115
+ focus(origin?: FocusOrigin, options?: FocusOptions): void;
116
+ ngAfterViewInit(): void;
117
+ ngOnDestroy(): void;
118
+ /** Used to set the `tabindex`. */
119
+ _getTabIndex(): string;
120
+ /** Returns the host DOM element. */
121
+ _getHostElement(): HTMLElement;
122
+ /** Prevents the default element actions if it is disabled. */
123
+ _checkDisabled(event: Event): void;
124
+ /** Emits to the hover stream. */
125
+ _handleMouseEnter(): void;
126
+ /** Gets the label to be used when determining whether the option should be focused. */
127
+ getLabel(): string;
128
+ _setHighlighted(isHighlighted: boolean): void;
129
+ _setTriggersSubmenu(triggersSubmenu: boolean): void;
130
+ _hasFocus(): boolean;
131
+ static ɵfac: i0.ɵɵFactoryDeclaration<MatMenuItem, never>;
132
+ static ɵcmp: i0.ɵɵComponentDeclaration<MatMenuItem, "[mat-menu-item]", ["matMenuItem"], { "role": { "alias": "role"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "disableRipple": { "alias": "disableRipple"; "required": false; }; }, {}, never, ["mat-icon, [matMenuItemIcon]", "*"], true, never>;
133
+ static ngAcceptInputType_disabled: unknown;
134
+ static ngAcceptInputType_disableRipple: unknown;
135
+ }
92
136
 
93
- export declare class MatMenu implements AfterContentInit, MatMenuPanel<MatMenuItem>, OnInit, OnDestroy {
137
+ /** Reason why the menu was closed. */
138
+ type MenuCloseReason = void | 'click' | 'keydown' | 'tab';
139
+ /** Default `mat-menu` options that can be overridden. */
140
+ interface MatMenuDefaultOptions {
141
+ /** The x-axis position of the menu. */
142
+ xPosition: MenuPositionX;
143
+ /** The y-axis position of the menu. */
144
+ yPosition: MenuPositionY;
145
+ /** Whether the menu should overlap the menu trigger. */
146
+ overlapTrigger: boolean;
147
+ /** Class to be applied to the menu's backdrop. */
148
+ backdropClass: string;
149
+ /** Class or list of classes to be applied to the menu's overlay panel. */
150
+ overlayPanelClass?: string | string[];
151
+ /** Whether the menu has a backdrop. */
152
+ hasBackdrop?: boolean;
153
+ }
154
+ /** Injection token to be used to override the default options for `mat-menu`. */
155
+ declare const MAT_MENU_DEFAULT_OPTIONS: InjectionToken<MatMenuDefaultOptions>;
156
+ declare class MatMenu implements AfterContentInit, MatMenuPanel<MatMenuItem>, OnInit, OnDestroy {
94
157
  private _elementRef;
95
158
  private _changeDetectorRef;
96
159
  private _injector;
@@ -236,155 +299,32 @@ export declare class MatMenu implements AfterContentInit, MatMenuPanel<MatMenuIt
236
299
  static ngAcceptInputType_hasBackdrop: any;
237
300
  }
238
301
 
302
+ /** Injection token that determines the scroll handling while the menu is open. */
303
+ declare const MAT_MENU_SCROLL_STRATEGY: InjectionToken<() => ScrollStrategy>;
239
304
  /**
240
- * Animations used by the mat-menu component.
241
- * Animation duration and timing values are based on:
242
- * https://material.io/guidelines/components/menus.html#menus-usage
243
305
  * @docs-private
244
306
  * @deprecated No longer used, will be removed.
245
307
  * @breaking-change 21.0.0
246
308
  */
247
- export declare const matMenuAnimations: {
248
- readonly transformMenu: any;
249
- readonly fadeInItems: any;
250
- };
251
-
252
- /** Menu content that will be rendered lazily once the menu is opened. */
253
- export declare class MatMenuContent implements OnDestroy {
254
- private _template;
255
- private _appRef;
256
- private _injector;
257
- private _viewContainerRef;
258
- private _document;
259
- private _changeDetectorRef;
260
- private _portal;
261
- private _outlet;
262
- /** Emits when the menu content has been attached. */
263
- readonly _attached: Subject<void>;
264
- constructor(...args: unknown[]);
265
- /**
266
- * Attaches the content with a particular context.
267
- * @docs-private
268
- */
269
- attach(context?: any): void;
270
- /**
271
- * Detaches the content.
272
- * @docs-private
273
- */
274
- detach(): void;
275
- ngOnDestroy(): void;
276
- static ɵfac: i0.ɵɵFactoryDeclaration<MatMenuContent, never>;
277
- static ɵdir: i0.ɵɵDirectiveDeclaration<MatMenuContent, "ng-template[matMenuContent]", never, {}, {}, never, never, true, never>;
278
- }
279
-
280
- /** Default `mat-menu` options that can be overridden. */
281
- export declare interface MatMenuDefaultOptions {
282
- /** The x-axis position of the menu. */
283
- xPosition: MenuPositionX;
284
- /** The y-axis position of the menu. */
285
- yPosition: MenuPositionY;
286
- /** Whether the menu should overlap the menu trigger. */
287
- overlapTrigger: boolean;
288
- /** Class to be applied to the menu's backdrop. */
289
- backdropClass: string;
290
- /** Class or list of classes to be applied to the menu's overlay panel. */
291
- overlayPanelClass?: string | string[];
292
- /** Whether the menu has a backdrop. */
293
- hasBackdrop?: boolean;
294
- }
295
-
309
+ declare function MAT_MENU_SCROLL_STRATEGY_FACTORY(overlay: Overlay): () => ScrollStrategy;
296
310
  /**
297
- * Single item inside a `mat-menu`. Provides the menu item styling and accessibility treatment.
311
+ * @docs-private
312
+ * @deprecated No longer used, will be removed.
313
+ * @breaking-change 21.0.0
298
314
  */
299
- export declare class MatMenuItem implements FocusableOption, AfterViewInit, OnDestroy {
300
- private _elementRef;
301
- private _document;
302
- private _focusMonitor;
303
- _parentMenu?: MatMenuPanel<MatMenuItem> | null | undefined;
304
- private _changeDetectorRef;
305
- /** ARIA role for the menu item. */
306
- role: 'menuitem' | 'menuitemradio' | 'menuitemcheckbox';
307
- /** Whether the menu item is disabled. */
308
- disabled: boolean;
309
- /** Whether ripples are disabled on the menu item. */
310
- disableRipple: boolean;
311
- /** Stream that emits when the menu item is hovered. */
312
- readonly _hovered: Subject<MatMenuItem>;
313
- /** Stream that emits when the menu item is focused. */
314
- readonly _focused: Subject<MatMenuItem>;
315
- /** Whether the menu item is highlighted. */
316
- _highlighted: boolean;
317
- /** Whether the menu item acts as a trigger for a sub-menu. */
318
- _triggersSubmenu: boolean;
319
- constructor(...args: unknown[]);
320
- /** Focuses the menu item. */
321
- focus(origin?: FocusOrigin, options?: FocusOptions): void;
322
- ngAfterViewInit(): void;
323
- ngOnDestroy(): void;
324
- /** Used to set the `tabindex`. */
325
- _getTabIndex(): string;
326
- /** Returns the host DOM element. */
327
- _getHostElement(): HTMLElement;
328
- /** Prevents the default element actions if it is disabled. */
329
- _checkDisabled(event: Event): void;
330
- /** Emits to the hover stream. */
331
- _handleMouseEnter(): void;
332
- /** Gets the label to be used when determining whether the option should be focused. */
333
- getLabel(): string;
334
- _setHighlighted(isHighlighted: boolean): void;
335
- _setTriggersSubmenu(triggersSubmenu: boolean): void;
336
- _hasFocus(): boolean;
337
- static ɵfac: i0.ɵɵFactoryDeclaration<MatMenuItem, never>;
338
- static ɵcmp: i0.ɵɵComponentDeclaration<MatMenuItem, "[mat-menu-item]", ["matMenuItem"], { "role": { "alias": "role"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "disableRipple": { "alias": "disableRipple"; "required": false; }; }, {}, never, ["mat-icon, [matMenuItemIcon]", "*"], true, never>;
339
- static ngAcceptInputType_disabled: unknown;
340
- static ngAcceptInputType_disableRipple: unknown;
341
- }
342
-
343
- export declare class MatMenuModule {
344
- static ɵfac: i0.ɵɵFactoryDeclaration<MatMenuModule, never>;
345
- static ɵmod: i0.ɵɵNgModuleDeclaration<MatMenuModule, never, [typeof i1.MatRippleModule, typeof i1.MatCommonModule, typeof i2.OverlayModule, typeof i3.MatMenu, typeof i4.MatMenuItem, typeof i5.MatMenuContent, typeof i6.MatMenuTrigger], [typeof i7.CdkScrollableModule, typeof i3.MatMenu, typeof i1.MatCommonModule, typeof i4.MatMenuItem, typeof i5.MatMenuContent, typeof i6.MatMenuTrigger]>;
346
- static ɵinj: i0.ɵɵInjectorDeclaration<MatMenuModule>;
347
- }
348
-
315
+ declare const MAT_MENU_SCROLL_STRATEGY_FACTORY_PROVIDER: {
316
+ provide: InjectionToken<() => ScrollStrategy>;
317
+ deps: (typeof Overlay)[];
318
+ useFactory: typeof MAT_MENU_SCROLL_STRATEGY_FACTORY;
319
+ };
349
320
  /**
350
- * Interface for a custom menu panel that can be used with `matMenuTriggerFor`.
351
- * @docs-private
321
+ * Default top padding of the menu panel.
322
+ * @deprecated No longer being used. Will be removed.
323
+ * @breaking-change 15.0.0
352
324
  */
353
- export declare interface MatMenuPanel<T = any> {
354
- xPosition: MenuPositionX;
355
- yPosition: MenuPositionY;
356
- overlapTrigger: boolean;
357
- templateRef: TemplateRef<any>;
358
- readonly close: EventEmitter<void | 'click' | 'keydown' | 'tab'>;
359
- parentMenu?: MatMenuPanel | undefined;
360
- direction?: Direction;
361
- focusFirstItem: (origin?: FocusOrigin) => void;
362
- resetActiveItem: () => void;
363
- setPositionClasses?: (x: MenuPositionX, y: MenuPositionY) => void;
364
- /**
365
- * @deprecated No longer used and will be removed.
366
- * @breaking-change 21.0.0
367
- */
368
- setElevation?(depth: number): void;
369
- lazyContent?: MatMenuContent;
370
- backdropClass?: string;
371
- overlayPanelClass?: string | string[];
372
- hasBackdrop?: boolean;
373
- readonly panelId?: string;
374
- /**
375
- * @deprecated To be removed.
376
- * @breaking-change 8.0.0
377
- */
378
- addItem?: (item: T) => void;
379
- /**
380
- * @deprecated To be removed.
381
- * @breaking-change 8.0.0
382
- */
383
- removeItem?: (item: T) => void;
384
- }
385
-
325
+ declare const MENU_PANEL_TOP_PADDING = 8;
386
326
  /** Directive applied to an element that should trigger a `mat-menu`. */
387
- export declare class MatMenuTrigger implements AfterContentInit, OnDestroy {
327
+ declare class MatMenuTrigger implements AfterContentInit, OnDestroy {
388
328
  private _overlay;
389
329
  private _element;
390
330
  private _viewContainerRef;
@@ -518,26 +458,35 @@ export declare class MatMenuTrigger implements AfterContentInit, OnDestroy {
518
458
  static ɵdir: i0.ɵɵDirectiveDeclaration<MatMenuTrigger, "[mat-menu-trigger-for], [matMenuTriggerFor]", ["matMenuTrigger"], { "_deprecatedMatMenuTriggerFor": { "alias": "mat-menu-trigger-for"; "required": false; }; "menu": { "alias": "matMenuTriggerFor"; "required": false; }; "menuData": { "alias": "matMenuTriggerData"; "required": false; }; "restoreFocus": { "alias": "matMenuTriggerRestoreFocus"; "required": false; }; }, { "menuOpened": "menuOpened"; "onMenuOpen": "onMenuOpen"; "menuClosed": "menuClosed"; "onMenuClose": "onMenuClose"; }, never, never, true, never>;
519
459
  }
520
460
 
461
+ declare class MatMenuModule {
462
+ static ɵfac: i0.ɵɵFactoryDeclaration<MatMenuModule, never>;
463
+ static ɵmod: i0.ɵɵNgModuleDeclaration<MatMenuModule, never, [typeof i1.MatRippleModule, typeof i1.MatCommonModule, typeof i2.OverlayModule, typeof MatMenu, typeof MatMenuItem, typeof MatMenuContent, typeof MatMenuTrigger], [typeof i2$1.CdkScrollableModule, typeof MatMenu, typeof i1.MatCommonModule, typeof MatMenuItem, typeof MatMenuContent, typeof MatMenuTrigger]>;
464
+ static ɵinj: i0.ɵɵInjectorDeclaration<MatMenuModule>;
465
+ }
466
+
521
467
  /**
522
- * Default top padding of the menu panel.
523
- * @deprecated No longer being used. Will be removed.
524
- * @breaking-change 15.0.0
468
+ * Animations used by the mat-menu component.
469
+ * Animation duration and timing values are based on:
470
+ * https://material.io/guidelines/components/menus.html#menus-usage
471
+ * @docs-private
472
+ * @deprecated No longer used, will be removed.
473
+ * @breaking-change 21.0.0
525
474
  */
526
- export declare const MENU_PANEL_TOP_PADDING = 8;
527
-
528
- /** Reason why the menu was closed. */
529
- export declare type MenuCloseReason = void | 'click' | 'keydown' | 'tab';
530
-
531
-
532
- export declare type MenuPositionX = 'before' | 'after';
533
-
534
- export declare type MenuPositionY = 'above' | 'below';
535
-
475
+ declare const matMenuAnimations: {
476
+ readonly transformMenu: any;
477
+ readonly fadeInItems: any;
478
+ };
479
+ /**
480
+ * @deprecated
481
+ * @breaking-change 8.0.0
482
+ * @docs-private
483
+ */
484
+ declare const fadeInItems: any;
536
485
  /**
537
486
  * @deprecated
538
487
  * @breaking-change 8.0.0
539
488
  * @docs-private
540
489
  */
541
- export declare const transformMenu: any;
490
+ declare const transformMenu: any;
542
491
 
543
- export { }
492
+ export { MAT_MENU_CONTENT, MAT_MENU_DEFAULT_OPTIONS, MAT_MENU_PANEL, MAT_MENU_SCROLL_STRATEGY, MAT_MENU_SCROLL_STRATEGY_FACTORY_PROVIDER, MENU_PANEL_TOP_PADDING, MatMenu, MatMenuContent, type MatMenuDefaultOptions, MatMenuItem, MatMenuModule, type MatMenuPanel, MatMenuTrigger, type MenuCloseReason, type MenuPositionX, type MenuPositionY, fadeInItems, matMenuAnimations, transformMenu };
@@ -1,11 +1,20 @@
1
- import { BaseHarnessFilters } from '@angular/cdk/testing';
2
- import { ComponentHarnessConstructor } from '@angular/cdk/testing';
3
- import { ContentContainerComponentHarness } from '@angular/cdk/testing';
4
- import { HarnessLoader } from '@angular/cdk/testing';
5
- import { HarnessPredicate } from '@angular/cdk/testing';
1
+ import { BaseHarnessFilters, ContentContainerComponentHarness, ComponentHarnessConstructor, HarnessPredicate, HarnessLoader } from '@angular/cdk/testing';
2
+
3
+ /** A set of criteria that can be used to filter a list of `MatMenuHarness` instances. */
4
+ interface MenuHarnessFilters extends BaseHarnessFilters {
5
+ /** Only find instances whose trigger text matches the given value. */
6
+ triggerText?: string | RegExp;
7
+ }
8
+ /** A set of criteria that can be used to filter a list of `MatMenuItemHarness` instances. */
9
+ interface MenuItemHarnessFilters extends BaseHarnessFilters {
10
+ /** Only find instances whose text matches the given value. */
11
+ text?: string | RegExp;
12
+ /** Only find instances that have a sub-menu. */
13
+ hasSubmenu?: boolean;
14
+ }
6
15
 
7
16
  /** Harness for interacting with a mat-menu in tests. */
8
- export declare class MatMenuHarness extends ContentContainerComponentHarness<string> {
17
+ declare class MatMenuHarness extends ContentContainerComponentHarness<string> {
9
18
  private _documentRootLocator;
10
19
  /** The selector for the host element of a `MatMenu` instance. */
11
20
  static hostSelector: string;
@@ -51,8 +60,7 @@ export declare class MatMenuHarness extends ContentContainerComponentHarness<str
51
60
  /** Gets the id of the menu panel associated with this menu. */
52
61
  private _getPanelId;
53
62
  }
54
-
55
- export declare class MatMenuItemHarness extends ContentContainerComponentHarness<string> {
63
+ declare class MatMenuItemHarness extends ContentContainerComponentHarness<string> {
56
64
  /** The selector for the host element of a `MatMenuItem` instance. */
57
65
  static hostSelector: string;
58
66
  /**
@@ -79,18 +87,4 @@ export declare class MatMenuItemHarness extends ContentContainerComponentHarness
79
87
  getSubmenu(): Promise<MatMenuHarness | null>;
80
88
  }
81
89
 
82
- /** A set of criteria that can be used to filter a list of `MatMenuHarness` instances. */
83
- export declare interface MenuHarnessFilters extends BaseHarnessFilters {
84
- /** Only find instances whose trigger text matches the given value. */
85
- triggerText?: string | RegExp;
86
- }
87
-
88
- /** A set of criteria that can be used to filter a list of `MatMenuItemHarness` instances. */
89
- export declare interface MenuItemHarnessFilters extends BaseHarnessFilters {
90
- /** Only find instances whose text matches the given value. */
91
- text?: string | RegExp;
92
- /** Only find instances that have a sub-menu. */
93
- hasSubmenu?: boolean;
94
- }
95
-
96
- export { }
90
+ export { MatMenuHarness, MatMenuItemHarness, type MenuHarnessFilters, type MenuItemHarnessFilters };
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@angular/material",
3
- "version": "19.2.2",
3
+ "version": "19.2.3",
4
4
  "description": "Angular Material",
5
5
  "repository": {
6
6
  "type": "git",
@@ -353,7 +353,7 @@
353
353
  }
354
354
  },
355
355
  "peerDependencies": {
356
- "@angular/cdk": "19.2.2",
356
+ "@angular/cdk": "19.2.3",
357
357
  "@angular/core": "^19.0.0 || ^20.0.0",
358
358
  "@angular/common": "^19.0.0 || ^20.0.0",
359
359
  "@angular/forms": "^19.0.0 || ^20.0.0",