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

package/LICENSE

@@ -1,6 +1,6 @@
 The MIT License
 
-Copyright (c) 2024 Google LLC.
+Copyright (c) 2025 Google LLC.
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/autocomplete/index.d.ts

@@ -212,7 +212,7 @@ export declare interface MatAutocompleteDefaultOptions {
     requireSelection?: boolean;
     /** Class or list of classes to be applied to the autocomplete'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;
 }
 

package/badge/index.d.ts

@@ -24,10 +24,10 @@ export declare class MatBadge implements OnInit, OnDestroy {
     private _idGenerator;
     /**
      * Theme color of the badge. 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/badge/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(value: ThemePalette);

package/button/index.d.ts

@@ -107,10 +107,10 @@ declare class MatButtonBase implements AfterViewInit, OnDestroy {
     protected _isFab: boolean;
     /**
      * Theme color of the button. 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/button/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;
     /** Whether the ripple effect is disabled or not. */
@@ -203,10 +203,10 @@ export declare class MatFabButton extends MatButtonBase {
 export declare interface MatFabDefaultOptions {
     /**
      * Default theme color of the button. 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/button/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/checkbox/index.d.ts

@@ -118,10 +118,10 @@ export declare class MatCheckbox implements AfterViewInit, OnChanges, ControlVal
     tabIndex: number;
     /**
      * Theme color of the checkbox. 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/checkbox/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 checkbox should remain interactive when it is disabled. */
@@ -224,10 +224,10 @@ export declare type MatCheckboxClickAction = 'noop' | 'check' | 'check-indetermi
 export declare interface MatCheckboxDefaultOptions {
     /**
      * Default theme color of the checkbox. 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/checkbox/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 checkbox click action for checkboxes. */

package/chips/index.d.ts

@@ -181,10 +181,10 @@ export declare class MatChip implements OnInit, AfterViewInit, AfterContentInit,
     protected _value: any;
     /**
      * Theme color of the chip. 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/chips/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;
     /**
@@ -849,7 +849,7 @@ export declare class MatChipRow extends MatChip implements AfterViewInit {
 export declare interface MatChipsDefaultOptions {
     /** The list of key codes that will trigger a chipEnd event. */
     separatorKeyCodes: readonly number[] | ReadonlySet<number>;
-    /** Wheter icon indicators should be hidden for single-selection. */
+    /** Whether icon indicators should be hidden for single-selection. */
     hideSingleSelectionIndicator?: boolean;
 }
 

package/core/index.d.ts

@@ -794,7 +794,6 @@ export declare class MatRippleLoader implements OnDestroy {
     private _platform;
     private _ngZone;
     private _injector;
-    private _eventCleanups;
     private _hosts;
     constructor();
     ngOnDestroy(): void;

package/datepicker/index.d.ts

@@ -35,7 +35,6 @@ import { OnInit } from '@angular/core';
 import { Overlay } from '@angular/cdk/overlay';
 import { Portal } from '@angular/cdk/portal';
 import { ScrollStrategy } from '@angular/cdk/overlay';
-import { Signal } from '@angular/core';
 import { SimpleChanges } from '@angular/core';
 import { Subject } from 'rxjs';
 import { TemplatePortal } from '@angular/cdk/portal';
@@ -159,8 +158,6 @@ declare namespace i15 {
 
 declare namespace i16 {
     export {
-        MatDateRangeInputParent,
-        MAT_DATE_RANGE_INPUT_PARENT,
         MatStartDate,
         MatEndDate
     }
@@ -221,12 +218,6 @@ declare namespace i9 {
 
 declare function isSameMultiYearView<D>(dateAdapter: DateAdapter<D>, date1: D, date2: D, minDate: D | null, maxDate: D | null): boolean;
 
-/**
- * Used to provide the date range input wrapper component
- * to the parts without circular dependencies.
- */
-declare const MAT_DATE_RANGE_INPUT_PARENT: InjectionToken<MatDateRangeInputParent<unknown>>;
-
 /** Injection token used to customize the date range selection behavior. */
 export declare const MAT_DATE_RANGE_SELECTION_STRATEGY: InjectionToken<MatDateRangeSelectionStrategy<any>>;
 
@@ -395,7 +386,6 @@ export declare class MatCalendarBody<D = any> implements OnChanges, OnDestroy, A
     private _ngZone;
     private _platform;
     private _intl;
-    private _eventCleanups;
     /**
      * Used to skip the next focus event when rendering the preview range.
      * We need a flag like this, because some browsers fire focus events asynchronously.
@@ -705,10 +695,10 @@ declare abstract class MatDatepickerBase<C extends MatDatepickerControl<D>, S, D
     startView: 'month' | 'year' | 'multi-year';
     /**
      * Theme color of the datepicker's calendar. 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/datepicker/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(value: ThemePalette);
@@ -865,10 +855,10 @@ export declare class MatDatepickerContent<S, D = ExtractDateTypeFromSelection<S>
     _calendar: MatCalendar<D>;
     /**
      * Theme color of the internal calendar. 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/datepicker/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;
     /** Reference to the datepicker that created the overlay. */
@@ -1168,10 +1158,10 @@ export declare interface MatDatepickerPanel<C extends MatDatepickerControl<D>, S
     closedStream: EventEmitter<void>;
     /**
      * Color palette to use on the datepicker's calendar. 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/datepicker/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 input element the datepicker is associated with. */
@@ -1229,13 +1219,15 @@ export declare class MatDatepickerToggleIcon {
     static ɵdir: i0.ɵɵDirectiveDeclaration<MatDatepickerToggleIcon, "[matDatepickerToggleIcon]", never, {}, {}, never, never, true, never>;
 }
 
-export declare class MatDateRangeInput<D> implements MatFormFieldControl<DateRange<D>>, MatDatepickerControl<D>, MatDateRangeInputParent<D>, MatDateRangePickerInput<D>, AfterContentInit, OnChanges, OnDestroy {
+export declare class MatDateRangeInput<D> implements MatFormFieldControl<DateRange<D>>, MatDatepickerControl<D>, MatDateRangePickerInput<D>, AfterContentInit, OnChanges, OnDestroy {
     private _changeDetectorRef;
     private _elementRef;
     private _dateAdapter;
     private _formField;
     private _closedSubscription;
     private _openedSubscription;
+    _startInput: MatStartDate<D>;
+    _endInput: MatEndDate<D>;
     /** Current value of the range input. */
     get value(): DateRange<D> | null;
     /** Unique ID for the group. */
@@ -1292,8 +1284,6 @@ export declare class MatDateRangeInput<D> implements MatFormFieldControl<DateRan
     comparisonStart: D | null;
     /** End of the comparison range that should be shown in the calendar. */
     comparisonEnd: D | null;
-    _startInput: MatStartDate<D>;
-    _endInput: MatEndDate<D>;
     /**
      * Implemented as a part of `MatFormFieldControl`.
      * TODO(crisbeto): change type to `AbstractControlDirective` after #18206 lands.
@@ -1352,34 +1342,16 @@ export declare class MatDateRangeInput<D> implements MatFormFieldControl<DateRan
     /** Checks whether a specific range input directive is required. */
     private _isTargetRequired;
     static ɵfac: i0.ɵɵFactoryDeclaration<MatDateRangeInput<any>, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<MatDateRangeInput<any>, "mat-date-range-input", ["matDateRangeInput"], { "rangePicker": { "alias": "rangePicker"; "required": false; }; "required": { "alias": "required"; "required": false; }; "dateFilter": { "alias": "dateFilter"; "required": false; }; "min": { "alias": "min"; "required": false; }; "max": { "alias": "max"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "separator": { "alias": "separator"; "required": false; }; "comparisonStart": { "alias": "comparisonStart"; "required": false; }; "comparisonEnd": { "alias": "comparisonEnd"; "required": false; }; }, {}, ["_startInput", "_endInput"], ["input[matStartDate]", "input[matEndDate]"], true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MatDateRangeInput<any>, "mat-date-range-input", ["matDateRangeInput"], { "rangePicker": { "alias": "rangePicker"; "required": false; }; "required": { "alias": "required"; "required": false; }; "dateFilter": { "alias": "dateFilter"; "required": false; }; "min": { "alias": "min"; "required": false; }; "max": { "alias": "max"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "separator": { "alias": "separator"; "required": false; }; "comparisonStart": { "alias": "comparisonStart"; "required": false; }; "comparisonEnd": { "alias": "comparisonEnd"; "required": false; }; }, {}, never, ["input[matStartDate]", "input[matEndDate]"], true, never>;
     static ngAcceptInputType_required: unknown;
     static ngAcceptInputType_disabled: unknown;
 }
 
-/** Parent component that should be wrapped around `MatStartDate` and `MatEndDate`. */
-declare interface MatDateRangeInputParent<D> {
-    id: string;
-    min: D | null;
-    max: D | null;
-    dateFilter: DateFilterFn<D>;
-    rangePicker: {
-        opened: boolean;
-        id: string;
-    };
-    _ariaOwns?: Signal<string | null>;
-    _startInput: MatDateRangeInputPartBase<D>;
-    _endInput: MatDateRangeInputPartBase<D>;
-    _groupDisabled: boolean;
-    _handleChildValueChange(): void;
-    _openDatepicker(): void;
-}
-
 /**
  * Base class for the individual inputs that can be projected inside a `mat-date-range-input`.
  */
-declare abstract class MatDateRangeInputPartBase<D> extends MatDatepickerInputBase<DateRange<D>> implements OnInit, DoCheck {
-    _rangeInput: MatDateRangeInputParent<D>;
+declare abstract class MatDateRangeInputPartBase<D> extends MatDatepickerInputBase<DateRange<D>> implements OnInit, AfterContentInit, DoCheck {
+    _rangeInput: MatDateRangeInput<D>;
     _elementRef: ElementRef<HTMLInputElement>;
     _defaultErrorStateMatcher: ErrorStateMatcher;
     private _injector;
@@ -1393,6 +1365,7 @@ declare abstract class MatDateRangeInputPartBase<D> extends MatDatepickerInputBa
     protected abstract _validator: ValidatorFn | null;
     protected abstract _assignValueToModel(value: D | null): void;
     protected abstract _getValueFromModel(modelValue: DateRange<D>): D | null;
+    protected abstract _register(): void;
     protected readonly _dir: Directionality | null;
     private _errorStateTracker;
     /** Object used to control when error messages are shown. */
@@ -1403,6 +1376,7 @@ declare abstract class MatDateRangeInputPartBase<D> extends MatDatepickerInputBa
     set errorState(value: boolean);
     constructor(...args: unknown[]);
     ngOnInit(): void;
+    ngAfterContentInit(): void;
     ngDoCheck(): void;
     /** Gets whether the input is empty. */
     isEmpty(): boolean;
@@ -1523,6 +1497,7 @@ export declare abstract class MatDateSelectionModel<S, D = ExtractDateTypeFromSe
 export declare class MatEndDate<D> extends MatDateRangeInputPartBase<D> {
     /** Validator that checks that the end date isn't before the start date. */
     private _endValidator;
+    protected _register(): void;
     protected _validator: ValidatorFn | null;
     protected _getValueFromModel(modelValue: DateRange<D>): D | null;
     protected _shouldHandleChangeEvent(change: DateSelectionModelChange<DateRange<D>>): boolean;
@@ -1830,6 +1805,7 @@ export declare class MatStartDate<D> extends MatDateRangeInputPartBase<D> {
     /** Validator that checks that the start date isn't after the end date. */
     private _startValidator;
     protected _validator: ValidatorFn | null;
+    protected _register(): void;
     protected _getValueFromModel(modelValue: DateRange<D>): D | null;
     protected _shouldHandleChangeEvent(change: DateSelectionModelChange<DateRange<D>>): boolean;
     protected _assignValueToModel(value: D | null): void;