@angular/material 19.1.0-next.2 → 19.1.0-rc.0

package/sidenav/index.d.ts

@@ -1,7 +1,5 @@
-import { AfterContentChecked } from '@angular/core';
 import { AfterContentInit } from '@angular/core';
 import { AfterViewInit } from '@angular/core';
-import { AnimationEvent as AnimationEvent_2 } from '@angular/animations';
 import { AnimationTriggerMetadata } from '@angular/animations';
 import { BooleanInput } from '@angular/cdk/coercion';
 import { CdkScrollable } from '@angular/cdk/scrolling';
@@ -60,19 +58,19 @@ export declare function MAT_DRAWER_DEFAULT_AUTOSIZE_FACTORY(): boolean;
 /**
  * This component corresponds to a drawer that can be opened on the drawer container.
  */
-export declare class MatDrawer implements AfterViewInit, AfterContentChecked, OnDestroy {
+export declare class MatDrawer implements AfterViewInit, OnDestroy {
     private _elementRef;
     private _focusTrapFactory;
     private _focusMonitor;
     private _platform;
     private _ngZone;
+    private _renderer;
     private readonly _interactivityChecker;
     private _doc;
     _container?: MatDrawerContainer | null | undefined;
     private _focusTrap;
     private _elementFocusedBeforeDrawerWasOpened;
-    /** Whether the drawer is initialized. Used for disabling the initial animation. */
-    private _enableAnimations;
+    private _eventCleanups;
     /** Whether the view of the component has been attached. */
     private _isAttached;
     /** Anchor node used to restore the drawer to its initial position. */
@@ -109,11 +107,9 @@ export declare class MatDrawer implements AfterViewInit, AfterContentChecked, On
     /** How the sidenav was opened (keypress, mouse click etc.) */
     private _openedVia;
     /** Emits whenever the drawer has started animating. */
-    readonly _animationStarted: Subject<AnimationEvent_2>;
+    readonly _animationStarted: Subject<unknown>;
     /** Emits whenever the drawer is done animating. */
-    readonly _animationEnd: Subject<AnimationEvent_2>;
-    /** Current state of the sidenav animation. */
-    _animationState: 'open-instant' | 'open' | 'void';
+    readonly _animationEnd: Subject<unknown>;
     /** Event emitted when the drawer open state is changed. */
     readonly openedChange: EventEmitter<boolean>;
     /** Event emitted when the drawer has been opened. */
@@ -162,7 +158,6 @@ export declare class MatDrawer implements AfterViewInit, AfterContentChecked, On
     /** Whether focus is currently within the drawer. */
     private _isFocusWithinDrawer;
     ngAfterViewInit(): void;
-    ngAfterContentChecked(): void;
     ngOnDestroy(): void;
     /**
      * Open the drawer.
@@ -188,6 +183,8 @@ export declare class MatDrawer implements AfterViewInit, AfterContentChecked, On
      * @param focusOrigin Origin to use when restoring focus.
      */
     private _setOpen;
+    /** Toggles whether the drawer is currently animating. */
+    private _setIsAnimating;
     _getWidth(): number;
     /** Updates the enabled state of the focus trap. */
     private _updateFocusTrapState;
@@ -198,6 +195,8 @@ export declare class MatDrawer implements AfterViewInit, AfterContentChecked, On
      * started off as `end` and was changed to `start`.
      */
     private _updatePositionInParent;
+    /** Event handler for animation events. */
+    private _handleTransitionEvent;
     static ɵfac: i0.ɵɵFactoryDeclaration<MatDrawer, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<MatDrawer, "mat-drawer", ["matDrawer"], { "position": { "alias": "position"; "required": false; }; "mode": { "alias": "mode"; "required": false; }; "disableClose": { "alias": "disableClose"; "required": false; }; "autoFocus": { "alias": "autoFocus"; "required": false; }; "opened": { "alias": "opened"; "required": false; }; }, { "openedChange": "openedChange"; "_openedStream": "opened"; "openedStart": "openedStart"; "_closedStream": "closed"; "closedStart": "closedStart"; "onPositionChanged": "positionChanged"; }, never, ["*"], true, never>;
 }
@@ -205,6 +204,8 @@ export declare class MatDrawer implements AfterViewInit, AfterContentChecked, On
 /**
  * Animations used by the Material drawers.
  * @docs-private
+ * @deprecated No longer used, will be removed.
+ * @breaking-change 21.0.0
  */
 export declare const matDrawerAnimations: {
     readonly transformDrawer: AnimationTriggerMetadata;
@@ -222,6 +223,7 @@ export declare class MatDrawerContainer implements AfterContentInit, DoCheck, On
     private _ngZone;
     private _changeDetectorRef;
     private _animationMode;
+    _transitionsEnabled: boolean;
     /** All drawers in the container. Includes drawers from inside nested containers. */
     _allDrawers: QueryList<MatDrawer>;
     /** Drawers that belong to this container. */

package/slide-toggle/index.d.ts

@@ -91,10 +91,10 @@ export declare class MatSlideToggle implements OnDestroy, AfterContentInit, OnCh
     required: boolean;
     /**
      * Theme color of the slide toggle. This API is supported in M2 themes only,
-     * it has no effect in M3 themes.
+     * it has no effect in M3 themes. For color customization in M3, see https://material.angular.io/components/slide-toggle/styling.
      *
      * For information on applying color variants in M3, see
-     * https://material.angular.io/guide/theming#using-component-color-variants.
+     * https://material.angular.io/guide/material-2-theming#optional-add-backwards-compatibility-styles-for-color-variants
      */
     color: string | undefined;
     /** Whether the slide toggle is disabled. */
@@ -175,10 +175,10 @@ export declare interface MatSlideToggleDefaultOptions {
     disableToggleValue?: boolean;
     /**
      * Default theme color of the slide toggle. This API is supported in M2 themes only,
-     * it has no effect in M3 themes.
+     * it has no effect in M3 themes. For color customization in M3, see https://material.angular.io/components/slide-toggle/styling.
      *
      * For information on applying color variants in M3, see
-     * https://material.angular.io/guide/theming#using-component-color-variants.
+     * https://material.angular.io/guide/material-2-theming#optional-add-backwards-compatibility-styles-for-color-variants
      */
     color?: ThemePalette;
     /** Whether to hide the icon inside the slide toggle. */

package/slider/index.d.ts

@@ -82,10 +82,10 @@ export declare class MatSlider implements AfterViewInit, OnDestroy, _MatSlider {
     private _min;
     /**
      * Theme color of the slider. This API is supported in M2 themes only, it
-     * has no effect in M3 themes.
+     * has no effect in M3 themes. For color customization in M3, see https://material.angular.io/components/slider/styling.
      *
      * For information on applying color variants in M3, see
-     * https://material.angular.io/guide/theming#using-component-color-variants.
+     * https://material.angular.io/guide/material-2-theming#optional-add-backwards-compatibility-styles-for-color-variants
      */
     color: ThemePalette;
     /** Whether ripples are disabled in the slider. */
@@ -374,6 +374,8 @@ export declare class MatSliderThumb implements _MatSliderThumb, OnDestroy, Contr
     readonly _elementRef: ElementRef<HTMLInputElement>;
     readonly _cdr: ChangeDetectorRef;
     protected _slider: _MatSlider;
+    private _platform;
+    private _listenerCleanups;
     get value(): number;
     set value(value: number);
     /**
@@ -461,7 +463,6 @@ export declare class MatSliderThumb implements _MatSliderThumb, OnDestroy, Contr
      * See https://github.com/angular/angular/issues/14988.
      */
     protected _isControlInitialized: boolean;
-    private _platform;
     constructor(...args: unknown[]);
     ngOnDestroy(): void;
     /** @docs-private */
@@ -601,6 +602,8 @@ export declare class MatSliderVisualThumb implements _MatSliderVisualThumb, Afte
     readonly _cdr: ChangeDetectorRef;
     private readonly _ngZone;
     private _slider;
+    private _renderer;
+    private _listenerCleanups;
     /** Whether the slider displays a numeric value label upon pressing the thumb. */
     discrete: boolean;
     /** Indicates which slider thumb this input corresponds to. */

package/stepper/index.d.ts

@@ -86,10 +86,10 @@ export declare class MatStep extends CdkStep implements ErrorStateMatcher, After
     stepLabel: MatStepLabel;
     /**
      * Theme color for the particular step. This API is supported in M2 themes
-     * only, it has no effect in M3 themes.
+     * only, it has no effect in M3 themes. For color customization in M3, see https://material.angular.io/components/stepper/styling.
      *
      * For information on applying color variants in M3, see
-     * https://material.angular.io/guide/theming#using-component-color-variants.
+     * https://material.angular.io/guide/material-2-theming#optional-add-backwards-compatibility-styles-for-color-variants
      */
     color: ThemePalette;
     /** Content that will be rendered lazily. */
@@ -140,10 +140,10 @@ export declare class MatStepHeader extends CdkStepHeader implements AfterViewIni
     disableRipple: boolean;
     /**
      * Theme color of the step header. This API is supported in M2 themes only, it
-     * has no effect in M3 themes.
+     * has no effect in M3 themes. For color customization in M3, see https://material.angular.io/components/stepper/styling.
      *
      * For information on applying color variants in M3, see
-     * https://material.angular.io/guide/theming#using-component-color-variants.
+     * https://material.angular.io/guide/material-2-theming#optional-add-backwards-compatibility-styles-for-color-variants
      */
     color: ThemePalette;
     constructor(...args: unknown[]);
@@ -184,10 +184,10 @@ export declare class MatStepper extends CdkStepper implements AfterContentInit {
     disableRipple: boolean;
     /**
      * Theme color for all of the steps in stepper. This API is supported in M2
-     * themes only, it has no effect in M3 themes.
+     * themes only, it has no effect in M3 themes. For color customization in M3, see https://material.angular.io/components/stepper/styling.
      *
      * For information on applying color variants in M3, see
-     * https://material.angular.io/guide/theming#using-component-color-variants.
+     * https://material.angular.io/guide/material-2-theming#optional-add-backwards-compatibility-styles-for-color-variants
      */
     color: ThemePalette;
     /**

package/tabs/index.d.ts

@@ -181,7 +181,11 @@ export declare abstract class MatPaginatedTabHeader implements AfterContentCheck
     private _dir;
     private _ngZone;
     private _platform;
+    private _sharedResizeObserver;
+    private _injector;
+    private _renderer;
     _animationMode: "NoopAnimations" | "BrowserAnimations" | null;
+    private _eventCleanups;
     abstract _items: QueryList<MatPaginatedTabHeaderItem>;
     abstract _inkBar: {
         hide: () => void;
@@ -230,8 +234,6 @@ export declare abstract class MatPaginatedTabHeader implements AfterContentCheck
     readonly selectFocusedIndex: EventEmitter<number>;
     /** Event emitted when a label is focused. */
     readonly indexFocused: EventEmitter<number>;
-    private _sharedResizeObserver;
-    private _injector;
     constructor(...args: unknown[]);
     /** Called when the user has selected an item via the keyboard. */
     protected abstract _itemSelected(event: KeyboardEvent): void;
@@ -558,10 +560,10 @@ export declare class MatTabGroup implements AfterContentInit, AfterContentChecke
     private _tabLabelSubscription;
     /**
      * Theme color of the tab group. This API is supported in M2 themes only, it
-     * has no effect in M3 themes.
+     * has no effect in M3 themes. For color customization in M3, see https://material.angular.io/components/tabs/styling.
      *
      * For information on applying color variants in M3, see
-     * https://material.angular.io/guide/theming#using-component-color-variants.
+     * https://material.angular.io/guide/material-2-theming#optional-add-backwards-compatibility-styles-for-color-variants
      */
     color: ThemePalette;
     /** Whether the ink bar should fit its width to the size of the tab label content. */
@@ -608,10 +610,10 @@ export declare class MatTabGroup implements AfterContentInit, AfterContentChecke
     preserveContent: boolean;
     /**
      * Theme color of the background of the tab group. This API is supported in M2 themes only, it
-     * has no effect in M3 themes.
+     * has no effect in M3 themes. For color customization in M3, see https://material.angular.io/components/tabs/styling.
      *
      * For information on applying color variants in M3, see
-     * https://material.angular.io/guide/theming#using-component-color-variants.
+     * https://material.angular.io/guide/material-2-theming#optional-add-backwards-compatibility-styles-for-color-variants
      *
      * @deprecated The background color should be customized through Sass theming APIs.
      * @breaking-change 20.0.0 Remove this input
@@ -833,10 +835,10 @@ export declare class MatTabNav extends MatPaginatedTabHeader implements AfterCon
     _items: QueryList<MatTabLink>;
     /**
      * Theme color of the background of the tab nav. This API is supported in M2 themes only, it
-     * has no effect in M3 themes.
+     * has no effect in M3 themes. For color customization in M3, see https://material.angular.io/components/tabs/styling.
      *
      * For information on applying color variants in M3, see
-     * https://material.angular.io/guide/theming#using-component-color-variants.
+     * https://material.angular.io/guide/material-2-theming#optional-add-backwards-compatibility-styles-for-color-variants
      */
     get backgroundColor(): ThemePalette;
     set backgroundColor(value: ThemePalette);
@@ -845,10 +847,10 @@ export declare class MatTabNav extends MatPaginatedTabHeader implements AfterCon
     disableRipple: boolean;
     /**
      * Theme color of the nav bar. This API is supported in M2 themes only, it has
-     * no effect in M3 themes.
+     * no effect in M3 themes. For color customization in M3, see https://material.angular.io/components/tabs/styling.
      *
      * For information on applying color variants in M3, see
-     * https://material.angular.io/guide/theming#using-component-color-variants.
+     * https://material.angular.io/guide/material-2-theming#optional-add-backwards-compatibility-styles-for-color-variants
      */
     color: ThemePalette;
     /**

package/timepicker/index.d.ts

@@ -152,6 +152,7 @@ export declare class MatTimepickerInput<D> implements ControlValueAccessor, Vali
     private _onChange;
     private _onTouched;
     private _validatorOnChange;
+    private _cleanupClick;
     private _accessorDisabled;
     private _localeSubscription;
     private _timepickerSubscription;

package/toolbar/index.d.ts

@@ -18,10 +18,10 @@ export declare class MatToolbar implements AfterViewInit {
     private _document;
     /**
      * Theme color of the toolbar. This API is supported in M2 themes only, it has
-     * no effect in M3 themes.
+     * no effect in M3 themes. For color customization in M3, see https://material.angular.io/components/toolbar/styling.
      *
      * For information on applying color variants in M3, see
-     * https://material.angular.io/guide/theming#using-component-color-variants.
+     * https://material.angular.io/guide/material-2-theming#optional-add-backwards-compatibility-styles-for-color-variants
      */
     color?: string | null;
     /** Reference to all toolbar row elements that have been projected. */

package/tooltip/index.d.ts

@@ -96,6 +96,7 @@ export declare class MatTooltip implements OnDestroy, AfterViewInit {
     private _currentPosition;
     private readonly _cssClassPrefix;
     private _ariaDescriptionPending;
+    private _dirSubscribed;
     /** Allows the user to define the position of the tooltip relative to the parent element */
     get position(): TooltipPosition;
     set position(value: TooltipPosition);
@@ -150,6 +151,8 @@ export declare class MatTooltip implements OnDestroy, AfterViewInit {
     private _touchstartTimeout;
     /** Emits when the component is destroyed. */
     private readonly _destroyed;
+    /** Whether ngOnDestroyed has been called. */
+    private _isDestroyed;
     constructor(...args: unknown[]);
     ngAfterViewInit(): void;
     /**