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

package/form-field/index.d.ts

@@ -150,10 +150,10 @@ export declare class MatFormField implements FloatingLabelParent, AfterContentIn
     private _hideRequiredMarker;
     /**
      * Theme color of the form field. 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/form-field/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 label should always float or float as the user types. */
@@ -376,10 +376,10 @@ export declare interface MatFormFieldDefaultOptions {
     appearance?: MatFormFieldAppearance;
     /**
      * Default theme color of the form field. This API is supported in M2 themes only, it has no
-     * effect in M3 themes.
+     * effect in M3 themes. For color customization in M3, see https://material.angular.io/components/form-field/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 required marker should be hidden by default. */

package/icon/index.d.ts

@@ -130,10 +130,10 @@ export declare class MatIcon implements OnInit, AfterViewChecked, OnDestroy {
     private _defaultColor;
     /**
      * Theme color of the icon. 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/icon/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 color(): string | null | undefined;
     set color(value: string | null | undefined);
@@ -215,10 +215,10 @@ export declare class MatIcon implements OnInit, AfterViewChecked, OnDestroy {
 export declare interface MatIconDefaultOptions {
     /**
      * Theme color of the icon. 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/icon/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;
     /** Font set that the icon is a part of. */

package/list/index.d.ts

@@ -133,7 +133,7 @@ declare abstract class MatListBase {
 
 /** Object that can be used to configure the default options for the list module. */
 export declare interface MatListConfig {
-    /** Wheter icon indicators should be hidden for single-selection. */
+    /** Whether icon indicators should be hidden for single-selection. */
     hideSingleSelectionIndicator?: boolean;
 }
 
@@ -356,10 +356,11 @@ export declare class MatListOption extends MatListItemBase implements ListOption
     set checkboxPosition(value: MatListOptionTogglePosition);
     /**
      * Theme color of the list option. This sets the color of the checkbox/radio.
-     * This API is supported in M2 themes only, it has no effect in M3 themes.
+     * This API is supported in M2 themes only, it has no effect in M3 themes. For color customization
+     * in M3, see https://material.angular.io/components/list/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 color(): ThemePalette;
     set color(newValue: ThemePalette);
@@ -458,10 +459,10 @@ export declare class MatSelectionList extends MatListBase implements SelectionLi
     /**
      * Theme color of the selection list. This sets the checkbox color for all
      * list options. This API is supported in M2 themes only, it has no effect in
-     * M3 themes.
+     * M3 themes. For color customization in M3, see https://material.angular.io/components/list/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/menu/index.d.ts

@@ -395,7 +395,6 @@ export declare class MatMenuTrigger implements AfterContentInit, OnDestroy {
     private _ngZone;
     private _scrollStrategy;
     private _changeDetectorRef;
-    private _cleanupTouchstart;
     private _portal;
     private _overlayRef;
     private _menuOpen;
@@ -413,6 +412,11 @@ export declare class MatMenuTrigger implements AfterContentInit, OnDestroy {
      * Used to offset sub-menus to compensate for the padding.
      */
     private _parentInnerPadding;
+    /**
+     * Handles touch start events on the trigger.
+     * Needs to be an arrow function so we can easily use addEventListener and removeEventListener.
+     */
+    private _handleTouchStart;
     _openedBy: Exclude<FocusOrigin, 'program' | null> | undefined;
     /**
      * @deprecated

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@angular/material",
-  "version": "19.1.0-next.3",
+  "version": "19.1.0-rc.0",
   "description": "Angular Material",
   "repository": {
     "type": "git",
@@ -354,7 +354,7 @@
   },
   "peerDependencies": {
     "@angular/animations": "^19.0.0-0 || ^19.1.0-0 || ^19.2.0-0 || ^19.3.0-0 || ^20.0.0-0",
-    "@angular/cdk": "19.1.0-next.3",
+    "@angular/cdk": "19.1.0-rc.0",
     "@angular/core": "^19.0.0-0 || ^19.1.0-0 || ^19.2.0-0 || ^19.3.0-0 || ^20.0.0-0",
     "@angular/common": "^19.0.0-0 || ^19.1.0-0 || ^19.2.0-0 || ^19.3.0-0 || ^20.0.0-0",
     "@angular/forms": "^19.0.0-0 || ^19.1.0-0 || ^19.2.0-0 || ^19.3.0-0 || ^20.0.0-0",

package/paginator/index.d.ts

@@ -1,4 +1,3 @@
-import { ChangeDetectorRef } from '@angular/core';
 import { EventEmitter } from '@angular/core';
 import * as i0 from '@angular/core';
 import * as i1 from '@angular/material/button';
@@ -53,10 +52,10 @@ export declare class MatPaginator implements OnInit, OnDestroy {
     private _initializedStream;
     /**
      * Theme color of the underlying form controls. 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/paginator/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;
     /** The zero-based page index of the displayed list of items. Defaulted to 0. */
@@ -89,7 +88,8 @@ export declare class MatPaginator implements OnInit, OnDestroy {
     _displayedPageSizeOptions: number[];
     /** Emits when the paginator is initialized. */
     initialized: Observable<void>;
-    constructor(_intl: MatPaginatorIntl, _changeDetectorRef: ChangeDetectorRef, defaults?: MatPaginatorDefaultOptions);
+    /** Inserted by Angular inject() migration for backwards compatibility */
+    constructor(...args: unknown[]);
     ngOnInit(): void;
     ngOnDestroy(): void;
     /** Advances to the next page if it exists. */
@@ -134,7 +134,7 @@ export declare class MatPaginator implements OnInit, OnDestroy {
      * @param isDisabled Whether the button is disabled.
      */
     protected _buttonClicked(targetIndex: number, isDisabled: boolean): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<MatPaginator, [null, null, { optional: true; }]>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatPaginator, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<MatPaginator, "mat-paginator", ["matPaginator"], { "color": { "alias": "color"; "required": false; }; "pageIndex": { "alias": "pageIndex"; "required": false; }; "length": { "alias": "length"; "required": false; }; "pageSize": { "alias": "pageSize"; "required": false; }; "pageSizeOptions": { "alias": "pageSizeOptions"; "required": false; }; "hidePageSize": { "alias": "hidePageSize"; "required": false; }; "showFirstLastButtons": { "alias": "showFirstLastButtons"; "required": false; }; "selectConfig": { "alias": "selectConfig"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; }, { "page": "page"; }, never, never, true, never>;
     static ngAcceptInputType_pageIndex: unknown;
     static ngAcceptInputType_length: unknown;

package/progress-bar/index.d.ts

@@ -45,10 +45,10 @@ export declare class MatProgressBar implements AfterViewInit, OnDestroy {
     _isNoopAnimation: boolean;
     /**
      * Theme color of the progress bar. 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/progress-bar/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 color(): string | null | undefined;
     set color(value: string | null | undefined);
@@ -98,10 +98,10 @@ export declare class MatProgressBar implements AfterViewInit, OnDestroy {
 export declare interface MatProgressBarDefaultOptions {
     /**
      * Default theme color of the progress bar. 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/progress-bar/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;
     /** Default mode of the progress bar. */

package/progress-spinner/index.d.ts

@@ -27,10 +27,10 @@ export declare class MatProgressSpinner {
     _noopAnimations: boolean;
     /**
      * Theme color of the progress spinner. 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/progress-spinner/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 color(): string | null | undefined;
     set color(value: string | null | undefined);
@@ -80,10 +80,10 @@ export declare class MatProgressSpinner {
 export declare interface MatProgressSpinnerDefaultOptions {
     /**
      * Default theme color of the progress spinner. 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/progress-spinner/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;
     /** Diameter of the spinner. */

package/radio/index.d.ts

@@ -86,10 +86,10 @@ export declare class MatRadioButton implements OnInit, AfterViewInit, DoCheck, O
     set required(value: boolean);
     /**
      * Theme color of the radio button. 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/radio/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 color(): ThemePalette;
     set color(newValue: ThemePalette);
@@ -179,10 +179,10 @@ export declare class MatRadioChange {
 export declare interface MatRadioDefaultOptions {
     /**
      * Theme color of the radio button. 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/radio/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 disabled radio buttons should be interactive. */
@@ -227,10 +227,10 @@ export declare class MatRadioGroup implements AfterContentInit, OnDestroy, Contr
     _radios: QueryList<MatRadioButton>;
     /**
      * Theme color of the radio buttons in the group. 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/radio/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;
     /** Name of the radio button group. All radio buttons inside this group will use this name. */

package/schematics/ng-add/index.js

@@ -19,7 +19,7 @@ const package_config_1 = require("./package-config");
  * Note that the fallback version range does not use caret, but tilde because that is
  * the default for Angular framework dependencies in CLI projects.
  */
-const fallbackMaterialVersionRange = `~19.1.0-next.3`;
+const fallbackMaterialVersionRange = `~19.1.0-rc.0`;
 /**
  * Schematic factory entry-point for the `ng-add` schematic. The ng-add schematic will be
  * automatically executed if developers run `ng add @angular/material`.

package/schematics/ng-add/index.mjs

@@ -19,7 +19,7 @@ const package_config_1 = require("./package-config");
  * Note that the fallback version range does not use caret, but tilde because that is
  * the default for Angular framework dependencies in CLI projects.
  */
-const fallbackMaterialVersionRange = `~19.1.0-next.3`;
+const fallbackMaterialVersionRange = `~19.1.0-rc.0`;
 /**
  * Schematic factory entry-point for the `ng-add` schematic. The ng-add schematic will be
  * automatically executed if developers run `ng add @angular/material`.

package/select/index.d.ts

@@ -483,7 +483,7 @@ export declare interface MatSelectConfig {
     typeaheadDebounceInterval?: number;
     /** Class or list of classes to be applied to the menu's overlay panel. */
     overlayPanelClass?: string | string[];
-    /** Wheter icon indicators should be hidden for single-selection. */
+    /** Whether icon indicators should be hidden for single-selection. */
     hideSingleSelectionIndicator?: boolean;
     /**
      * Width of the panel. If set to `auto`, the panel will match the trigger width.

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,7 +58,7 @@ 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;
@@ -72,8 +70,7 @@ export declare class MatDrawer implements AfterViewInit, AfterContentChecked, On
     _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. */
@@ -110,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. */
@@ -163,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.
@@ -189,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;
@@ -199,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>;
 }
@@ -206,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;
@@ -223,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. */

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

@@ -560,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. */
@@ -610,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
@@ -835,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);
@@ -847,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/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

@@ -80,8 +80,6 @@ export declare class MatTooltip implements OnDestroy, AfterViewInit {
     private _focusMonitor;
     protected _dir: Directionality;
     private _injector;
-    private _document;
-    private _renderer;
     private _defaultOptions;
     _overlayRef: OverlayRef | null;
     _tooltipInstance: TooltipComponent | null;
@@ -98,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);
@@ -144,12 +143,16 @@ export declare class MatTooltip implements OnDestroy, AfterViewInit {
     set tooltipClass(value: string | string[] | Set<string> | {
         [key: string]: any;
     });
-    /** Cleanup functions for manually-bound events. */
-    private readonly _eventCleanups;
+    /** Manually-bound passive event listeners. */
+    private readonly _passiveListeners;
+    /** Reference to the current document. */
+    private _document;
     /** Timer started at the last `touchstart` event. */
     private _touchstartTimeout;
     /** Emits when the component is destroyed. */
     private readonly _destroyed;
+    /** Whether ngOnDestroyed has been called. */
+    private _isDestroyed;
     constructor(...args: unknown[]);
     ngAfterViewInit(): void;
     /**
@@ -202,6 +205,7 @@ export declare class MatTooltip implements OnDestroy, AfterViewInit {
     /** Binds the pointer events to the tooltip trigger. */
     private _setupPointerEnterEventsIfNeeded;
     private _setupPointerExitEventsIfNeeded;
+    private _addListeners;
     private _platformSupportsMouseEvents;
     /** Listener for the `wheel` event on the element. */
     private _wheelListener;