@angular/material 20.0.0-next.0 → 20.0.0-next.2

package/datepicker/index.d.ts

@@ -1,385 +1,58 @@
-import { AbstractControl } from '@angular/forms';
-import { AfterContentInit } from '@angular/core';
-import { AfterViewChecked } from '@angular/core';
-import { AfterViewInit } from '@angular/core';
-import { ChangeDetectorRef } from '@angular/core';
-import { ComponentType } from '@angular/cdk/portal';
-import { ControlValueAccessor } from '@angular/forms';
-import { DateAdapter } from '@angular/material/core';
-import { Directionality } from '@angular/cdk/bidi';
-import { DoCheck } from '@angular/core';
-import { ElementRef } from '@angular/core';
-import { ErrorStateMatcher } from '@angular/material/core';
-import { EventEmitter } from '@angular/core';
-import { FactoryProvider } from '@angular/core';
-import { FocusOrigin } from '@angular/cdk/a11y';
-import { FormGroupDirective } from '@angular/forms';
 import * as i0 from '@angular/core';
-import * as i1 from '@angular/material/button';
-import * as i19 from '@angular/cdk/scrolling';
+import { OnChanges, OnDestroy, AfterViewChecked, EventEmitter, SimpleChanges, FactoryProvider, AfterContentInit, ChangeDetectorRef, AfterViewInit, ElementRef, InjectionToken, OnInit, DoCheck, TemplateRef } from '@angular/core';
+import { c as MatButton, n as MatButtonModule } from '../module.d-792a497c.js';
 import * as i2 from '@angular/cdk/overlay';
-import * as i3 from '@angular/cdk/a11y';
-import * as i4 from '@angular/cdk/portal';
-import * as i5 from '@angular/material/core';
-import { InjectionToken } from '@angular/core';
-import { MatButton } from '@angular/material/button';
-import { MatFormFieldControl } from '@angular/material/form-field';
-import { NgControl } from '@angular/forms';
-import { NgForm } from '@angular/forms';
-import { Observable } from 'rxjs';
-import { OnChanges } from '@angular/core';
-import { OnDestroy } from '@angular/core';
-import { OnInit } from '@angular/core';
-import { Overlay } from '@angular/cdk/overlay';
-import { Portal } from '@angular/cdk/portal';
-import { ScrollStrategy } from '@angular/cdk/overlay';
-import { SimpleChanges } from '@angular/core';
-import { Subject } from 'rxjs';
-import { TemplatePortal } from '@angular/cdk/portal';
-import { TemplateRef } from '@angular/core';
-import { ThemePalette } from '@angular/material/core';
-import { ValidationErrors } from '@angular/forms';
-import { Validator } from '@angular/forms';
-import { ValidatorFn } from '@angular/forms';
-import { WritableSignal } from '@angular/core';
-
-/**
- * Function that can be used to filter out dates from a calendar.
- * Datepicker can sometimes receive a null value as input for the date argument.
- * This doesn't represent a "null date" but rather signifies that no date has been selected yet in the calendar.
- */
-export declare type DateFilterFn<D> = (date: D | null) => boolean;
-
-/** Possible positions for the datepicker dropdown along the X axis. */
-export declare type DatepickerDropdownPositionX = 'start' | 'end';
-
-/** Possible positions for the datepicker dropdown along the Y axis. */
-export declare type DatepickerDropdownPositionY = 'above' | 'below';
-
-/** A class representing a range of dates. */
-export declare class DateRange<D> {
-    /** The start date of the range. */
-    readonly start: D | null;
-    /** The end date of the range. */
-    readonly end: D | null;
-    /**
-     * Ensures that objects with a `start` and `end` property can't be assigned to a variable that
-     * expects a `DateRange`
-     */
-    private _disableStructuralEquivalency;
-    constructor(
-    /** The start date of the range. */
-    start: D | null, 
-    /** The end date of the range. */
-    end: D | null);
-}
-
-/**
- * Event emitted by the date selection model when its selection changes.
- * @docs-private
- */
-export declare interface DateSelectionModelChange<S> {
-    /** New value for the selection. */
-    selection: S;
-    /** Object that triggered the change. */
-    source: unknown;
-    /** Previous value */
-    oldValue?: S;
-}
-
-/** Provides the default date range selection behavior. */
-export declare class DefaultMatCalendarRangeStrategy<D> implements MatDateRangeSelectionStrategy<D> {
-    private _dateAdapter;
-    constructor(_dateAdapter: DateAdapter<D>);
-    selectionFinished(date: D, currentRange: DateRange<D>): DateRange<D>;
-    createPreview(activeDate: D | null, currentRange: DateRange<D>): DateRange<D>;
-    createDrag(dragOrigin: D, originalRange: DateRange<D>, newDate: D): DateRange<D> | null;
-    static ɵfac: i0.ɵɵFactoryDeclaration<DefaultMatCalendarRangeStrategy<any>, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<DefaultMatCalendarRangeStrategy<any>>;
-}
-
-/**
- * Conditionally picks the date type, if a DateRange is passed in.
- * @docs-private
- */
-export declare type ExtractDateTypeFromSelection<T> = T extends DateRange<infer D> ? D : NonNullable<T>;
-
-/**
- * When the multi-year view is first opened, the active year will be in view.
- * So we compute how many years are between the active year and the *slot* where our
- * "startingYear" will render when paged into view.
- */
-declare function getActiveOffset<D>(dateAdapter: DateAdapter<D>, activeDate: D, minDate: D | null, maxDate: D | null): number;
-
-declare namespace i10 {
-    export {
-        MAT_DATEPICKER_VALUE_ACCESSOR,
-        MAT_DATEPICKER_VALIDATORS,
-        MatDatepickerInput
-    }
-}
-
-declare namespace i11 {
-    export {
-        MatDatepickerToggleIcon,
-        MatDatepickerToggle
-    }
-}
-
-declare namespace i12 {
-    export {
-        MatMonthView
-    }
-}
-
-declare namespace i13 {
-    export {
-        MatYearView
-    }
-}
-
-declare namespace i14 {
-    export {
-        isSameMultiYearView,
-        getActiveOffset,
-        yearsPerPage,
-        yearsPerRow,
-        MatMultiYearView
-    }
-}
-
-declare namespace i15 {
-    export {
-        MatDateRangeInput
-    }
-}
-
-declare namespace i16 {
-    export {
-        MatStartDate,
-        MatEndDate
-    }
-}
-
-declare namespace i17 {
-    export {
-        MatDateRangePickerInput,
-        MatDateRangePicker
-    }
-}
-
-declare namespace i18 {
-    export {
-        MatDatepickerApply,
-        MatDatepickerCancel,
-        MatDatepickerActions
-    }
-}
-
-declare namespace i6 {
-    export {
-        MatCalendarView,
-        MatCalendarHeader,
-        MatCalendar
-    }
-}
-
-declare namespace i7 {
-    export {
-        MatCalendarCellCssClasses,
-        MatCalendarCellClassFunction,
-        MatCalendarCell,
-        MatCalendarUserEvent,
-        MatCalendarBody
-    }
-}
-
-declare namespace i8 {
-    export {
-        MatDatepicker
-    }
-}
-
-declare namespace i9 {
-    export {
-        MAT_DATEPICKER_SCROLL_STRATEGY_FACTORY,
-        MAT_DATEPICKER_SCROLL_STRATEGY,
-        DatepickerDropdownPositionX,
-        DatepickerDropdownPositionY,
-        MAT_DATEPICKER_SCROLL_STRATEGY_FACTORY_PROVIDER,
-        MatDatepickerContent,
-        MatDatepickerControl,
-        MatDatepickerPanel,
-        MatDatepickerBase
-    }
-}
-
-declare function isSameMultiYearView<D>(dateAdapter: DateAdapter<D>, date1: D, date2: D, minDate: D | null, maxDate: D | null): boolean;
-
-/** Injection token used to customize the date range selection behavior. */
-export declare const MAT_DATE_RANGE_SELECTION_STRATEGY: InjectionToken<MatDateRangeSelectionStrategy<any>>;
-
-/** Injection token that determines the scroll handling while the calendar is open. */
-export declare const MAT_DATEPICKER_SCROLL_STRATEGY: InjectionToken<() => ScrollStrategy>;
-
-/** @docs-private */
-export declare function MAT_DATEPICKER_SCROLL_STRATEGY_FACTORY(overlay: Overlay): () => ScrollStrategy;
+import { ScrollStrategy, Overlay } from '@angular/cdk/overlay';
+import * as i1 from '@angular/cdk/a11y';
+import { FocusOrigin } from '@angular/cdk/a11y';
+import * as i3 from '@angular/cdk/portal';
+import { ComponentType, Portal, TemplatePortal } from '@angular/cdk/portal';
+import { M as MatCommonModule } from '../common-module.d-0e6515ae.js';
+import { Observable, Subject } from 'rxjs';
+import { D as DateAdapter$1 } from '../date-adapter.d-c6835d41.js';
+import { DateAdapter } from '@angular/material/core';
+import { T as ThemePalette } from '../palette.d-ec4a617c.js';
+import { ControlValueAccessor, Validator, ValidatorFn, AbstractControl, ValidationErrors, NgForm, FormGroupDirective, NgControl } from '@angular/forms';
+import { M as MatFormFieldControl } from '../form-field-control.d-eb86711c.js';
+import { Directionality } from '@angular/cdk/bidi';
+import { E as ErrorStateMatcher } from '../error-options.d-448d9046.js';
+import * as i5 from '@angular/cdk/scrolling';
+import '../index.d-0536b706.js';
+import '../ripple.d-2fb57d04.js';
+import '@angular/cdk/platform';
+import '../ripple-loader.d-8aac2988.js';
 
-/** @docs-private */
-export declare const MAT_DATEPICKER_SCROLL_STRATEGY_FACTORY_PROVIDER: {
-    provide: InjectionToken<() => ScrollStrategy>;
-    deps: (typeof Overlay)[];
-    useFactory: typeof MAT_DATEPICKER_SCROLL_STRATEGY_FACTORY;
+/** Extra CSS classes that can be associated with a calendar cell. */
+type MatCalendarCellCssClasses = string | string[] | Set<string> | {
+    [key: string]: any;
 };
-
-/** @docs-private */
-export declare const MAT_DATEPICKER_VALIDATORS: any;
-
-/** @docs-private */
-export declare const MAT_DATEPICKER_VALUE_ACCESSOR: any;
-
-/** @docs-private */
-export declare function MAT_RANGE_DATE_SELECTION_MODEL_FACTORY(parent: MatSingleDateSelectionModel<unknown>, adapter: DateAdapter<unknown>): MatSingleDateSelectionModel<unknown>;
-
-/**
- * Used to provide a range selection model to a component.
- * @docs-private
- */
-export declare const MAT_RANGE_DATE_SELECTION_MODEL_PROVIDER: FactoryProvider;
-
-/** @docs-private */
-export declare function MAT_SINGLE_DATE_SELECTION_MODEL_FACTORY(parent: MatSingleDateSelectionModel<unknown>, adapter: DateAdapter<unknown>): MatSingleDateSelectionModel<unknown>;
-
+/** Function that can generate the extra classes that should be added to a calendar cell. */
+type MatCalendarCellClassFunction<D> = (date: D, view: 'month' | 'year' | 'multi-year') => MatCalendarCellCssClasses;
 /**
- * Used to provide a single selection model to a component.
+ * An internal class that represents the data corresponding to a single calendar cell.
  * @docs-private
  */
-export declare const MAT_SINGLE_DATE_SELECTION_MODEL_PROVIDER: FactoryProvider;
-
-/** A calendar that is used as part of the datepicker. */
-export declare class MatCalendar<D> implements AfterContentInit, AfterViewChecked, OnDestroy, OnChanges {
-    private _dateAdapter;
-    private _dateFormats;
-    private _changeDetectorRef;
-    /** An input indicating the type of the header component, if set. */
-    headerComponent: ComponentType<any>;
-    /** A portal containing the header component type for this calendar. */
-    _calendarHeaderPortal: Portal<any>;
-    private _intlChanges;
-    /**
-     * Used for scheduling that focus should be moved to the active cell on the next tick.
-     * We need to schedule it, rather than do it immediately, because we have to wait
-     * for Angular to re-evaluate the view children.
-     */
-    private _moveFocusOnNextTick;
-    /** A date representing the period (month or year) to start the calendar in. */
-    get startAt(): D | null;
-    set startAt(value: D | null);
-    private _startAt;
-    /** Whether the calendar should be started in month or year view. */
-    startView: MatCalendarView;
-    /** The currently selected date. */
-    get selected(): DateRange<D> | D | null;
-    set selected(value: DateRange<D> | D | null);
-    private _selected;
-    /** The minimum selectable date. */
-    get minDate(): D | null;
-    set minDate(value: D | null);
-    private _minDate;
-    /** The maximum selectable date. */
-    get maxDate(): D | null;
-    set maxDate(value: D | null);
-    private _maxDate;
-    /** Function used to filter which dates are selectable. */
-    dateFilter: (date: D) => boolean;
-    /** Function that can be used to add custom CSS classes to dates. */
-    dateClass: MatCalendarCellClassFunction<D>;
-    /** Start of the comparison range. */
-    comparisonStart: D | null;
-    /** End of the comparison range. */
-    comparisonEnd: D | null;
-    /** ARIA Accessible name of the `<input matStartDate/>` */
-    startDateAccessibleName: string | null;
-    /** ARIA Accessible name of the `<input matEndDate/>` */
-    endDateAccessibleName: string | null;
-    /** Emits when the currently selected date changes. */
-    readonly selectedChange: EventEmitter<D | null>;
-    /**
-     * Emits the year chosen in multiyear view.
-     * This doesn't imply a change on the selected date.
-     */
-    readonly yearSelected: EventEmitter<D>;
-    /**
-     * Emits the month chosen in year view.
-     * This doesn't imply a change on the selected date.
-     */
-    readonly monthSelected: EventEmitter<D>;
-    /**
-     * Emits when the current view changes.
-     */
-    readonly viewChanged: EventEmitter<MatCalendarView>;
-    /** Emits when any date is selected. */
-    readonly _userSelection: EventEmitter<MatCalendarUserEvent<D | null>>;
-    /** Emits a new date range value when the user completes a drag drop operation. */
-    readonly _userDragDrop: EventEmitter<MatCalendarUserEvent<DateRange<D>>>;
-    /** Reference to the current month view component. */
-    monthView: MatMonthView<D>;
-    /** Reference to the current year view component. */
-    yearView: MatYearView<D>;
-    /** Reference to the current multi-year view component. */
-    multiYearView: MatMultiYearView<D>;
-    /**
-     * The current active date. This determines which time period is shown and which date is
-     * highlighted when using keyboard navigation.
-     */
-    get activeDate(): D;
-    set activeDate(value: D);
-    private _clampedActiveDate;
-    /** Whether the calendar is in month view. */
-    get currentView(): MatCalendarView;
-    set currentView(value: MatCalendarView);
-    private _currentView;
-    /** Origin of active drag, or null when dragging is not active. */
-    protected _activeDrag: MatCalendarUserEvent<D> | null;
-    /**
-     * Emits whenever there is a state change that the header may need to respond to.
-     */
-    readonly stateChanges: Subject<void>;
-    constructor(...args: unknown[]);
-    ngAfterContentInit(): void;
-    ngAfterViewChecked(): void;
-    ngOnDestroy(): void;
-    ngOnChanges(changes: SimpleChanges): void;
-    /** Focuses the active date. */
-    focusActiveCell(): void;
-    /** Updates today's date after an update of the active date */
-    updateTodaysDate(): void;
-    /** Handles date selection in the month view. */
-    _dateSelected(event: MatCalendarUserEvent<D | null>): void;
-    /** Handles year selection in the multiyear view. */
-    _yearSelectedInMultiYearView(normalizedYear: D): void;
-    /** Handles month selection in the year view. */
-    _monthSelectedInYearView(normalizedMonth: D): void;
-    /** Handles year/month selection in the multi-year/year views. */
-    _goToDateInView(date: D, view: 'month' | 'year' | 'multi-year'): void;
-    /** Called when the user starts dragging to change a date range. */
-    _dragStarted(event: MatCalendarUserEvent<D>): void;
-    /**
-     * Called when a drag completes. It may end in cancelation or in the selection
-     * of a new range.
-     */
-    _dragEnded(event: MatCalendarUserEvent<DateRange<D> | null>): void;
-    /** Returns the component instance that corresponds to the current calendar view. */
-    private _getCurrentViewComponent;
-    static ɵfac: i0.ɵɵFactoryDeclaration<MatCalendar<any>, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<MatCalendar<any>, "mat-calendar", ["matCalendar"], { "headerComponent": { "alias": "headerComponent"; "required": false; }; "startAt": { "alias": "startAt"; "required": false; }; "startView": { "alias": "startView"; "required": false; }; "selected": { "alias": "selected"; "required": false; }; "minDate": { "alias": "minDate"; "required": false; }; "maxDate": { "alias": "maxDate"; "required": false; }; "dateFilter": { "alias": "dateFilter"; "required": false; }; "dateClass": { "alias": "dateClass"; "required": false; }; "comparisonStart": { "alias": "comparisonStart"; "required": false; }; "comparisonEnd": { "alias": "comparisonEnd"; "required": false; }; "startDateAccessibleName": { "alias": "startDateAccessibleName"; "required": false; }; "endDateAccessibleName": { "alias": "endDateAccessibleName"; "required": false; }; }, { "selectedChange": "selectedChange"; "yearSelected": "yearSelected"; "monthSelected": "monthSelected"; "viewChanged": "viewChanged"; "_userSelection": "_userSelection"; "_userDragDrop": "_userDragDrop"; }, never, never, true, never>;
+declare class MatCalendarCell<D = any> {
+    value: number;
+    displayValue: string;
+    ariaLabel: string;
+    enabled: boolean;
+    cssClasses: MatCalendarCellCssClasses;
+    compareValue: number;
+    rawValue?: D | undefined;
+    readonly id: number;
+    constructor(value: number, displayValue: string, ariaLabel: string, enabled: boolean, cssClasses?: MatCalendarCellCssClasses, compareValue?: number, rawValue?: D | undefined);
+}
+/** Event emitted when a date inside the calendar is triggered as a result of a user action. */
+interface MatCalendarUserEvent<D> {
+    value: D;
+    event: Event;
 }
-
 /**
  * An internal component used to display calendar data in a table.
  * @docs-private
  */
-export declare class MatCalendarBody<D = any> implements OnChanges, OnDestroy, AfterViewChecked {
+declare class MatCalendarBody<D = any> implements OnChanges, OnDestroy, AfterViewChecked {
     private _elementRef;
     private _ngZone;
     private _platform;
@@ -558,429 +231,692 @@ export declare class MatCalendarBody<D = any> implements OnChanges, OnDestroy, A
     static ɵcmp: i0.ɵɵComponentDeclaration<MatCalendarBody<any>, "[mat-calendar-body]", ["matCalendarBody"], { "label": { "alias": "label"; "required": false; }; "rows": { "alias": "rows"; "required": false; }; "todayValue": { "alias": "todayValue"; "required": false; }; "startValue": { "alias": "startValue"; "required": false; }; "endValue": { "alias": "endValue"; "required": false; }; "labelMinRequiredCells": { "alias": "labelMinRequiredCells"; "required": false; }; "numCols": { "alias": "numCols"; "required": false; }; "activeCell": { "alias": "activeCell"; "required": false; }; "isRange": { "alias": "isRange"; "required": false; }; "cellAspectRatio": { "alias": "cellAspectRatio"; "required": false; }; "comparisonStart": { "alias": "comparisonStart"; "required": false; }; "comparisonEnd": { "alias": "comparisonEnd"; "required": false; }; "previewStart": { "alias": "previewStart"; "required": false; }; "previewEnd": { "alias": "previewEnd"; "required": false; }; "startDateAccessibleName": { "alias": "startDateAccessibleName"; "required": false; }; "endDateAccessibleName": { "alias": "endDateAccessibleName"; "required": false; }; }, { "selectedValueChange": "selectedValueChange"; "previewChange": "previewChange"; "activeDateChange": "activeDateChange"; "dragStarted": "dragStarted"; "dragEnded": "dragEnded"; }, never, never, true, never>;
 }
 
-/**
- * An internal class that represents the data corresponding to a single calendar cell.
- * @docs-private
- */
-export declare class MatCalendarCell<D = any> {
-    value: number;
-    displayValue: string;
-    ariaLabel: string;
-    enabled: boolean;
-    cssClasses: MatCalendarCellCssClasses;
-    compareValue: number;
-    rawValue?: D | undefined;
-    readonly id: number;
-    constructor(value: number, displayValue: string, ariaLabel: string, enabled: boolean, cssClasses?: MatCalendarCellCssClasses, compareValue?: number, rawValue?: D | undefined);
-}
-
-/** Function that can generate the extra classes that should be added to a calendar cell. */
-export declare type MatCalendarCellClassFunction<D> = (date: D, view: 'month' | 'year' | 'multi-year') => MatCalendarCellCssClasses;
-
-/** Extra CSS classes that can be associated with a calendar cell. */
-export declare type MatCalendarCellCssClasses = string | string[] | Set<string> | {
-    [key: string]: any;
-};
-
-/** Default header for MatCalendar */
-export declare class MatCalendarHeader<D> {
-    private _intl;
-    calendar: MatCalendar<D>;
-    private _dateAdapter;
-    private _dateFormats;
-    constructor(...args: unknown[]);
-    /** The display text for the current calendar view. */
-    get periodButtonText(): string;
-    /** The aria description for the current calendar view. */
-    get periodButtonDescription(): string;
-    /** The `aria-label` for changing the calendar view. */
-    get periodButtonLabel(): string;
-    /** The label for the previous button. */
-    get prevButtonLabel(): string;
-    /** The label for the next button. */
-    get nextButtonLabel(): string;
-    /** Handles user clicks on the period label. */
-    currentPeriodClicked(): void;
-    /** Handles user clicks on the previous button. */
-    previousClicked(): void;
-    /** Handles user clicks on the next button. */
-    nextClicked(): void;
-    /** Whether the previous period button is enabled. */
-    previousEnabled(): boolean;
-    /** Whether the next period button is enabled. */
-    nextEnabled(): boolean;
-    /** Whether the two dates represent the same view in the current view mode (month or year). */
-    private _isSameView;
+/** A class representing a range of dates. */
+declare class DateRange<D> {
+    /** The start date of the range. */
+    readonly start: D | null;
+    /** The end date of the range. */
+    readonly end: D | null;
     /**
-     * Format two individual labels for the minimum year and maximum year available in the multi-year
-     * calendar view. Returns an array of two strings where the first string is the formatted label
-     * for the minimum year, and the second string is the formatted label for the maximum year.
+     * Ensures that objects with a `start` and `end` property can't be assigned to a variable that
+     * expects a `DateRange`
      */
-    private _formatMinAndMaxYearLabels;
-    _periodButtonLabelId: string;
-    static ɵfac: i0.ɵɵFactoryDeclaration<MatCalendarHeader<any>, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<MatCalendarHeader<any>, "mat-calendar-header", ["matCalendarHeader"], {}, {}, never, ["*"], true, never>;
-}
-
-/** Event emitted when a date inside the calendar is triggered as a result of a user action. */
-export declare interface MatCalendarUserEvent<D> {
-    value: D;
-    event: Event;
+    private _disableStructuralEquivalency;
+    constructor(
+    /** The start date of the range. */
+    start: D | null, 
+    /** The end date of the range. */
+    end: D | null);
 }
-
 /**
- * Possible views for the calendar.
+ * Conditionally picks the date type, if a DateRange is passed in.
  * @docs-private
  */
-export declare type MatCalendarView = 'month' | 'year' | 'multi-year';
-
-/** Component responsible for managing the datepicker popup/dialog. */
-export declare class MatDatepicker<D> extends MatDatepickerBase<MatDatepickerControl<D>, D | null, D> {
-    static ɵfac: i0.ɵɵFactoryDeclaration<MatDatepicker<any>, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<MatDatepicker<any>, "mat-datepicker", ["matDatepicker"], {}, {}, never, never, true, never>;
+type ExtractDateTypeFromSelection<T> = T extends DateRange<infer D> ? D : NonNullable<T>;
+/**
+ * Event emitted by the date selection model when its selection changes.
+ * @docs-private
+ */
+interface DateSelectionModelChange<S> {
+    /** New value for the selection. */
+    selection: S;
+    /** Object that triggered the change. */
+    source: unknown;
+    /** Previous value */
+    oldValue?: S;
 }
-
 /**
- * Container that can be used to project a row of action buttons
- * to the bottom of a datepicker or date range picker.
+ * A selection model containing a date selection.
+ * @docs-private
  */
-export declare class MatDatepickerActions implements AfterViewInit, OnDestroy {
-    private _datepicker;
-    private _viewContainerRef;
-    _template: TemplateRef<unknown>;
-    private _portal;
-    constructor(...args: unknown[]);
-    ngAfterViewInit(): void;
+declare abstract class MatDateSelectionModel<S, D = ExtractDateTypeFromSelection<S>> implements OnDestroy {
+    /** The current selection. */
+    readonly selection: S;
+    protected _adapter: DateAdapter<D>;
+    private readonly _selectionChanged;
+    /** Emits when the selection has changed. */
+    selectionChanged: Observable<DateSelectionModelChange<S>>;
+    protected constructor(
+    /** The current selection. */
+    selection: S, _adapter: DateAdapter<D>);
+    /**
+     * Updates the current selection in the model.
+     * @param value New selection that should be assigned.
+     * @param source Object that triggered the selection change.
+     */
+    updateSelection(value: S, source: unknown): void;
     ngOnDestroy(): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<MatDatepickerActions, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<MatDatepickerActions, "mat-datepicker-actions, mat-date-range-picker-actions", never, {}, {}, never, ["*"], true, never>;
+    protected _isValidDateInstance(date: D): boolean;
+    /** Adds a date to the current selection. */
+    abstract add(date: D | null): void;
+    /** Checks whether the current selection is valid. */
+    abstract isValid(): boolean;
+    /** Checks whether the current selection is complete. */
+    abstract isComplete(): boolean;
+    /** Clones the selection model. */
+    abstract clone(): MatDateSelectionModel<S, D>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatDateSelectionModel<any, any>, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<MatDateSelectionModel<any, any>>;
 }
-
 /**
- * Animations used by the Material datepicker.
+ * A selection model that contains a single date.
  * @docs-private
- * @deprecated No longer used, will be removed.
- * @breaking-change 21.0.0
  */
-export declare const matDatepickerAnimations: {
-    readonly transformPanel: any;
-    readonly fadeInCalendar: any;
-};
-
-/** Button that will close the datepicker and assign the current selection to the data model. */
-export declare class MatDatepickerApply {
-    private _datepicker;
-    constructor(...args: unknown[]);
-    _applySelection(): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<MatDatepickerApply, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<MatDatepickerApply, "[matDatepickerApply], [matDateRangePickerApply]", never, {}, {}, never, never, true, never>;
-}
-
-/** Base class for a datepicker. */
-declare abstract class MatDatepickerBase<C extends MatDatepickerControl<D>, S, D = ExtractDateTypeFromSelection<S>> implements MatDatepickerPanel<C, S, D>, OnDestroy, OnChanges {
-    private _overlay;
-    private _viewContainerRef;
-    private _dateAdapter;
-    private _dir;
-    private _model;
-    private _scrollStrategy;
-    private _inputStateChanges;
-    private _document;
-    /** An input indicating the type of the custom header component for the calendar, if set. */
-    calendarHeaderComponent: ComponentType<any>;
-    /** The date to open the calendar to initially. */
-    get startAt(): D | null;
-    set startAt(value: D | null);
-    private _startAt;
-    /** The view that the calendar should start in. */
-    startView: 'month' | 'year' | 'multi-year';
+declare class MatSingleDateSelectionModel<D> extends MatDateSelectionModel<D | null, D> {
+    constructor(adapter: DateAdapter<D>);
     /**
-     * Theme color of the datepicker's calendar. 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/datepicker/styling.
-     *
-     * For information on applying color variants in M3, see
-     * https://material.angular.io/guide/material-2-theming#optional-add-backwards-compatibility-styles-for-color-variants
+     * Adds a date to the current selection. In the case of a single date selection, the added date
+     * simply overwrites the previous selection
      */
-    get color(): ThemePalette;
-    set color(value: ThemePalette);
-    _color: ThemePalette;
+    add(date: D | null): void;
+    /** Checks whether the current selection is valid. */
+    isValid(): boolean;
     /**
-     * Whether the calendar UI is in touch mode. In touch mode the calendar opens in a dialog rather
-     * than a dropdown and elements have more padding to allow for bigger touch targets.
+     * Checks whether the current selection is complete. In the case of a single date selection, this
+     * is true if the current selection is not null.
      */
-    touchUi: boolean;
-    /** Whether the datepicker pop-up should be disabled. */
-    get disabled(): boolean;
-    set disabled(value: boolean);
-    private _disabled;
-    /** Preferred position of the datepicker in the X axis. */
-    xPosition: DatepickerDropdownPositionX;
-    /** Preferred position of the datepicker in the Y axis. */
-    yPosition: DatepickerDropdownPositionY;
+    isComplete(): boolean;
+    /** Clones the selection model. */
+    clone(): MatSingleDateSelectionModel<D>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatSingleDateSelectionModel<any>, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<MatSingleDateSelectionModel<any>>;
+}
+/**
+ * A selection model that contains a date range.
+ * @docs-private
+ */
+declare class MatRangeDateSelectionModel<D> extends MatDateSelectionModel<DateRange<D>, D> {
+    constructor(adapter: DateAdapter<D>);
     /**
-     * Whether to restore focus to the previously-focused element when the calendar is closed.
-     * Note that automatic focus restoration is an accessibility feature and it is recommended that
-     * you provide your own equivalent, if you decide to turn it off.
+     * Adds a date to the current selection. In the case of a date range selection, the added date
+     * fills in the next `null` value in the range. If both the start and the end already have a date,
+     * the selection is reset so that the given date is the new `start` and the `end` is null.
      */
-    restoreFocus: boolean;
+    add(date: D | null): void;
+    /** Checks whether the current selection is valid. */
+    isValid(): boolean;
     /**
-     * Emits selected year in multiyear view.
-     * This doesn't imply a change on the selected date.
+     * Checks whether the current selection is complete. In the case of a date range selection, this
+     * is true if the current selection has a non-null `start` and `end`.
      */
-    readonly yearSelected: EventEmitter<D>;
+    isComplete(): boolean;
+    /** Clones the selection model. */
+    clone(): MatRangeDateSelectionModel<D>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatRangeDateSelectionModel<any>, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<MatRangeDateSelectionModel<any>>;
+}
+/**
+ * @docs-private
+ * @deprecated No longer used, will be removed.
+ * @breaking-change 21.0.0
+ */
+declare function MAT_SINGLE_DATE_SELECTION_MODEL_FACTORY(parent: MatSingleDateSelectionModel<unknown>, adapter: DateAdapter<unknown>): MatSingleDateSelectionModel<unknown>;
+/**
+ * Used to provide a single selection model to a component.
+ * @docs-private
+ * @deprecated No longer used, will be removed.
+ * @breaking-change 21.0.0
+ */
+declare const MAT_SINGLE_DATE_SELECTION_MODEL_PROVIDER: FactoryProvider;
+/**
+ * @docs-private
+ * @deprecated No longer used, will be removed.
+ * @breaking-change 21.0.0
+ */
+declare function MAT_RANGE_DATE_SELECTION_MODEL_FACTORY(parent: MatSingleDateSelectionModel<unknown>, adapter: DateAdapter<unknown>): MatSingleDateSelectionModel<unknown>;
+/**
+ * Used to provide a range selection model to a component.
+ * @docs-private
+ * @deprecated No longer used, will be removed.
+ * @breaking-change 21.0.0
+ */
+declare const MAT_RANGE_DATE_SELECTION_MODEL_PROVIDER: FactoryProvider;
+
+/**
+ * An internal component used to display a single month in the datepicker.
+ * @docs-private
+ */
+declare class MatMonthView<D> implements AfterContentInit, OnChanges, OnDestroy {
+    readonly _changeDetectorRef: ChangeDetectorRef;
+    private _dateFormats;
+    _dateAdapter: DateAdapter$1<D, any>;
+    private _dir;
+    private _rangeStrategy;
+    private _rerenderSubscription;
+    /** Flag used to filter out space/enter keyup events that originated outside of the view. */
+    private _selectionKeyPressed;
     /**
-     * Emits selected month in year view.
-     * This doesn't imply a change on the selected date.
+     * The date to display in this month view (everything other than the month and year is ignored).
      */
-    readonly monthSelected: EventEmitter<D>;
-    /**
-     * Emits when the current view changes.
-     */
-    readonly viewChanged: EventEmitter<MatCalendarView>;
-    /** Function that can be used to add custom CSS classes to dates. */
-    dateClass: MatCalendarCellClassFunction<D>;
-    /** Emits when the datepicker has been opened. */
-    readonly openedStream: EventEmitter<void>;
-    /** Emits when the datepicker has been closed. */
-    readonly closedStream: EventEmitter<void>;
-    /** Classes to be passed to the date picker panel. */
-    get panelClass(): string | string[];
-    set panelClass(value: string | string[]);
-    private _panelClass;
-    /** Whether the calendar is open. */
-    get opened(): boolean;
-    set opened(value: boolean);
-    private _opened;
-    /** The id for the datepicker calendar. */
-    id: string;
+    get activeDate(): D;
+    set activeDate(value: D);
+    private _activeDate;
+    /** The currently selected date. */
+    get selected(): DateRange<D> | D | null;
+    set selected(value: DateRange<D> | D | null);
+    private _selected;
     /** The minimum selectable date. */
-    _getMinDate(): D | null;
+    get minDate(): D | null;
+    set minDate(value: D | null);
+    private _minDate;
     /** The maximum selectable date. */
-    _getMaxDate(): D | null;
-    _getDateFilter(): DateFilterFn<D>;
-    /** A reference to the overlay into which we've rendered the calendar. */
-    private _overlayRef;
-    /** Reference to the component instance rendered in the overlay. */
-    private _componentRef;
-    /** The element that was focused before the datepicker was opened. */
-    private _focusedElementBeforeOpen;
-    /** Unique class that will be added to the backdrop so that the test harnesses can look it up. */
-    private _backdropHarnessClass;
-    /** Currently-registered actions portal. */
-    private _actionsPortal;
-    /** The input element this datepicker is associated with. */
-    datepickerInput: C;
-    /** Emits when the datepicker's state changes. */
-    readonly stateChanges: Subject<void>;
-    private _injector;
-    private readonly _changeDetectorRef;
+    get maxDate(): D | null;
+    set maxDate(value: D | null);
+    private _maxDate;
+    /** Function used to filter which dates are selectable. */
+    dateFilter: (date: D) => boolean;
+    /** Function that can be used to add custom CSS classes to dates. */
+    dateClass: MatCalendarCellClassFunction<D>;
+    /** Start of the comparison range. */
+    comparisonStart: D | null;
+    /** End of the comparison range. */
+    comparisonEnd: D | null;
+    /** ARIA Accessible name of the `<input matStartDate/>` */
+    startDateAccessibleName: string | null;
+    /** ARIA Accessible name of the `<input matEndDate/>` */
+    endDateAccessibleName: string | null;
+    /** Origin of active drag, or null when dragging is not active. */
+    activeDrag: MatCalendarUserEvent<D> | null;
+    /** Emits when a new date is selected. */
+    readonly selectedChange: EventEmitter<D | null>;
+    /** Emits when any date is selected. */
+    readonly _userSelection: EventEmitter<MatCalendarUserEvent<D | null>>;
+    /** Emits when the user initiates a date range drag via mouse or touch. */
+    readonly dragStarted: EventEmitter<MatCalendarUserEvent<D>>;
+    /**
+     * Emits when the user completes or cancels a date range drag.
+     * Emits null when the drag was canceled or the newly selected date range if completed.
+     */
+    readonly dragEnded: EventEmitter<MatCalendarUserEvent<DateRange<D> | null>>;
+    /** Emits when any date is activated. */
+    readonly activeDateChange: EventEmitter<D>;
+    /** The body of calendar table */
+    _matCalendarBody: MatCalendarBody;
+    /** The label for this month (e.g. "January 2017"). */
+    _monthLabel: string;
+    /** Grid of calendar cells representing the dates of the month. */
+    _weeks: MatCalendarCell[][];
+    /** The number of blank cells in the first row before the 1st of the month. */
+    _firstWeekOffset: number;
+    /** Start value of the currently-shown date range. */
+    _rangeStart: number | null;
+    /** End value of the currently-shown date range. */
+    _rangeEnd: number | null;
+    /** Start value of the currently-shown comparison date range. */
+    _comparisonRangeStart: number | null;
+    /** End value of the currently-shown comparison date range. */
+    _comparisonRangeEnd: number | null;
+    /** Start of the preview range. */
+    _previewStart: number | null;
+    /** End of the preview range. */
+    _previewEnd: number | null;
+    /** Whether the user is currently selecting a range of dates. */
+    _isRange: boolean;
+    /** The date of the month that today falls on. Null if today is in another month. */
+    _todayDate: number | null;
+    /** The names of the weekdays. */
+    _weekdays: {
+        long: string;
+        narrow: string;
+        id: number;
+    }[];
     constructor(...args: unknown[]);
+    ngAfterContentInit(): void;
     ngOnChanges(changes: SimpleChanges): void;
     ngOnDestroy(): void;
-    /** Selects the given date */
-    select(date: D): void;
-    /** Emits the selected year in multiyear view */
-    _selectYear(normalizedYear: D): void;
-    /** Emits selected month in year view */
-    _selectMonth(normalizedMonth: D): void;
-    /** Emits changed view */
-    _viewChanged(view: MatCalendarView): void;
+    /** Handles when a new date is selected. */
+    _dateSelected(event: MatCalendarUserEvent<number>): void;
     /**
-     * Register an input with this datepicker.
-     * @param input The datepicker input to register with this datepicker.
-     * @returns Selection model that the input should hook itself up to.
+     * Takes the index of a calendar body cell wrapped in an event as argument. For the date that
+     * corresponds to the given cell, set `activeDate` to that date and fire `activeDateChange` with
+     * that date.
+     *
+     * This function is used to match each component's model of the active date with the calendar
+     * body cell that was focused. It updates its value of `activeDate` synchronously and updates the
+     * parent's value asynchronously via the `activeDateChange` event. The child component receives an
+     * updated value asynchronously via the `activeCell` Input.
      */
-    registerInput(input: C): MatDateSelectionModel<S, D>;
+    _updateActiveDate(event: MatCalendarUserEvent<number>): void;
+    /** Handles keydown events on the calendar body when calendar is in month view. */
+    _handleCalendarBodyKeydown(event: KeyboardEvent): void;
+    /** Handles keyup events on the calendar body when calendar is in month view. */
+    _handleCalendarBodyKeyup(event: KeyboardEvent): void;
+    /** Initializes this month view. */
+    _init(): void;
+    /** Focuses the active cell after the microtask queue is empty. */
+    _focusActiveCell(movePreview?: boolean): void;
+    /** Focuses the active cell after change detection has run and the microtask queue is empty. */
+    _focusActiveCellAfterViewChecked(): void;
+    /** Called when the user has activated a new cell and the preview needs to be updated. */
+    _previewChanged({ event, value: cell }: MatCalendarUserEvent<MatCalendarCell<D> | null>): void;
     /**
-     * Registers a portal containing action buttons with the datepicker.
-     * @param portal Portal to be registered.
+     * Called when the user has ended a drag. If the drag/drop was successful,
+     * computes and emits the new range selection.
      */
-    registerActions(portal: TemplatePortal): void;
+    protected _dragEnded(event: MatCalendarUserEvent<D | null>): void;
     /**
-     * Removes a portal containing action buttons from the datepicker.
-     * @param portal Portal to be removed.
+     * Takes a day of the month and returns a new date in the same month and year as the currently
+     *  active date. The returned date will have the same day of the month as the argument date.
      */
-    removeActions(portal: TemplatePortal): void;
-    /** Open the calendar. */
-    open(): void;
-    /** Close the calendar. */
-    close(): void;
-    /** Applies the current pending selection on the overlay to the model. */
-    _applyPendingSelection(): void;
-    /** Forwards relevant values from the datepicker to the datepicker content inside the overlay. */
-    protected _forwardContentValues(instance: MatDatepickerContent<S, D>): void;
-    /** Opens the overlay with the calendar. */
-    private _openOverlay;
-    /** Destroys the current overlay. */
-    private _destroyOverlay;
-    /** Gets a position strategy that will open the calendar as a dropdown. */
-    private _getDialogStrategy;
-    /** Gets a position strategy that will open the calendar as a dropdown. */
-    private _getDropdownStrategy;
-    /** Sets the positions of the datepicker in dropdown mode based on the current configuration. */
-    private _setConnectedPositions;
-    /** Gets an observable that will emit when the overlay is supposed to be closed. */
-    private _getCloseStream;
-    static ɵfac: i0.ɵɵFactoryDeclaration<MatDatepickerBase<any, any, any>, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<MatDatepickerBase<any, any, any>, never, never, { "calendarHeaderComponent": { "alias": "calendarHeaderComponent"; "required": false; }; "startAt": { "alias": "startAt"; "required": false; }; "startView": { "alias": "startView"; "required": false; }; "color": { "alias": "color"; "required": false; }; "touchUi": { "alias": "touchUi"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "xPosition": { "alias": "xPosition"; "required": false; }; "yPosition": { "alias": "yPosition"; "required": false; }; "restoreFocus": { "alias": "restoreFocus"; "required": false; }; "dateClass": { "alias": "dateClass"; "required": false; }; "panelClass": { "alias": "panelClass"; "required": false; }; "opened": { "alias": "opened"; "required": false; }; }, { "yearSelected": "yearSelected"; "monthSelected": "monthSelected"; "viewChanged": "viewChanged"; "openedStream": "opened"; "closedStream": "closed"; }, never, never, true, never>;
-    static ngAcceptInputType_touchUi: unknown;
-    static ngAcceptInputType_disabled: unknown;
-    static ngAcceptInputType_restoreFocus: unknown;
-    static ngAcceptInputType_opened: unknown;
-}
-
-/** Button that will close the datepicker and discard the current selection. */
-export declare class MatDatepickerCancel {
-    _datepicker: MatDatepickerBase<MatDatepickerControl<any>, unknown, {}>;
-    constructor(...args: unknown[]);
-    static ɵfac: i0.ɵɵFactoryDeclaration<MatDatepickerCancel, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<MatDatepickerCancel, "[matDatepickerCancel], [matDateRangePickerCancel]", never, {}, {}, never, never, true, never>;
+    private _getDateFromDayOfMonth;
+    /** Initializes the weekdays. */
+    private _initWeekdays;
+    /** Creates MatCalendarCells for the dates in this month. */
+    private _createWeekCells;
+    /** Date filter for the month */
+    private _shouldEnableDate;
+    /**
+     * Gets the date in this month that the given Date falls on.
+     * Returns null if the given Date is in another month.
+     */
+    private _getDateInCurrentMonth;
+    /** Checks whether the 2 dates are non-null and fall within the same month of the same year. */
+    private _hasSameMonthAndYear;
+    /** Gets the value that will be used to one cell to another. */
+    private _getCellCompareValue;
+    /** Determines whether the user has the RTL layout direction. */
+    private _isRtl;
+    /** Sets the current range based on a model value. */
+    private _setRanges;
+    /** Gets whether a date can be selected in the month view. */
+    private _canSelect;
+    /** Clears out preview state. */
+    private _clearPreview;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatMonthView<any>, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MatMonthView<any>, "mat-month-view", ["matMonthView"], { "activeDate": { "alias": "activeDate"; "required": false; }; "selected": { "alias": "selected"; "required": false; }; "minDate": { "alias": "minDate"; "required": false; }; "maxDate": { "alias": "maxDate"; "required": false; }; "dateFilter": { "alias": "dateFilter"; "required": false; }; "dateClass": { "alias": "dateClass"; "required": false; }; "comparisonStart": { "alias": "comparisonStart"; "required": false; }; "comparisonEnd": { "alias": "comparisonEnd"; "required": false; }; "startDateAccessibleName": { "alias": "startDateAccessibleName"; "required": false; }; "endDateAccessibleName": { "alias": "endDateAccessibleName"; "required": false; }; "activeDrag": { "alias": "activeDrag"; "required": false; }; }, { "selectedChange": "selectedChange"; "_userSelection": "_userSelection"; "dragStarted": "dragStarted"; "dragEnded": "dragEnded"; "activeDateChange": "activeDateChange"; }, never, never, true, never>;
 }
 
+declare const yearsPerPage = 24;
+declare const yearsPerRow = 4;
 /**
- * Component used as the content for the datepicker overlay. We use this instead of using
- * MatCalendar directly as the content so we can control the initial focus. This also gives us a
- * place to put additional features of the overlay that are not part of the calendar itself in the
- * future. (e.g. confirmation buttons).
+ * An internal component used to display a year selector in the datepicker.
  * @docs-private
  */
-export declare class MatDatepickerContent<S, D = ExtractDateTypeFromSelection<S>> implements AfterViewInit, OnDestroy {
-    protected _elementRef: ElementRef<HTMLElement>;
-    protected _animationsDisabled: boolean;
+declare class MatMultiYearView<D> implements AfterContentInit, OnDestroy {
     private _changeDetectorRef;
-    private _globalModel;
-    private _dateAdapter;
-    private _ngZone;
-    private _rangeSelectionStrategy;
-    private _stateChanges;
-    private _model;
-    private _eventCleanups;
-    private _animationFallback;
-    /** Reference to the internal calendar component. */
-    _calendar: MatCalendar<D>;
-    /**
-     * Theme color of the internal calendar. 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/datepicker/styling.
-     *
-     * For information on applying color variants in M3, see
-     * 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. */
-    datepicker: MatDatepickerBase<any, S, D>;
-    /** Start of the comparison range. */
-    comparisonStart: D | null;
-    /** End of the comparison range. */
-    comparisonEnd: D | null;
-    /** ARIA Accessible name of the `<input matStartDate/>` */
-    startDateAccessibleName: string | null;
-    /** ARIA Accessible name of the `<input matEndDate/>` */
-    endDateAccessibleName: string | null;
-    /** Whether the datepicker is above or below the input. */
-    _isAbove: boolean;
-    /** Emits when an animation has finished. */
-    readonly _animationDone: Subject<void>;
-    /** Whether there is an in-progress animation. */
-    _isAnimating: boolean;
-    /** Text for the close button. */
-    _closeButtonText: string;
-    /** Whether the close button currently has focus. */
-    _closeButtonFocused: boolean;
-    /** Portal with projected action buttons. */
-    _actionsPortal: TemplatePortal | null;
-    /** Id of the label for the `role="dialog"` element. */
-    _dialogLabelId: string | null;
+    _dateAdapter: DateAdapter$1<D, any>;
+    private _dir;
+    private _rerenderSubscription;
+    /** Flag used to filter out space/enter keyup events that originated outside of the view. */
+    private _selectionKeyPressed;
+    /** The date to display in this multi-year view (everything other than the year is ignored). */
+    get activeDate(): D;
+    set activeDate(value: D);
+    private _activeDate;
+    /** The currently selected date. */
+    get selected(): DateRange<D> | D | null;
+    set selected(value: DateRange<D> | D | null);
+    private _selected;
+    /** The minimum selectable date. */
+    get minDate(): D | null;
+    set minDate(value: D | null);
+    private _minDate;
+    /** The maximum selectable date. */
+    get maxDate(): D | null;
+    set maxDate(value: D | null);
+    private _maxDate;
+    /** A function used to filter which dates are selectable. */
+    dateFilter: (date: D) => boolean;
+    /** Function that can be used to add custom CSS classes to date cells. */
+    dateClass: MatCalendarCellClassFunction<D>;
+    /** Emits when a new year is selected. */
+    readonly selectedChange: EventEmitter<D>;
+    /** Emits the selected year. This doesn't imply a change on the selected date */
+    readonly yearSelected: EventEmitter<D>;
+    /** Emits when any date is activated. */
+    readonly activeDateChange: EventEmitter<D>;
+    /** The body of calendar table */
+    _matCalendarBody: MatCalendarBody;
+    /** Grid of calendar cells representing the currently displayed years. */
+    _years: MatCalendarCell[][];
+    /** The year that today falls on. */
+    _todayYear: number;
+    /** The year of the selected date. Null if the selected date is null. */
+    _selectedYear: number | null;
     constructor(...args: unknown[]);
-    ngAfterViewInit(): void;
+    ngAfterContentInit(): void;
     ngOnDestroy(): void;
-    _handleUserSelection(event: MatCalendarUserEvent<D | null>): void;
-    _handleUserDragDrop(event: MatCalendarUserEvent<DateRange<D>>): void;
-    _startExitAnimation(): void;
-    private _handleAnimationEvent;
-    _getSelected(): D | DateRange<D> | null;
-    /** Applies the current pending selection to the global model. */
-    _applyPendingSelection(): void;
+    /** Initializes this multi-year view. */
+    _init(): void;
+    /** Handles when a new year is selected. */
+    _yearSelected(event: MatCalendarUserEvent<number>): void;
     /**
-     * Assigns a new portal containing the datepicker actions.
-     * @param portal Portal with the actions to be assigned.
-     * @param forceRerender Whether a re-render of the portal should be triggered. This isn't
-     * necessary if the portal is assigned during initialization, but it may be required if it's
-     * added at a later point.
+     * Takes the index of a calendar body cell wrapped in an event as argument. For the date that
+     * corresponds to the given cell, set `activeDate` to that date and fire `activeDateChange` with
+     * that date.
+     *
+     * This function is used to match each component's model of the active date with the calendar
+     * body cell that was focused. It updates its value of `activeDate` synchronously and updates the
+     * parent's value asynchronously via the `activeDateChange` event. The child component receives an
+     * updated value asynchronously via the `activeCell` Input.
      */
-    _assignActions(portal: TemplatePortal<any> | null, forceRerender: boolean): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<MatDatepickerContent<any, any>, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<MatDatepickerContent<any, any>, "mat-datepicker-content", ["matDatepickerContent"], { "color": { "alias": "color"; "required": false; }; }, {}, never, never, true, never>;
+    _updateActiveDate(event: MatCalendarUserEvent<number>): void;
+    /** Handles keydown events on the calendar body when calendar is in multi-year view. */
+    _handleCalendarBodyKeydown(event: KeyboardEvent): void;
+    /** Handles keyup events on the calendar body when calendar is in multi-year view. */
+    _handleCalendarBodyKeyup(event: KeyboardEvent): void;
+    _getActiveCell(): number;
+    /** Focuses the active cell after the microtask queue is empty. */
+    _focusActiveCell(): void;
+    /** Focuses the active cell after change detection has run and the microtask queue is empty. */
+    _focusActiveCellAfterViewChecked(): void;
+    /**
+     * Takes a year and returns a new date on the same day and month as the currently active date
+     *  The returned date will have the same year as the argument date.
+     */
+    private _getDateFromYear;
+    /** Creates an MatCalendarCell for the given year. */
+    private _createCellForYear;
+    /** Whether the given year is enabled. */
+    private _shouldEnableYear;
+    /** Determines whether the user has the RTL layout direction. */
+    private _isRtl;
+    /** Sets the currently-highlighted year based on a model value. */
+    private _setSelectedYear;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatMultiYearView<any>, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MatMultiYearView<any>, "mat-multi-year-view", ["matMultiYearView"], { "activeDate": { "alias": "activeDate"; "required": false; }; "selected": { "alias": "selected"; "required": false; }; "minDate": { "alias": "minDate"; "required": false; }; "maxDate": { "alias": "maxDate"; "required": false; }; "dateFilter": { "alias": "dateFilter"; "required": false; }; "dateClass": { "alias": "dateClass"; "required": false; }; }, { "selectedChange": "selectedChange"; "yearSelected": "yearSelected"; "activeDateChange": "activeDateChange"; }, never, never, true, never>;
 }
 
-/** Form control that can be associated with a datepicker. */
-export declare interface MatDatepickerControl<D> {
-    getStartValue(): D | null;
-    getThemePalette(): ThemePalette;
-    min: D | null;
-    max: D | null;
-    disabled: boolean;
-    dateFilter: DateFilterFn<D>;
-    getConnectedOverlayOrigin(): ElementRef;
-    getOverlayLabelId(): string | null;
-    stateChanges: Observable<void>;
+/**
+ * An internal component used to display a single year in the datepicker.
+ * @docs-private
+ */
+declare class MatYearView<D> implements AfterContentInit, OnDestroy {
+    readonly _changeDetectorRef: ChangeDetectorRef;
+    private _dateFormats;
+    _dateAdapter: DateAdapter$1<D, any>;
+    private _dir;
+    private _rerenderSubscription;
+    /** Flag used to filter out space/enter keyup events that originated outside of the view. */
+    private _selectionKeyPressed;
+    /** The date to display in this year view (everything other than the year is ignored). */
+    get activeDate(): D;
+    set activeDate(value: D);
+    private _activeDate;
+    /** The currently selected date. */
+    get selected(): DateRange<D> | D | null;
+    set selected(value: DateRange<D> | D | null);
+    private _selected;
+    /** The minimum selectable date. */
+    get minDate(): D | null;
+    set minDate(value: D | null);
+    private _minDate;
+    /** The maximum selectable date. */
+    get maxDate(): D | null;
+    set maxDate(value: D | null);
+    private _maxDate;
+    /** A function used to filter which dates are selectable. */
+    dateFilter: (date: D) => boolean;
+    /** Function that can be used to add custom CSS classes to date cells. */
+    dateClass: MatCalendarCellClassFunction<D>;
+    /** Emits when a new month is selected. */
+    readonly selectedChange: EventEmitter<D>;
+    /** Emits the selected month. This doesn't imply a change on the selected date */
+    readonly monthSelected: EventEmitter<D>;
+    /** Emits when any date is activated. */
+    readonly activeDateChange: EventEmitter<D>;
+    /** The body of calendar table */
+    _matCalendarBody: MatCalendarBody;
+    /** Grid of calendar cells representing the months of the year. */
+    _months: MatCalendarCell[][];
+    /** The label for this year (e.g. "2017"). */
+    _yearLabel: string;
+    /** The month in this year that today falls on. Null if today is in a different year. */
+    _todayMonth: number | null;
+    /**
+     * The month in this year that the selected Date falls on.
+     * Null if the selected Date is in a different year.
+     */
+    _selectedMonth: number | null;
+    constructor(...args: unknown[]);
+    ngAfterContentInit(): void;
+    ngOnDestroy(): void;
+    /** Handles when a new month is selected. */
+    _monthSelected(event: MatCalendarUserEvent<number>): void;
+    /**
+     * Takes the index of a calendar body cell wrapped in an event as argument. For the date that
+     * corresponds to the given cell, set `activeDate` to that date and fire `activeDateChange` with
+     * that date.
+     *
+     * This function is used to match each component's model of the active date with the calendar
+     * body cell that was focused. It updates its value of `activeDate` synchronously and updates the
+     * parent's value asynchronously via the `activeDateChange` event. The child component receives an
+     * updated value asynchronously via the `activeCell` Input.
+     */
+    _updateActiveDate(event: MatCalendarUserEvent<number>): void;
+    /** Handles keydown events on the calendar body when calendar is in year view. */
+    _handleCalendarBodyKeydown(event: KeyboardEvent): void;
+    /** Handles keyup events on the calendar body when calendar is in year view. */
+    _handleCalendarBodyKeyup(event: KeyboardEvent): void;
+    /** Initializes this year view. */
+    _init(): void;
+    /** Focuses the active cell after the microtask queue is empty. */
+    _focusActiveCell(): void;
+    /** Schedules the matCalendarBody to focus the active cell after change detection has run */
+    _focusActiveCellAfterViewChecked(): void;
+    /**
+     * Gets the month in this year that the given Date falls on.
+     * Returns null if the given Date is in another year.
+     */
+    private _getMonthInCurrentYear;
+    /**
+     * Takes a month and returns a new date in the same day and year as the currently active date.
+     *  The returned date will have the same month as the argument date.
+     */
+    private _getDateFromMonth;
+    /** Creates an MatCalendarCell for the given month. */
+    private _createCellForMonth;
+    /** Whether the given month is enabled. */
+    private _shouldEnableMonth;
+    /**
+     * Tests whether the combination month/year is after this.maxDate, considering
+     * just the month and year of this.maxDate
+     */
+    private _isYearAndMonthAfterMaxDate;
+    /**
+     * Tests whether the combination month/year is before this.minDate, considering
+     * just the month and year of this.minDate
+     */
+    private _isYearAndMonthBeforeMinDate;
+    /** Determines whether the user has the RTL layout direction. */
+    private _isRtl;
+    /** Sets the currently-selected month based on a model value. */
+    private _setSelectedMonth;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatYearView<any>, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MatYearView<any>, "mat-year-view", ["matYearView"], { "activeDate": { "alias": "activeDate"; "required": false; }; "selected": { "alias": "selected"; "required": false; }; "minDate": { "alias": "minDate"; "required": false; }; "maxDate": { "alias": "maxDate"; "required": false; }; "dateFilter": { "alias": "dateFilter"; "required": false; }; "dateClass": { "alias": "dateClass"; "required": false; }; }, { "selectedChange": "selectedChange"; "monthSelected": "monthSelected"; "activeDateChange": "activeDateChange"; }, never, never, true, never>;
 }
 
-/** Directive used to connect an input to a MatDatepicker. */
-export declare class MatDatepickerInput<D> extends MatDatepickerInputBase<D | null, D> implements MatDatepickerControl<D | null>, OnDestroy {
-    private _formField;
-    private _closedSubscription;
-    private _openedSubscription;
-    /** The datepicker that this input is associated with. */
-    set matDatepicker(datepicker: MatDatepickerPanel<MatDatepickerControl<D>, D | null, D>);
-    _datepicker: MatDatepickerPanel<MatDatepickerControl<D>, D | null, D>;
-    /** The id of the panel owned by this input. */
-    protected _ariaOwns: WritableSignal<string | null>;
-    /** The minimum valid date. */
-    get min(): D | null;
-    set min(value: D | null);
-    private _min;
-    /** The maximum valid date. */
-    get max(): D | null;
-    set max(value: D | null);
-    private _max;
-    /** Function that can be used to filter out dates within the datepicker. */
-    get dateFilter(): DateFilterFn<D | null>;
-    set dateFilter(value: DateFilterFn<D | null>);
-    private _dateFilter;
-    /** The combined form control validator for this input. */
-    protected _validator: ValidatorFn | null;
+/**
+ * Possible views for the calendar.
+ * @docs-private
+ */
+type MatCalendarView = 'month' | 'year' | 'multi-year';
+/** Default header for MatCalendar */
+declare class MatCalendarHeader<D> {
+    private _intl;
+    calendar: MatCalendar<D>;
+    private _dateAdapter;
+    private _dateFormats;
     constructor(...args: unknown[]);
+    /** The display text for the current calendar view. */
+    get periodButtonText(): string;
+    /** The aria description for the current calendar view. */
+    get periodButtonDescription(): string;
+    /** The `aria-label` for changing the calendar view. */
+    get periodButtonLabel(): string;
+    /** The label for the previous button. */
+    get prevButtonLabel(): string;
+    /** The label for the next button. */
+    get nextButtonLabel(): string;
+    /** Handles user clicks on the period label. */
+    currentPeriodClicked(): void;
+    /** Handles user clicks on the previous button. */
+    previousClicked(): void;
+    /** Handles user clicks on the next button. */
+    nextClicked(): void;
+    /** Whether the previous period button is enabled. */
+    previousEnabled(): boolean;
+    /** Whether the next period button is enabled. */
+    nextEnabled(): boolean;
+    /** Whether the two dates represent the same view in the current view mode (month or year). */
+    private _isSameView;
     /**
-     * Gets the element that the datepicker popup should be connected to.
-     * @return The element to connect the popup to.
+     * Format two individual labels for the minimum year and maximum year available in the multi-year
+     * calendar view. Returns an array of two strings where the first string is the formatted label
+     * for the minimum year, and the second string is the formatted label for the maximum year.
      */
-    getConnectedOverlayOrigin(): ElementRef;
-    /** Gets the ID of an element that should be used a description for the calendar overlay. */
-    getOverlayLabelId(): string | null;
-    /** Returns the palette used by the input's form field, if any. */
-    getThemePalette(): ThemePalette;
-    /** Gets the value at which the calendar should start. */
-    getStartValue(): D | null;
+    private _formatMinAndMaxYearLabels;
+    _periodButtonLabelId: string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatCalendarHeader<any>, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MatCalendarHeader<any>, "mat-calendar-header", ["matCalendarHeader"], {}, {}, never, ["*"], true, never>;
+}
+/** A calendar that is used as part of the datepicker. */
+declare class MatCalendar<D> implements AfterContentInit, AfterViewChecked, OnDestroy, OnChanges {
+    private _dateAdapter;
+    private _dateFormats;
+    private _changeDetectorRef;
+    /** An input indicating the type of the header component, if set. */
+    headerComponent: ComponentType<any>;
+    /** A portal containing the header component type for this calendar. */
+    _calendarHeaderPortal: Portal<any>;
+    private _intlChanges;
+    /**
+     * Used for scheduling that focus should be moved to the active cell on the next tick.
+     * We need to schedule it, rather than do it immediately, because we have to wait
+     * for Angular to re-evaluate the view children.
+     */
+    private _moveFocusOnNextTick;
+    /** A date representing the period (month or year) to start the calendar in. */
+    get startAt(): D | null;
+    set startAt(value: D | null);
+    private _startAt;
+    /** Whether the calendar should be started in month or year view. */
+    startView: MatCalendarView;
+    /** The currently selected date. */
+    get selected(): DateRange<D> | D | null;
+    set selected(value: DateRange<D> | D | null);
+    private _selected;
+    /** The minimum selectable date. */
+    get minDate(): D | null;
+    set minDate(value: D | null);
+    private _minDate;
+    /** The maximum selectable date. */
+    get maxDate(): D | null;
+    set maxDate(value: D | null);
+    private _maxDate;
+    /** Function used to filter which dates are selectable. */
+    dateFilter: (date: D) => boolean;
+    /** Function that can be used to add custom CSS classes to dates. */
+    dateClass: MatCalendarCellClassFunction<D>;
+    /** Start of the comparison range. */
+    comparisonStart: D | null;
+    /** End of the comparison range. */
+    comparisonEnd: D | null;
+    /** ARIA Accessible name of the `<input matStartDate/>` */
+    startDateAccessibleName: string | null;
+    /** ARIA Accessible name of the `<input matEndDate/>` */
+    endDateAccessibleName: string | null;
+    /** Emits when the currently selected date changes. */
+    readonly selectedChange: EventEmitter<D | null>;
+    /**
+     * Emits the year chosen in multiyear view.
+     * This doesn't imply a change on the selected date.
+     */
+    readonly yearSelected: EventEmitter<D>;
+    /**
+     * Emits the month chosen in year view.
+     * This doesn't imply a change on the selected date.
+     */
+    readonly monthSelected: EventEmitter<D>;
+    /**
+     * Emits when the current view changes.
+     */
+    readonly viewChanged: EventEmitter<MatCalendarView>;
+    /** Emits when any date is selected. */
+    readonly _userSelection: EventEmitter<MatCalendarUserEvent<D | null>>;
+    /** Emits a new date range value when the user completes a drag drop operation. */
+    readonly _userDragDrop: EventEmitter<MatCalendarUserEvent<DateRange<D>>>;
+    /** Reference to the current month view component. */
+    monthView: MatMonthView<D>;
+    /** Reference to the current year view component. */
+    yearView: MatYearView<D>;
+    /** Reference to the current multi-year view component. */
+    multiYearView: MatMultiYearView<D>;
+    /**
+     * The current active date. This determines which time period is shown and which date is
+     * highlighted when using keyboard navigation.
+     */
+    get activeDate(): D;
+    set activeDate(value: D);
+    private _clampedActiveDate;
+    /** Whether the calendar is in month view. */
+    get currentView(): MatCalendarView;
+    set currentView(value: MatCalendarView);
+    private _currentView;
+    /** Origin of active drag, or null when dragging is not active. */
+    protected _activeDrag: MatCalendarUserEvent<D> | null;
+    /**
+     * Emits whenever there is a state change that the header may need to respond to.
+     */
+    readonly stateChanges: Subject<void>;
+    constructor(...args: unknown[]);
+    ngAfterContentInit(): void;
+    ngAfterViewChecked(): void;
     ngOnDestroy(): void;
-    /** Opens the associated datepicker. */
-    protected _openPopup(): void;
-    protected _getValueFromModel(modelValue: D | null): D | null;
-    protected _assignValueToModel(value: D | null): void;
-    /** Gets the input's minimum date. */
-    _getMinDate(): D | null;
-    /** Gets the input's maximum date. */
-    _getMaxDate(): D | null;
-    /** Gets the input's date filtering function. */
-    protected _getDateFilter(): DateFilterFn<D | null>;
-    protected _shouldHandleChangeEvent(event: DateSelectionModelChange<D>): boolean;
-    static ɵfac: i0.ɵɵFactoryDeclaration<MatDatepickerInput<any>, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<MatDatepickerInput<any>, "input[matDatepicker]", ["matDatepickerInput"], { "matDatepicker": { "alias": "matDatepicker"; "required": false; }; "min": { "alias": "min"; "required": false; }; "max": { "alias": "max"; "required": false; }; "dateFilter": { "alias": "matDatepickerFilter"; "required": false; }; }, {}, never, never, true, never>;
+    ngOnChanges(changes: SimpleChanges): void;
+    /** Focuses the active date. */
+    focusActiveCell(): void;
+    /** Updates today's date after an update of the active date */
+    updateTodaysDate(): void;
+    /** Handles date selection in the month view. */
+    _dateSelected(event: MatCalendarUserEvent<D | null>): void;
+    /** Handles year selection in the multiyear view. */
+    _yearSelectedInMultiYearView(normalizedYear: D): void;
+    /** Handles month selection in the year view. */
+    _monthSelectedInYearView(normalizedMonth: D): void;
+    /** Handles year/month selection in the multi-year/year views. */
+    _goToDateInView(date: D, view: 'month' | 'year' | 'multi-year'): void;
+    /** Called when the user starts dragging to change a date range. */
+    _dragStarted(event: MatCalendarUserEvent<D>): void;
+    /**
+     * Called when a drag completes. It may end in cancelation or in the selection
+     * of a new range.
+     */
+    _dragEnded(event: MatCalendarUserEvent<DateRange<D> | null>): void;
+    /** Returns the component instance that corresponds to the current calendar view. */
+    private _getCurrentViewComponent;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatCalendar<any>, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MatCalendar<any>, "mat-calendar", ["matCalendar"], { "headerComponent": { "alias": "headerComponent"; "required": false; }; "startAt": { "alias": "startAt"; "required": false; }; "startView": { "alias": "startView"; "required": false; }; "selected": { "alias": "selected"; "required": false; }; "minDate": { "alias": "minDate"; "required": false; }; "maxDate": { "alias": "maxDate"; "required": false; }; "dateFilter": { "alias": "dateFilter"; "required": false; }; "dateClass": { "alias": "dateClass"; "required": false; }; "comparisonStart": { "alias": "comparisonStart"; "required": false; }; "comparisonEnd": { "alias": "comparisonEnd"; "required": false; }; "startDateAccessibleName": { "alias": "startDateAccessibleName"; "required": false; }; "endDateAccessibleName": { "alias": "endDateAccessibleName"; "required": false; }; }, { "selectedChange": "selectedChange"; "yearSelected": "yearSelected"; "monthSelected": "monthSelected"; "viewChanged": "viewChanged"; "_userSelection": "_userSelection"; "_userDragDrop": "_userDragDrop"; }, never, never, true, never>;
 }
 
+/**
+ * An event used for datepicker input and change events. We don't always have access to a native
+ * input or change event because the event may have been triggered by the user clicking on the
+ * calendar popup. For consistency, we always use MatDatepickerInputEvent instead.
+ */
+declare class MatDatepickerInputEvent<D, S = unknown> {
+    /** Reference to the datepicker input component that emitted the event. */
+    target: MatDatepickerInputBase<S, D>;
+    /** Reference to the native input element associated with the datepicker input. */
+    targetElement: HTMLElement;
+    /** The new value for the target datepicker input. */
+    value: D | null;
+    constructor(
+    /** Reference to the datepicker input component that emitted the event. */
+    target: MatDatepickerInputBase<S, D>, 
+    /** Reference to the native input element associated with the datepicker input. */
+    targetElement: HTMLElement);
+}
+/**
+ * Function that can be used to filter out dates from a calendar.
+ * Datepicker can sometimes receive a null value as input for the date argument.
+ * This doesn't represent a "null date" but rather signifies that no date has been selected yet in the calendar.
+ */
+type DateFilterFn<D> = (date: D | null) => boolean;
 /** Base class for datepicker inputs. */
 declare abstract class MatDatepickerInputBase<S, D = ExtractDateTypeFromSelection<S>> implements ControlValueAccessor, AfterViewInit, OnChanges, OnDestroy, Validator {
     protected _elementRef: ElementRef<HTMLInputElement>;
-    _dateAdapter: DateAdapter<D, any>;
+    _dateAdapter: DateAdapter$1<D, any>;
     private _dateFormats;
     /** Whether the component has been initialized. */
     private _isInitialized;
@@ -1052,7 +988,7 @@ declare abstract class MatDatepickerInputBase<S, D = ExtractDateTypeFromSelectio
     registerOnTouched(fn: () => void): void;
     setDisabledState(isDisabled: boolean): void;
     _onKeydown(event: KeyboardEvent): void;
-    _onInput(value: string): void;
+    _onInput(event: Event): void;
     _onChange(): void;
     /** Handles blur events on the input. */
     _onBlur(): void;
@@ -1076,86 +1012,116 @@ declare abstract class MatDatepickerInputBase<S, D = ExtractDateTypeFromSelectio
     static ngAcceptInputType_disabled: unknown;
 }
 
+/** Injection token that determines the scroll handling while the calendar is open. */
+declare const MAT_DATEPICKER_SCROLL_STRATEGY: InjectionToken<() => ScrollStrategy>;
 /**
- * An event used for datepicker input and change events. We don't always have access to a native
- * input or change event because the event may have been triggered by the user clicking on the
- * calendar popup. For consistency, we always use MatDatepickerInputEvent instead.
+ * @docs-private
+ * @deprecated No longer used, will be removed.
+ * @breaking-change 21.0.0
  */
-export declare class MatDatepickerInputEvent<D, S = unknown> {
-    /** Reference to the datepicker input component that emitted the event. */
-    target: MatDatepickerInputBase<S, D>;
-    /** Reference to the native input element associated with the datepicker input. */
-    targetElement: HTMLElement;
-    /** The new value for the target datepicker input. */
-    value: D | null;
-    constructor(
-    /** Reference to the datepicker input component that emitted the event. */
-    target: MatDatepickerInputBase<S, D>, 
-    /** Reference to the native input element associated with the datepicker input. */
-    targetElement: HTMLElement);
-}
-
-/** Datepicker data that requires internationalization. */
-export declare class MatDatepickerIntl {
-    /**
-     * Stream that emits whenever the labels here are changed. Use this to notify
-     * components if the labels have changed after initialization.
-     */
-    readonly changes: Subject<void>;
-    /** A label for the calendar popup (used by screen readers). */
-    calendarLabel: string;
-    /** A label for the button used to open the calendar popup (used by screen readers). */
-    openCalendarLabel: string;
-    /** Label for the button used to close the calendar popup. */
-    closeCalendarLabel: string;
-    /** A label for the previous month button (used by screen readers). */
-    prevMonthLabel: string;
-    /** A label for the next month button (used by screen readers). */
-    nextMonthLabel: string;
-    /** A label for the previous year button (used by screen readers). */
-    prevYearLabel: string;
-    /** A label for the next year button (used by screen readers). */
-    nextYearLabel: string;
-    /** A label for the previous multi-year button (used by screen readers). */
-    prevMultiYearLabel: string;
-    /** A label for the next multi-year button (used by screen readers). */
-    nextMultiYearLabel: string;
-    /** A label for the 'switch to month view' button (used by screen readers). */
-    switchToMonthViewLabel: string;
-    /** A label for the 'switch to year view' button (used by screen readers). */
-    switchToMultiYearViewLabel: string;
-    /**
-     * A label for the first date of a range of dates (used by screen readers).
-     * @deprecated Provide your own internationalization string.
-     * @breaking-change 17.0.0
-     */
-    startDateLabel: string;
+declare function MAT_DATEPICKER_SCROLL_STRATEGY_FACTORY(overlay: Overlay): () => ScrollStrategy;
+/** Possible positions for the datepicker dropdown along the X axis. */
+type DatepickerDropdownPositionX = 'start' | 'end';
+/** Possible positions for the datepicker dropdown along the Y axis. */
+type DatepickerDropdownPositionY = 'above' | 'below';
+/**
+ * @docs-private
+ * @deprecated No longer used, will be removed.
+ * @breaking-change 21.0.0
+ */
+declare const MAT_DATEPICKER_SCROLL_STRATEGY_FACTORY_PROVIDER: {
+    provide: InjectionToken<() => ScrollStrategy>;
+    deps: (typeof Overlay)[];
+    useFactory: typeof MAT_DATEPICKER_SCROLL_STRATEGY_FACTORY;
+};
+/**
+ * Component used as the content for the datepicker overlay. We use this instead of using
+ * MatCalendar directly as the content so we can control the initial focus. This also gives us a
+ * place to put additional features of the overlay that are not part of the calendar itself in the
+ * future. (e.g. confirmation buttons).
+ * @docs-private
+ */
+declare class MatDatepickerContent<S, D = ExtractDateTypeFromSelection<S>> implements AfterViewInit, OnDestroy {
+    protected _elementRef: ElementRef<HTMLElement>;
+    protected _animationsDisabled: boolean;
+    private _changeDetectorRef;
+    private _globalModel;
+    private _dateAdapter;
+    private _ngZone;
+    private _rangeSelectionStrategy;
+    private _stateChanges;
+    private _model;
+    private _eventCleanups;
+    private _animationFallback;
+    /** Reference to the internal calendar component. */
+    _calendar: MatCalendar<D>;
     /**
-     * A label for the last date of a range of dates (used by screen readers).
-     * @deprecated Provide your own internationalization string.
-     * @breaking-change 17.0.0
+     * Theme color of the internal calendar. 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/datepicker/styling.
+     *
+     * For information on applying color variants in M3, see
+     * https://material.angular.io/guide/material-2-theming#optional-add-backwards-compatibility-styles-for-color-variants
      */
-    endDateLabel: string;
+    color: ThemePalette;
+    /** Reference to the datepicker that created the overlay. */
+    datepicker: MatDatepickerBase<any, S, D>;
+    /** Start of the comparison range. */
+    comparisonStart: D | null;
+    /** End of the comparison range. */
+    comparisonEnd: D | null;
+    /** ARIA Accessible name of the `<input matStartDate/>` */
+    startDateAccessibleName: string | null;
+    /** ARIA Accessible name of the `<input matEndDate/>` */
+    endDateAccessibleName: string | null;
+    /** Whether the datepicker is above or below the input. */
+    _isAbove: boolean;
+    /** Emits when an animation has finished. */
+    readonly _animationDone: Subject<void>;
+    /** Whether there is an in-progress animation. */
+    _isAnimating: boolean;
+    /** Text for the close button. */
+    _closeButtonText: string;
+    /** Whether the close button currently has focus. */
+    _closeButtonFocused: boolean;
+    /** Portal with projected action buttons. */
+    _actionsPortal: TemplatePortal | null;
+    /** Id of the label for the `role="dialog"` element. */
+    _dialogLabelId: string | null;
+    constructor(...args: unknown[]);
+    ngAfterViewInit(): void;
+    ngOnDestroy(): void;
+    _handleUserSelection(event: MatCalendarUserEvent<D | null>): void;
+    _handleUserDragDrop(event: MatCalendarUserEvent<DateRange<D>>): void;
+    _startExitAnimation(): void;
+    private _handleAnimationEvent;
+    _getSelected(): D | DateRange<D> | null;
+    /** Applies the current pending selection to the global model. */
+    _applyPendingSelection(): void;
     /**
-     * A label for the Comparison date of a range of dates (used by screen readers).
+     * Assigns a new portal containing the datepicker actions.
+     * @param portal Portal with the actions to be assigned.
+     * @param forceRerender Whether a re-render of the portal should be triggered. This isn't
+     * necessary if the portal is assigned during initialization, but it may be required if it's
+     * added at a later point.
      */
-    comparisonDateLabel: string;
-    /** Formats a range of years (used for visuals). */
-    formatYearRange(start: string, end: string): string;
-    /** Formats a label for a range of years (used by screen readers). */
-    formatYearRangeLabel(start: string, end: string): string;
-    static ɵfac: i0.ɵɵFactoryDeclaration<MatDatepickerIntl, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<MatDatepickerIntl>;
+    _assignActions(portal: TemplatePortal<any> | null, forceRerender: boolean): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatDatepickerContent<any, any>, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MatDatepickerContent<any, any>, "mat-datepicker-content", ["matDatepickerContent"], { "color": { "alias": "color"; "required": false; }; }, {}, never, never, true, never>;
 }
-
-export declare class MatDatepickerModule {
-    static ɵfac: i0.ɵɵFactoryDeclaration<MatDatepickerModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<MatDatepickerModule, never, [typeof i1.MatButtonModule, typeof i2.OverlayModule, typeof i3.A11yModule, typeof i4.PortalModule, typeof i5.MatCommonModule, typeof i6.MatCalendar, typeof i7.MatCalendarBody, typeof i8.MatDatepicker, typeof i9.MatDatepickerContent, typeof i10.MatDatepickerInput, typeof i11.MatDatepickerToggle, typeof i11.MatDatepickerToggleIcon, typeof i12.MatMonthView, typeof i13.MatYearView, typeof i14.MatMultiYearView, typeof i6.MatCalendarHeader, typeof i15.MatDateRangeInput, typeof i16.MatStartDate, typeof i16.MatEndDate, typeof i17.MatDateRangePicker, typeof i18.MatDatepickerActions, typeof i18.MatDatepickerCancel, typeof i18.MatDatepickerApply], [typeof i19.CdkScrollableModule, typeof i6.MatCalendar, typeof i7.MatCalendarBody, typeof i8.MatDatepicker, typeof i9.MatDatepickerContent, typeof i10.MatDatepickerInput, typeof i11.MatDatepickerToggle, typeof i11.MatDatepickerToggleIcon, typeof i12.MatMonthView, typeof i13.MatYearView, typeof i14.MatMultiYearView, typeof i6.MatCalendarHeader, typeof i15.MatDateRangeInput, typeof i16.MatStartDate, typeof i16.MatEndDate, typeof i17.MatDateRangePicker, typeof i18.MatDatepickerActions, typeof i18.MatDatepickerCancel, typeof i18.MatDatepickerApply]>;
-    static ɵinj: i0.ɵɵInjectorDeclaration<MatDatepickerModule>;
+/** Form control that can be associated with a datepicker. */
+interface MatDatepickerControl<D> {
+    getStartValue(): D | null;
+    getThemePalette(): ThemePalette;
+    min: D | null;
+    max: D | null;
+    disabled: boolean;
+    dateFilter: DateFilterFn<D>;
+    getConnectedOverlayOrigin(): ElementRef;
+    getOverlayLabelId(): string | null;
+    stateChanges: Observable<void>;
 }
-
 /** A datepicker that can be attached to a {@link MatDatepickerControl}. */
-export declare interface MatDatepickerPanel<C extends MatDatepickerControl<D>, S, D = ExtractDateTypeFromSelection<S>> {
+interface MatDatepickerPanel<C extends MatDatepickerControl<D>, S, D = ExtractDateTypeFromSelection<S>> {
     /** Stream that emits whenever the date picker is closed. */
     closedStream: EventEmitter<void>;
     /**
@@ -1183,83 +1149,179 @@ export declare interface MatDatepickerPanel<C extends MatDatepickerControl<D>, S
     /** Register an input with the datepicker. */
     registerInput(input: C): MatDateSelectionModel<S, D>;
 }
-
-export declare class MatDatepickerToggle<D> implements AfterContentInit, OnChanges, OnDestroy {
-    _intl: MatDatepickerIntl;
-    private _changeDetectorRef;
-    private _stateChanges;
-    /** Datepicker instance that the button will toggle. */
-    datepicker: MatDatepickerPanel<MatDatepickerControl<any>, D>;
-    /** Tabindex for the toggle. */
-    tabIndex: number | null;
-    /** Screen-reader label for the button. */
-    ariaLabel: string;
-    /** Whether the toggle button is disabled. */
+/** Base class for a datepicker. */
+declare abstract class MatDatepickerBase<C extends MatDatepickerControl<D>, S, D = ExtractDateTypeFromSelection<S>> implements MatDatepickerPanel<C, S, D>, OnDestroy, OnChanges {
+    private _overlay;
+    private _viewContainerRef;
+    private _dateAdapter;
+    private _dir;
+    private _model;
+    private _scrollStrategy;
+    private _inputStateChanges;
+    private _document;
+    /** An input indicating the type of the custom header component for the calendar, if set. */
+    calendarHeaderComponent: ComponentType<any>;
+    /** The date to open the calendar to initially. */
+    get startAt(): D | null;
+    set startAt(value: D | null);
+    private _startAt;
+    /** The view that the calendar should start in. */
+    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. 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/material-2-theming#optional-add-backwards-compatibility-styles-for-color-variants
+     */
+    get color(): ThemePalette;
+    set color(value: ThemePalette);
+    _color: ThemePalette;
+    /**
+     * Whether the calendar UI is in touch mode. In touch mode the calendar opens in a dialog rather
+     * than a dropdown and elements have more padding to allow for bigger touch targets.
+     */
+    touchUi: boolean;
+    /** Whether the datepicker pop-up should be disabled. */
     get disabled(): boolean;
     set disabled(value: boolean);
     private _disabled;
-    /** Whether ripples on the toggle should be disabled. */
-    disableRipple: boolean;
-    /** Custom icon set by the consumer. */
-    _customIcon: MatDatepickerToggleIcon;
-    /** Underlying button element. */
-    _button: MatButton;
+    /** Preferred position of the datepicker in the X axis. */
+    xPosition: DatepickerDropdownPositionX;
+    /** Preferred position of the datepicker in the Y axis. */
+    yPosition: DatepickerDropdownPositionY;
+    /**
+     * Whether to restore focus to the previously-focused element when the calendar is closed.
+     * Note that automatic focus restoration is an accessibility feature and it is recommended that
+     * you provide your own equivalent, if you decide to turn it off.
+     */
+    restoreFocus: boolean;
+    /**
+     * Emits selected year in multiyear view.
+     * This doesn't imply a change on the selected date.
+     */
+    readonly yearSelected: EventEmitter<D>;
+    /**
+     * Emits selected month in year view.
+     * This doesn't imply a change on the selected date.
+     */
+    readonly monthSelected: EventEmitter<D>;
+    /**
+     * Emits when the current view changes.
+     */
+    readonly viewChanged: EventEmitter<MatCalendarView>;
+    /** Function that can be used to add custom CSS classes to dates. */
+    dateClass: MatCalendarCellClassFunction<D>;
+    /** Emits when the datepicker has been opened. */
+    readonly openedStream: EventEmitter<void>;
+    /** Emits when the datepicker has been closed. */
+    readonly closedStream: EventEmitter<void>;
+    /** Classes to be passed to the date picker panel. */
+    get panelClass(): string | string[];
+    set panelClass(value: string | string[]);
+    private _panelClass;
+    /** Whether the calendar is open. */
+    get opened(): boolean;
+    set opened(value: boolean);
+    private _opened;
+    /** The id for the datepicker calendar. */
+    id: string;
+    /** The minimum selectable date. */
+    _getMinDate(): D | null;
+    /** The maximum selectable date. */
+    _getMaxDate(): D | null;
+    _getDateFilter(): DateFilterFn<D>;
+    /** A reference to the overlay into which we've rendered the calendar. */
+    private _overlayRef;
+    /** Reference to the component instance rendered in the overlay. */
+    private _componentRef;
+    /** The element that was focused before the datepicker was opened. */
+    private _focusedElementBeforeOpen;
+    /** Unique class that will be added to the backdrop so that the test harnesses can look it up. */
+    private _backdropHarnessClass;
+    /** Currently-registered actions portal. */
+    private _actionsPortal;
+    /** The input element this datepicker is associated with. */
+    datepickerInput: C;
+    /** Emits when the datepicker's state changes. */
+    readonly stateChanges: Subject<void>;
+    private _injector;
+    private readonly _changeDetectorRef;
     constructor(...args: unknown[]);
     ngOnChanges(changes: SimpleChanges): void;
     ngOnDestroy(): void;
-    ngAfterContentInit(): void;
-    _open(event: Event): void;
-    private _watchStateChanges;
-    static ɵfac: i0.ɵɵFactoryDeclaration<MatDatepickerToggle<any>, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<MatDatepickerToggle<any>, "mat-datepicker-toggle", ["matDatepickerToggle"], { "datepicker": { "alias": "for"; "required": false; }; "tabIndex": { "alias": "tabIndex"; "required": false; }; "ariaLabel": { "alias": "aria-label"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "disableRipple": { "alias": "disableRipple"; "required": false; }; }, {}, ["_customIcon"], ["[matDatepickerToggleIcon]"], true, never>;
+    /** Selects the given date */
+    select(date: D): void;
+    /** Emits the selected year in multiyear view */
+    _selectYear(normalizedYear: D): void;
+    /** Emits selected month in year view */
+    _selectMonth(normalizedMonth: D): void;
+    /** Emits changed view */
+    _viewChanged(view: MatCalendarView): void;
+    /**
+     * Register an input with this datepicker.
+     * @param input The datepicker input to register with this datepicker.
+     * @returns Selection model that the input should hook itself up to.
+     */
+    registerInput(input: C): MatDateSelectionModel<S, D>;
+    /**
+     * Registers a portal containing action buttons with the datepicker.
+     * @param portal Portal to be registered.
+     */
+    registerActions(portal: TemplatePortal): void;
+    /**
+     * Removes a portal containing action buttons from the datepicker.
+     * @param portal Portal to be removed.
+     */
+    removeActions(portal: TemplatePortal): void;
+    /** Open the calendar. */
+    open(): void;
+    /** Close the calendar. */
+    close(): void;
+    /** Applies the current pending selection on the overlay to the model. */
+    _applyPendingSelection(): void;
+    /** Forwards relevant values from the datepicker to the datepicker content inside the overlay. */
+    protected _forwardContentValues(instance: MatDatepickerContent<S, D>): void;
+    /** Opens the overlay with the calendar. */
+    private _openOverlay;
+    /** Destroys the current overlay. */
+    private _destroyOverlay;
+    /** Gets a position strategy that will open the calendar as a dropdown. */
+    private _getDialogStrategy;
+    /** Gets a position strategy that will open the calendar as a dropdown. */
+    private _getDropdownStrategy;
+    /** Sets the positions of the datepicker in dropdown mode based on the current configuration. */
+    private _setConnectedPositions;
+    /** Gets an observable that will emit when the overlay is supposed to be closed. */
+    private _getCloseStream;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatDatepickerBase<any, any, any>, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MatDatepickerBase<any, any, any>, never, never, { "calendarHeaderComponent": { "alias": "calendarHeaderComponent"; "required": false; }; "startAt": { "alias": "startAt"; "required": false; }; "startView": { "alias": "startView"; "required": false; }; "color": { "alias": "color"; "required": false; }; "touchUi": { "alias": "touchUi"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "xPosition": { "alias": "xPosition"; "required": false; }; "yPosition": { "alias": "yPosition"; "required": false; }; "restoreFocus": { "alias": "restoreFocus"; "required": false; }; "dateClass": { "alias": "dateClass"; "required": false; }; "panelClass": { "alias": "panelClass"; "required": false; }; "opened": { "alias": "opened"; "required": false; }; }, { "yearSelected": "yearSelected"; "monthSelected": "monthSelected"; "viewChanged": "viewChanged"; "openedStream": "opened"; "closedStream": "closed"; }, never, never, true, never>;
+    static ngAcceptInputType_touchUi: unknown;
     static ngAcceptInputType_disabled: unknown;
+    static ngAcceptInputType_restoreFocus: unknown;
+    static ngAcceptInputType_opened: unknown;
 }
 
-/** Can be used to override the icon of a `matDatepickerToggle`. */
-export declare class MatDatepickerToggleIcon {
-    static ɵfac: i0.ɵɵFactoryDeclaration<MatDatepickerToggleIcon, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<MatDatepickerToggleIcon, "[matDatepickerToggleIcon]", never, {}, {}, never, never, true, never>;
+/** Component responsible for managing the datepicker popup/dialog. */
+declare class MatDatepicker<D> extends MatDatepickerBase<MatDatepickerControl<D>, D | null, D> {
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatDatepicker<any>, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MatDatepicker<any>, "mat-datepicker", ["matDatepicker"], {}, {}, never, never, true, never>;
 }
 
-export declare class MatDateRangeInput<D> implements MatFormFieldControl<DateRange<D>>, MatDatepickerControl<D>, MatDateRangePickerInput<D>, AfterContentInit, OnChanges, OnDestroy {
-    private _changeDetectorRef;
-    private _elementRef;
-    private _dateAdapter;
+/** @docs-private */
+declare const MAT_DATEPICKER_VALUE_ACCESSOR: any;
+/** @docs-private */
+declare const MAT_DATEPICKER_VALIDATORS: any;
+/** Directive used to connect an input to a MatDatepicker. */
+declare class MatDatepickerInput<D> extends MatDatepickerInputBase<D | null, D> implements MatDatepickerControl<D | null>, OnDestroy {
     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. */
-    id: string;
-    /** Whether the control is focused. */
-    focused: boolean;
-    /** Whether the control's label should float. */
-    get shouldLabelFloat(): boolean;
-    /** Name of the form control. */
-    controlType: string;
-    /**
-     * Implemented as a part of `MatFormFieldControl`.
-     * Set the placeholder attribute on `matStartDate` and `matEndDate`.
-     * @docs-private
-     */
-    get placeholder(): string;
-    /** The range picker that this input is associated with. */
-    get rangePicker(): MatDatepickerPanel<MatDatepickerControl<D>, DateRange<D>, D>;
-    set rangePicker(rangePicker: MatDatepickerPanel<MatDatepickerControl<D>, DateRange<D>, D>);
-    private _rangePicker;
+    /** The datepicker that this input is associated with. */
+    set matDatepicker(datepicker: MatDatepickerPanel<MatDatepickerControl<D>, D | null, D>);
+    _datepicker: MatDatepickerPanel<MatDatepickerControl<D>, D | null, D>;
     /** The id of the panel owned by this input. */
-    _ariaOwns: WritableSignal<string | null>;
-    /** Whether the input is required. */
-    get required(): boolean;
-    set required(value: boolean);
-    private _required;
-    /** Function that can be used to filter out dates within the date range picker. */
-    get dateFilter(): DateFilterFn<D>;
-    set dateFilter(value: DateFilterFn<D>);
-    private _dateFilter;
+    protected _ariaOwns: i0.WritableSignal<string | null>;
     /** The minimum valid date. */
     get min(): D | null;
     set min(value: D | null);
@@ -1268,666 +1330,454 @@ export declare class MatDateRangeInput<D> implements MatFormFieldControl<DateRan
     get max(): D | null;
     set max(value: D | null);
     private _max;
-    /** Whether the input is disabled. */
-    get disabled(): boolean;
-    set disabled(value: boolean);
-    _groupDisabled: boolean;
-    /** Whether the input is in an error state. */
-    get errorState(): boolean;
-    /** Whether the datepicker input is empty. */
-    get empty(): boolean;
-    /** Value for the `aria-describedby` attribute of the inputs. */
-    _ariaDescribedBy: string | null;
-    /** Date selection model currently registered with the input. */
-    private _model;
-    /** Separator text to be shown between the inputs. */
-    separator: string;
-    /** Start of the comparison range that should be shown in the calendar. */
-    comparisonStart: D | null;
-    /** End of the comparison range that should be shown in the calendar. */
-    comparisonEnd: D | null;
-    /**
-     * Implemented as a part of `MatFormFieldControl`.
-     * TODO(crisbeto): change type to `AbstractControlDirective` after #18206 lands.
-     * @docs-private
-     */
-    ngControl: NgControl | null;
-    /** Emits when the input's state has changed. */
-    readonly stateChanges: Subject<void>;
-    /**
-     * Disable the automatic labeling to avoid issues like #27241.
-     * @docs-private
-     */
-    readonly disableAutomaticLabeling = true;
-    constructor(...args: unknown[]);
-    /**
-     * Implemented as a part of `MatFormFieldControl`.
-     * @docs-private
-     */
-    setDescribedByIds(ids: string[]): void;
-    /**
-     * Implemented as a part of `MatFormFieldControl`.
-     * @docs-private
-     */
-    onContainerClick(): void;
-    ngAfterContentInit(): void;
-    ngOnChanges(changes: SimpleChanges): void;
-    ngOnDestroy(): void;
-    /** Gets the date at which the calendar should start. */
-    getStartValue(): D | null;
-    /** Gets the input's theme palette. */
-    getThemePalette(): ThemePalette;
-    /** Gets the element to which the calendar overlay should be attached. */
-    getConnectedOverlayOrigin(): ElementRef;
-    /** Gets the ID of an element that should be used a description for the calendar overlay. */
-    getOverlayLabelId(): string | null;
-    /** Gets the value that is used to mirror the state input. */
-    _getInputMirrorValue(part: 'start' | 'end'): string;
-    /** Whether the input placeholders should be hidden. */
-    _shouldHidePlaceholders(): boolean;
-    /** Handles the value in one of the child inputs changing. */
-    _handleChildValueChange(): void;
-    /** Opens the date range picker associated with the input. */
-    _openDatepicker(): void;
-    /** Whether the separate text should be hidden. */
-    _shouldHideSeparator(): boolean | "" | null;
-    /** Gets the value for the `aria-labelledby` attribute of the inputs. */
-    _getAriaLabelledby(): string | null;
-    _getStartDateAccessibleName(): string;
-    _getEndDateAccessibleName(): string;
-    /** Updates the focused state of the range input. */
-    _updateFocus(origin: FocusOrigin): void;
-    /** Re-runs the validators on the start/end inputs. */
-    private _revalidate;
-    /** Registers the current date selection model with the start/end inputs. */
-    private _registerModel;
-    /** 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; }; }, {}, never, ["input[matStartDate]", "input[matEndDate]"], true, never>;
-    static ngAcceptInputType_required: unknown;
-    static ngAcceptInputType_disabled: unknown;
-}
-
-/**
- * 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, AfterContentInit, DoCheck {
-    _rangeInput: MatDateRangeInput<D>;
-    _elementRef: ElementRef<HTMLInputElement>;
-    _defaultErrorStateMatcher: ErrorStateMatcher;
-    private _injector;
-    _parentForm: NgForm | null;
-    _parentFormGroup: FormGroupDirective | null;
-    /**
-     * Form control bound to this input part.
-     * @docs-private
-     */
-    ngControl: NgControl;
-    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. */
-    get errorStateMatcher(): ErrorStateMatcher;
-    set errorStateMatcher(value: ErrorStateMatcher);
-    /** Whether the input is in an error state. */
-    get errorState(): boolean;
-    set errorState(value: boolean);
+    /** Function that can be used to filter out dates within the datepicker. */
+    get dateFilter(): DateFilterFn<D | null>;
+    set dateFilter(value: DateFilterFn<D | null>);
+    private _dateFilter;
+    /** The combined form control validator for this input. */
+    protected _validator: ValidatorFn | null;
     constructor(...args: unknown[]);
-    ngOnInit(): void;
-    ngAfterContentInit(): void;
-    ngDoCheck(): void;
-    /** Gets whether the input is empty. */
-    isEmpty(): boolean;
-    /** Gets the placeholder of the input. */
-    _getPlaceholder(): string;
-    /** Focuses the input. */
-    focus(): void;
-    /** Gets the value that should be used when mirroring the input's size. */
-    getMirrorValue(): string;
-    /** Refreshes the error state of the input. */
-    updateErrorState(): void;
-    /** Handles `input` events on the input element. */
-    _onInput(value: string): void;
-    /** Opens the datepicker associated with the input. */
-    protected _openPopup(): void;
-    /** Gets the minimum date from the range input. */
-    _getMinDate(): D | null;
-    /** Gets the maximum date from the range input. */
-    _getMaxDate(): D | null;
-    /** Gets the date filter function from the range input. */
-    protected _getDateFilter(): DateFilterFn<D>;
-    protected _parentDisabled(): boolean;
-    protected _shouldHandleChangeEvent({ source }: DateSelectionModelChange<DateRange<D>>): boolean;
-    protected _assignValueProgrammatically(value: D | null): void;
-    protected _formatValue(value: D | null): void;
-    /** return the ARIA accessible name of the input element */
-    _getAccessibleName(): string;
-    static ɵfac: i0.ɵɵFactoryDeclaration<MatDateRangeInputPartBase<any>, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<MatDateRangeInputPartBase<any>, never, never, { "errorStateMatcher": { "alias": "errorStateMatcher"; "required": false; }; }, {}, never, never, true, never>;
-}
-
-/** Component responsible for managing the date range picker popup/dialog. */
-export declare class MatDateRangePicker<D> extends MatDatepickerBase<MatDateRangePickerInput<D>, DateRange<D>, D> {
-    protected _forwardContentValues(instance: MatDatepickerContent<DateRange<D>, D>): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<MatDateRangePicker<any>, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<MatDateRangePicker<any>, "mat-date-range-picker", ["matDateRangePicker"], {}, {}, never, never, true, never>;
-}
-
-/**
- * Input that can be associated with a date range picker.
- * @docs-private
- */
-declare interface MatDateRangePickerInput<D> extends MatDatepickerControl<D> {
-    _getEndDateAccessibleName(): string | null;
-    _getStartDateAccessibleName(): string | null;
-    comparisonStart: D | null;
-    comparisonEnd: D | null;
-}
-
-/** Object that can be provided in order to customize the date range selection behavior. */
-export declare interface MatDateRangeSelectionStrategy<D> {
-    /**
-     * Called when the user has finished selecting a value.
-     * @param date Date that was selected. Will be null if the user cleared the selection.
-     * @param currentRange Range that is currently show in the calendar.
-     * @param event DOM event that triggered the selection. Currently only corresponds to a `click`
-     *    event, but it may get expanded in the future.
-     */
-    selectionFinished(date: D | null, currentRange: DateRange<D>, event: Event): DateRange<D>;
-    /**
-     * Called when the user has activated a new date (e.g. by hovering over
-     * it or moving focus) and the calendar tries to display a date range.
-     *
-     * @param activeDate Date that the user has activated. Will be null if the user moved
-     *    focus to an element that's no a calendar cell.
-     * @param currentRange Range that is currently shown in the calendar.
-     * @param event DOM event that caused the preview to be changed. Will be either a
-     *    `mouseenter`/`mouseleave` or `focus`/`blur` depending on how the user is navigating.
-     */
-    createPreview(activeDate: D | null, currentRange: DateRange<D>, event: Event): DateRange<D>;
-    /**
-     * Called when the user has dragged a date in the currently selected range to another
-     * date. Returns the date updated range that should result from this interaction.
-     *
-     * @param dateOrigin The date the user started dragging from.
-     * @param originalRange The originally selected date range.
-     * @param newDate The currently targeted date in the drag operation.
-     * @param event DOM event that triggered the updated drag state. Will be
-     *     `mouseenter`/`mouseup` or `touchmove`/`touchend` depending on the device type.
-     */
-    createDrag?(dragOrigin: D, originalRange: DateRange<D>, newDate: D, event: Event): DateRange<D> | null;
-}
-
-/**
- * A selection model containing a date selection.
- * @docs-private
- */
-export declare abstract class MatDateSelectionModel<S, D = ExtractDateTypeFromSelection<S>> implements OnDestroy {
-    /** The current selection. */
-    readonly selection: S;
-    protected _adapter: DateAdapter<D>;
-    private readonly _selectionChanged;
-    /** Emits when the selection has changed. */
-    selectionChanged: Observable<DateSelectionModelChange<S>>;
-    protected constructor(
-    /** The current selection. */
-    selection: S, _adapter: DateAdapter<D>);
     /**
-     * Updates the current selection in the model.
-     * @param value New selection that should be assigned.
-     * @param source Object that triggered the selection change.
+     * Gets the element that the datepicker popup should be connected to.
+     * @return The element to connect the popup to.
      */
-    updateSelection(value: S, source: unknown): void;
+    getConnectedOverlayOrigin(): ElementRef;
+    /** Gets the ID of an element that should be used a description for the calendar overlay. */
+    getOverlayLabelId(): string | null;
+    /** Returns the palette used by the input's form field, if any. */
+    getThemePalette(): ThemePalette;
+    /** Gets the value at which the calendar should start. */
+    getStartValue(): D | null;
     ngOnDestroy(): void;
-    protected _isValidDateInstance(date: D): boolean;
-    /** Adds a date to the current selection. */
-    abstract add(date: D | null): void;
-    /** Checks whether the current selection is valid. */
-    abstract isValid(): boolean;
-    /** Checks whether the current selection is complete. */
-    abstract isComplete(): boolean;
-    /** Clones the selection model. */
-    abstract clone(): MatDateSelectionModel<S, D>;
-    static ɵfac: i0.ɵɵFactoryDeclaration<MatDateSelectionModel<any, any>, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<MatDateSelectionModel<any, any>>;
-}
-
-/** Input for entering the end date in a `mat-date-range-input`. */
-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;
+    /** Opens the associated datepicker. */
+    protected _openPopup(): void;
+    protected _getValueFromModel(modelValue: D | null): D | null;
     protected _assignValueToModel(value: D | null): void;
-    private _moveCaretToEndOfStartInput;
-    _onKeydown(event: KeyboardEvent): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<MatEndDate<any>, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<MatEndDate<any>, "input[matEndDate]", never, {}, { "dateChange": "dateChange"; "dateInput": "dateInput"; }, never, never, true, never>;
+    /** Gets the input's minimum date. */
+    _getMinDate(): D | null;
+    /** Gets the input's maximum date. */
+    _getMaxDate(): D | null;
+    /** Gets the input's date filtering function. */
+    protected _getDateFilter(): DateFilterFn<D | null>;
+    protected _shouldHandleChangeEvent(event: DateSelectionModelChange<D>): boolean;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatDatepickerInput<any>, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MatDatepickerInput<any>, "input[matDatepicker]", ["matDatepickerInput"], { "matDatepicker": { "alias": "matDatepicker"; "required": false; }; "min": { "alias": "min"; "required": false; }; "max": { "alias": "max"; "required": false; }; "dateFilter": { "alias": "matDatepickerFilter"; "required": false; }; }, {}, never, never, true, never>;
 }
 
-/**
- * An internal component used to display a single month in the datepicker.
- * @docs-private
- */
-export declare class MatMonthView<D> implements AfterContentInit, OnChanges, OnDestroy {
-    readonly _changeDetectorRef: ChangeDetectorRef;
-    private _dateFormats;
-    _dateAdapter: DateAdapter<D, any>;
-    private _dir;
-    private _rangeStrategy;
-    private _rerenderSubscription;
-    /** Flag used to filter out space/enter keyup events that originated outside of the view. */
-    private _selectionKeyPressed;
-    /**
-     * The date to display in this month view (everything other than the month and year is ignored).
-     */
-    get activeDate(): D;
-    set activeDate(value: D);
-    private _activeDate;
-    /** The currently selected date. */
-    get selected(): DateRange<D> | D | null;
-    set selected(value: DateRange<D> | D | null);
-    private _selected;
-    /** The minimum selectable date. */
-    get minDate(): D | null;
-    set minDate(value: D | null);
-    private _minDate;
-    /** The maximum selectable date. */
-    get maxDate(): D | null;
-    set maxDate(value: D | null);
-    private _maxDate;
-    /** Function used to filter which dates are selectable. */
-    dateFilter: (date: D) => boolean;
-    /** Function that can be used to add custom CSS classes to dates. */
-    dateClass: MatCalendarCellClassFunction<D>;
-    /** Start of the comparison range. */
-    comparisonStart: D | null;
-    /** End of the comparison range. */
-    comparisonEnd: D | null;
-    /** ARIA Accessible name of the `<input matStartDate/>` */
-    startDateAccessibleName: string | null;
-    /** ARIA Accessible name of the `<input matEndDate/>` */
-    endDateAccessibleName: string | null;
-    /** Origin of active drag, or null when dragging is not active. */
-    activeDrag: MatCalendarUserEvent<D> | null;
-    /** Emits when a new date is selected. */
-    readonly selectedChange: EventEmitter<D | null>;
-    /** Emits when any date is selected. */
-    readonly _userSelection: EventEmitter<MatCalendarUserEvent<D | null>>;
-    /** Emits when the user initiates a date range drag via mouse or touch. */
-    readonly dragStarted: EventEmitter<MatCalendarUserEvent<D>>;
-    /**
-     * Emits when the user completes or cancels a date range drag.
-     * Emits null when the drag was canceled or the newly selected date range if completed.
-     */
-    readonly dragEnded: EventEmitter<MatCalendarUserEvent<DateRange<D> | null>>;
-    /** Emits when any date is activated. */
-    readonly activeDateChange: EventEmitter<D>;
-    /** The body of calendar table */
-    _matCalendarBody: MatCalendarBody;
-    /** The label for this month (e.g. "January 2017"). */
-    _monthLabel: string;
-    /** Grid of calendar cells representing the dates of the month. */
-    _weeks: MatCalendarCell[][];
-    /** The number of blank cells in the first row before the 1st of the month. */
-    _firstWeekOffset: number;
-    /** Start value of the currently-shown date range. */
-    _rangeStart: number | null;
-    /** End value of the currently-shown date range. */
-    _rangeEnd: number | null;
-    /** Start value of the currently-shown comparison date range. */
-    _comparisonRangeStart: number | null;
-    /** End value of the currently-shown comparison date range. */
-    _comparisonRangeEnd: number | null;
-    /** Start of the preview range. */
-    _previewStart: number | null;
-    /** End of the preview range. */
-    _previewEnd: number | null;
-    /** Whether the user is currently selecting a range of dates. */
-    _isRange: boolean;
-    /** The date of the month that today falls on. Null if today is in another month. */
-    _todayDate: number | null;
-    /** The names of the weekdays. */
-    _weekdays: {
-        long: string;
-        narrow: string;
-        id: number;
-    }[];
-    constructor(...args: unknown[]);
-    ngAfterContentInit(): void;
-    ngOnChanges(changes: SimpleChanges): void;
-    ngOnDestroy(): void;
-    /** Handles when a new date is selected. */
-    _dateSelected(event: MatCalendarUserEvent<number>): void;
+/** Datepicker data that requires internationalization. */
+declare class MatDatepickerIntl {
     /**
-     * Takes the index of a calendar body cell wrapped in an event as argument. For the date that
-     * corresponds to the given cell, set `activeDate` to that date and fire `activeDateChange` with
-     * that date.
-     *
-     * This function is used to match each component's model of the active date with the calendar
-     * body cell that was focused. It updates its value of `activeDate` synchronously and updates the
-     * parent's value asynchronously via the `activeDateChange` event. The child component receives an
-     * updated value asynchronously via the `activeCell` Input.
+     * Stream that emits whenever the labels here are changed. Use this to notify
+     * components if the labels have changed after initialization.
      */
-    _updateActiveDate(event: MatCalendarUserEvent<number>): void;
-    /** Handles keydown events on the calendar body when calendar is in month view. */
-    _handleCalendarBodyKeydown(event: KeyboardEvent): void;
-    /** Handles keyup events on the calendar body when calendar is in month view. */
-    _handleCalendarBodyKeyup(event: KeyboardEvent): void;
-    /** Initializes this month view. */
-    _init(): void;
-    /** Focuses the active cell after the microtask queue is empty. */
-    _focusActiveCell(movePreview?: boolean): void;
-    /** Focuses the active cell after change detection has run and the microtask queue is empty. */
-    _focusActiveCellAfterViewChecked(): void;
-    /** Called when the user has activated a new cell and the preview needs to be updated. */
-    _previewChanged({ event, value: cell }: MatCalendarUserEvent<MatCalendarCell<D> | null>): void;
+    readonly changes: Subject<void>;
+    /** A label for the calendar popup (used by screen readers). */
+    calendarLabel: string;
+    /** A label for the button used to open the calendar popup (used by screen readers). */
+    openCalendarLabel: string;
+    /** Label for the button used to close the calendar popup. */
+    closeCalendarLabel: string;
+    /** A label for the previous month button (used by screen readers). */
+    prevMonthLabel: string;
+    /** A label for the next month button (used by screen readers). */
+    nextMonthLabel: string;
+    /** A label for the previous year button (used by screen readers). */
+    prevYearLabel: string;
+    /** A label for the next year button (used by screen readers). */
+    nextYearLabel: string;
+    /** A label for the previous multi-year button (used by screen readers). */
+    prevMultiYearLabel: string;
+    /** A label for the next multi-year button (used by screen readers). */
+    nextMultiYearLabel: string;
+    /** A label for the 'switch to month view' button (used by screen readers). */
+    switchToMonthViewLabel: string;
+    /** A label for the 'switch to year view' button (used by screen readers). */
+    switchToMultiYearViewLabel: string;
     /**
-     * Called when the user has ended a drag. If the drag/drop was successful,
-     * computes and emits the new range selection.
+     * A label for the first date of a range of dates (used by screen readers).
+     * @deprecated Provide your own internationalization string.
+     * @breaking-change 17.0.0
      */
-    protected _dragEnded(event: MatCalendarUserEvent<D | null>): void;
+    startDateLabel: string;
     /**
-     * Takes a day of the month and returns a new date in the same month and year as the currently
-     *  active date. The returned date will have the same day of the month as the argument date.
+     * A label for the last date of a range of dates (used by screen readers).
+     * @deprecated Provide your own internationalization string.
+     * @breaking-change 17.0.0
      */
-    private _getDateFromDayOfMonth;
-    /** Initializes the weekdays. */
-    private _initWeekdays;
-    /** Creates MatCalendarCells for the dates in this month. */
-    private _createWeekCells;
-    /** Date filter for the month */
-    private _shouldEnableDate;
+    endDateLabel: string;
     /**
-     * Gets the date in this month that the given Date falls on.
-     * Returns null if the given Date is in another month.
+     * A label for the Comparison date of a range of dates (used by screen readers).
      */
-    private _getDateInCurrentMonth;
-    /** Checks whether the 2 dates are non-null and fall within the same month of the same year. */
-    private _hasSameMonthAndYear;
-    /** Gets the value that will be used to one cell to another. */
-    private _getCellCompareValue;
-    /** Determines whether the user has the RTL layout direction. */
-    private _isRtl;
-    /** Sets the current range based on a model value. */
-    private _setRanges;
-    /** Gets whether a date can be selected in the month view. */
-    private _canSelect;
-    /** Clears out preview state. */
-    private _clearPreview;
-    static ɵfac: i0.ɵɵFactoryDeclaration<MatMonthView<any>, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<MatMonthView<any>, "mat-month-view", ["matMonthView"], { "activeDate": { "alias": "activeDate"; "required": false; }; "selected": { "alias": "selected"; "required": false; }; "minDate": { "alias": "minDate"; "required": false; }; "maxDate": { "alias": "maxDate"; "required": false; }; "dateFilter": { "alias": "dateFilter"; "required": false; }; "dateClass": { "alias": "dateClass"; "required": false; }; "comparisonStart": { "alias": "comparisonStart"; "required": false; }; "comparisonEnd": { "alias": "comparisonEnd"; "required": false; }; "startDateAccessibleName": { "alias": "startDateAccessibleName"; "required": false; }; "endDateAccessibleName": { "alias": "endDateAccessibleName"; "required": false; }; "activeDrag": { "alias": "activeDrag"; "required": false; }; }, { "selectedChange": "selectedChange"; "_userSelection": "_userSelection"; "dragStarted": "dragStarted"; "dragEnded": "dragEnded"; "activeDateChange": "activeDateChange"; }, never, never, true, never>;
+    comparisonDateLabel: string;
+    /** Formats a range of years (used for visuals). */
+    formatYearRange(start: string, end: string): string;
+    /** Formats a label for a range of years (used by screen readers). */
+    formatYearRangeLabel(start: string, end: string): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatDatepickerIntl, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<MatDatepickerIntl>;
+}
+
+/** Can be used to override the icon of a `matDatepickerToggle`. */
+declare class MatDatepickerToggleIcon {
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatDatepickerToggleIcon, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MatDatepickerToggleIcon, "[matDatepickerToggleIcon]", never, {}, {}, never, never, true, never>;
+}
+declare class MatDatepickerToggle<D> implements AfterContentInit, OnChanges, OnDestroy {
+    _intl: MatDatepickerIntl;
+    private _changeDetectorRef;
+    private _stateChanges;
+    /** Datepicker instance that the button will toggle. */
+    datepicker: MatDatepickerPanel<MatDatepickerControl<any>, D>;
+    /** Tabindex for the toggle. */
+    tabIndex: number | null;
+    /** Screen-reader label for the button. */
+    ariaLabel: string;
+    /** Whether the toggle button is disabled. */
+    get disabled(): boolean;
+    set disabled(value: boolean);
+    private _disabled;
+    /** Whether ripples on the toggle should be disabled. */
+    disableRipple: boolean;
+    /** Custom icon set by the consumer. */
+    _customIcon: MatDatepickerToggleIcon;
+    /** Underlying button element. */
+    _button: MatButton;
+    constructor(...args: unknown[]);
+    ngOnChanges(changes: SimpleChanges): void;
+    ngOnDestroy(): void;
+    ngAfterContentInit(): void;
+    _open(event: Event): void;
+    private _watchStateChanges;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatDatepickerToggle<any>, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MatDatepickerToggle<any>, "mat-datepicker-toggle", ["matDatepickerToggle"], { "datepicker": { "alias": "for"; "required": false; }; "tabIndex": { "alias": "tabIndex"; "required": false; }; "ariaLabel": { "alias": "aria-label"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "disableRipple": { "alias": "disableRipple"; "required": false; }; }, {}, ["_customIcon"], ["[matDatepickerToggleIcon]"], true, never>;
+    static ngAcceptInputType_disabled: unknown;
 }
 
 /**
- * An internal component used to display a year selector in the datepicker.
- * @docs-private
+ * Base class for the individual inputs that can be projected inside a `mat-date-range-input`.
  */
-export declare class MatMultiYearView<D> implements AfterContentInit, OnDestroy {
-    private _changeDetectorRef;
-    _dateAdapter: DateAdapter<D, any>;
-    private _dir;
-    private _rerenderSubscription;
-    /** Flag used to filter out space/enter keyup events that originated outside of the view. */
-    private _selectionKeyPressed;
-    /** The date to display in this multi-year view (everything other than the year is ignored). */
-    get activeDate(): D;
-    set activeDate(value: D);
-    private _activeDate;
-    /** The currently selected date. */
-    get selected(): DateRange<D> | D | null;
-    set selected(value: DateRange<D> | D | null);
-    private _selected;
-    /** The minimum selectable date. */
-    get minDate(): D | null;
-    set minDate(value: D | null);
-    private _minDate;
-    /** The maximum selectable date. */
-    get maxDate(): D | null;
-    set maxDate(value: D | null);
-    private _maxDate;
-    /** A function used to filter which dates are selectable. */
-    dateFilter: (date: D) => boolean;
-    /** Function that can be used to add custom CSS classes to date cells. */
-    dateClass: MatCalendarCellClassFunction<D>;
-    /** Emits when a new year is selected. */
-    readonly selectedChange: EventEmitter<D>;
-    /** Emits the selected year. This doesn't imply a change on the selected date */
-    readonly yearSelected: EventEmitter<D>;
-    /** Emits when any date is activated. */
-    readonly activeDateChange: EventEmitter<D>;
-    /** The body of calendar table */
-    _matCalendarBody: MatCalendarBody;
-    /** Grid of calendar cells representing the currently displayed years. */
-    _years: MatCalendarCell[][];
-    /** The year that today falls on. */
-    _todayYear: number;
-    /** The year of the selected date. Null if the selected date is null. */
-    _selectedYear: number | null;
-    constructor(...args: unknown[]);
-    ngAfterContentInit(): void;
-    ngOnDestroy(): void;
-    /** Initializes this multi-year view. */
-    _init(): void;
-    /** Handles when a new year is selected. */
-    _yearSelected(event: MatCalendarUserEvent<number>): void;
-    /**
-     * Takes the index of a calendar body cell wrapped in an event as argument. For the date that
-     * corresponds to the given cell, set `activeDate` to that date and fire `activeDateChange` with
-     * that date.
-     *
-     * This function is used to match each component's model of the active date with the calendar
-     * body cell that was focused. It updates its value of `activeDate` synchronously and updates the
-     * parent's value asynchronously via the `activeDateChange` event. The child component receives an
-     * updated value asynchronously via the `activeCell` Input.
-     */
-    _updateActiveDate(event: MatCalendarUserEvent<number>): void;
-    /** Handles keydown events on the calendar body when calendar is in multi-year view. */
-    _handleCalendarBodyKeydown(event: KeyboardEvent): void;
-    /** Handles keyup events on the calendar body when calendar is in multi-year view. */
-    _handleCalendarBodyKeyup(event: KeyboardEvent): void;
-    _getActiveCell(): number;
-    /** Focuses the active cell after the microtask queue is empty. */
-    _focusActiveCell(): void;
-    /** Focuses the active cell after change detection has run and the microtask queue is empty. */
-    _focusActiveCellAfterViewChecked(): void;
+declare abstract class MatDateRangeInputPartBase<D> extends MatDatepickerInputBase<DateRange<D>> implements OnInit, AfterContentInit, DoCheck {
+    _rangeInput: MatDateRangeInput<D>;
+    _elementRef: ElementRef<HTMLInputElement>;
+    _defaultErrorStateMatcher: ErrorStateMatcher;
+    private _injector;
+    _parentForm: NgForm | null;
+    _parentFormGroup: FormGroupDirective | null;
     /**
-     * Takes a year and returns a new date on the same day and month as the currently active date
-     *  The returned date will have the same year as the argument date.
+     * Form control bound to this input part.
+     * @docs-private
      */
-    private _getDateFromYear;
-    /** Creates an MatCalendarCell for the given year. */
-    private _createCellForYear;
-    /** Whether the given year is enabled. */
-    private _shouldEnableYear;
-    /** Determines whether the user has the RTL layout direction. */
-    private _isRtl;
-    /** Sets the currently-highlighted year based on a model value. */
-    private _setSelectedYear;
-    static ɵfac: i0.ɵɵFactoryDeclaration<MatMultiYearView<any>, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<MatMultiYearView<any>, "mat-multi-year-view", ["matMultiYearView"], { "activeDate": { "alias": "activeDate"; "required": false; }; "selected": { "alias": "selected"; "required": false; }; "minDate": { "alias": "minDate"; "required": false; }; "maxDate": { "alias": "maxDate"; "required": false; }; "dateFilter": { "alias": "dateFilter"; "required": false; }; "dateClass": { "alias": "dateClass"; "required": false; }; }, { "selectedChange": "selectedChange"; "yearSelected": "yearSelected"; "activeDateChange": "activeDateChange"; }, never, never, true, never>;
+    ngControl: NgControl;
+    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. */
+    get errorStateMatcher(): ErrorStateMatcher;
+    set errorStateMatcher(value: ErrorStateMatcher);
+    /** Whether the input is in an error state. */
+    get errorState(): boolean;
+    set errorState(value: boolean);
+    constructor(...args: unknown[]);
+    ngOnInit(): void;
+    ngAfterContentInit(): void;
+    ngDoCheck(): void;
+    /** Gets whether the input is empty. */
+    isEmpty(): boolean;
+    /** Gets the placeholder of the input. */
+    _getPlaceholder(): string;
+    /** Focuses the input. */
+    focus(): void;
+    /** Gets the value that should be used when mirroring the input's size. */
+    getMirrorValue(): string;
+    /** Refreshes the error state of the input. */
+    updateErrorState(): void;
+    /** Handles `input` events on the input element. */
+    _onInput(event: Event): void;
+    /** Opens the datepicker associated with the input. */
+    protected _openPopup(): void;
+    /** Gets the minimum date from the range input. */
+    _getMinDate(): D | null;
+    /** Gets the maximum date from the range input. */
+    _getMaxDate(): D | null;
+    /** Gets the date filter function from the range input. */
+    protected _getDateFilter(): DateFilterFn<D>;
+    protected _parentDisabled(): boolean;
+    protected _shouldHandleChangeEvent({ source }: DateSelectionModelChange<DateRange<D>>): boolean;
+    protected _assignValueProgrammatically(value: D | null): void;
+    protected _formatValue(value: D | null): void;
+    /** return the ARIA accessible name of the input element */
+    _getAccessibleName(): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatDateRangeInputPartBase<any>, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MatDateRangeInputPartBase<any>, never, never, { "errorStateMatcher": { "alias": "errorStateMatcher"; "required": false; }; }, {}, never, never, true, never>;
+}
+/** Input for entering the start date in a `mat-date-range-input`. */
+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;
+    _onKeydown(event: KeyboardEvent): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatStartDate<any>, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MatStartDate<any>, "input[matStartDate]", never, {}, { "dateChange": "dateChange"; "dateInput": "dateInput"; }, never, never, true, never>;
+}
+/** Input for entering the end date in a `mat-date-range-input`. */
+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;
+    protected _assignValueToModel(value: D | null): void;
+    private _moveCaretToEndOfStartInput;
+    _onKeydown(event: KeyboardEvent): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatEndDate<any>, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MatEndDate<any>, "input[matEndDate]", never, {}, { "dateChange": "dateChange"; "dateInput": "dateInput"; }, never, never, true, never>;
 }
 
 /**
- * A selection model that contains a date range.
+ * Input that can be associated with a date range picker.
  * @docs-private
  */
-export declare class MatRangeDateSelectionModel<D> extends MatDateSelectionModel<DateRange<D>, D> {
-    constructor(adapter: DateAdapter<D>);
+interface MatDateRangePickerInput<D> extends MatDatepickerControl<D> {
+    _getEndDateAccessibleName(): string | null;
+    _getStartDateAccessibleName(): string | null;
+    comparisonStart: D | null;
+    comparisonEnd: D | null;
+}
+/** Component responsible for managing the date range picker popup/dialog. */
+declare class MatDateRangePicker<D> extends MatDatepickerBase<MatDateRangePickerInput<D>, DateRange<D>, D> {
+    protected _forwardContentValues(instance: MatDatepickerContent<DateRange<D>, D>): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatDateRangePicker<any>, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MatDateRangePicker<any>, "mat-date-range-picker", ["matDateRangePicker"], {}, {}, never, never, true, never>;
+}
+
+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. */
+    id: string;
+    /** Whether the control is focused. */
+    focused: boolean;
+    /** Whether the control's label should float. */
+    get shouldLabelFloat(): boolean;
+    /** Name of the form control. */
+    controlType: string;
     /**
-     * Adds a date to the current selection. In the case of a date range selection, the added date
-     * fills in the next `null` value in the range. If both the start and the end already have a date,
-     * the selection is reset so that the given date is the new `start` and the `end` is null.
+     * Implemented as a part of `MatFormFieldControl`.
+     * Set the placeholder attribute on `matStartDate` and `matEndDate`.
+     * @docs-private
      */
-    add(date: D | null): void;
-    /** Checks whether the current selection is valid. */
-    isValid(): boolean;
+    get placeholder(): string;
+    /** The range picker that this input is associated with. */
+    get rangePicker(): MatDatepickerPanel<MatDatepickerControl<D>, DateRange<D>, D>;
+    set rangePicker(rangePicker: MatDatepickerPanel<MatDatepickerControl<D>, DateRange<D>, D>);
+    private _rangePicker;
+    /** The id of the panel owned by this input. */
+    _ariaOwns: i0.WritableSignal<string | null>;
+    /** Whether the input is required. */
+    get required(): boolean;
+    set required(value: boolean);
+    private _required;
+    /** Function that can be used to filter out dates within the date range picker. */
+    get dateFilter(): DateFilterFn<D>;
+    set dateFilter(value: DateFilterFn<D>);
+    private _dateFilter;
+    /** The minimum valid date. */
+    get min(): D | null;
+    set min(value: D | null);
+    private _min;
+    /** The maximum valid date. */
+    get max(): D | null;
+    set max(value: D | null);
+    private _max;
+    /** Whether the input is disabled. */
+    get disabled(): boolean;
+    set disabled(value: boolean);
+    _groupDisabled: boolean;
+    /** Whether the input is in an error state. */
+    get errorState(): boolean;
+    /** Whether the datepicker input is empty. */
+    get empty(): boolean;
+    /** Value for the `aria-describedby` attribute of the inputs. */
+    _ariaDescribedBy: string | null;
+    /** Date selection model currently registered with the input. */
+    private _model;
+    /** Separator text to be shown between the inputs. */
+    separator: string;
+    /** Start of the comparison range that should be shown in the calendar. */
+    comparisonStart: D | null;
+    /** End of the comparison range that should be shown in the calendar. */
+    comparisonEnd: D | null;
+    /**
+     * Implemented as a part of `MatFormFieldControl`.
+     * TODO(crisbeto): change type to `AbstractControlDirective` after #18206 lands.
+     * @docs-private
+     */
+    ngControl: NgControl | null;
+    /** Emits when the input's state has changed. */
+    readonly stateChanges: Subject<void>;
     /**
-     * Checks whether the current selection is complete. In the case of a date range selection, this
-     * is true if the current selection has a non-null `start` and `end`.
+     * Disable the automatic labeling to avoid issues like #27241.
+     * @docs-private
      */
-    isComplete(): boolean;
-    /** Clones the selection model. */
-    clone(): MatRangeDateSelectionModel<D>;
-    static ɵfac: i0.ɵɵFactoryDeclaration<MatRangeDateSelectionModel<any>, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<MatRangeDateSelectionModel<any>>;
-}
-
-/**
- * A selection model that contains a single date.
- * @docs-private
- */
-export declare class MatSingleDateSelectionModel<D> extends MatDateSelectionModel<D | null, D> {
-    constructor(adapter: DateAdapter<D>);
+    readonly disableAutomaticLabeling = true;
+    constructor(...args: unknown[]);
     /**
-     * Adds a date to the current selection. In the case of a single date selection, the added date
-     * simply overwrites the previous selection
+     * Implemented as a part of `MatFormFieldControl`.
+     * @docs-private
      */
-    add(date: D | null): void;
-    /** Checks whether the current selection is valid. */
-    isValid(): boolean;
+    setDescribedByIds(ids: string[]): void;
     /**
-     * Checks whether the current selection is complete. In the case of a single date selection, this
-     * is true if the current selection is not null.
+     * Implemented as a part of `MatFormFieldControl`.
+     * @docs-private
      */
-    isComplete(): boolean;
-    /** Clones the selection model. */
-    clone(): MatSingleDateSelectionModel<D>;
-    static ɵfac: i0.ɵɵFactoryDeclaration<MatSingleDateSelectionModel<any>, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<MatSingleDateSelectionModel<any>>;
+    onContainerClick(): void;
+    ngAfterContentInit(): void;
+    ngOnChanges(changes: SimpleChanges): void;
+    ngOnDestroy(): void;
+    /** Gets the date at which the calendar should start. */
+    getStartValue(): D | null;
+    /** Gets the input's theme palette. */
+    getThemePalette(): ThemePalette;
+    /** Gets the element to which the calendar overlay should be attached. */
+    getConnectedOverlayOrigin(): ElementRef;
+    /** Gets the ID of an element that should be used a description for the calendar overlay. */
+    getOverlayLabelId(): string | null;
+    /** Gets the value that is used to mirror the state input. */
+    _getInputMirrorValue(part: 'start' | 'end'): string;
+    /** Whether the input placeholders should be hidden. */
+    _shouldHidePlaceholders(): boolean;
+    /** Handles the value in one of the child inputs changing. */
+    _handleChildValueChange(): void;
+    /** Opens the date range picker associated with the input. */
+    _openDatepicker(): void;
+    /** Whether the separate text should be hidden. */
+    _shouldHideSeparator(): boolean | "" | null;
+    /** Gets the value for the `aria-labelledby` attribute of the inputs. */
+    _getAriaLabelledby(): string | null;
+    _getStartDateAccessibleName(): string;
+    _getEndDateAccessibleName(): string;
+    /** Updates the focused state of the range input. */
+    _updateFocus(origin: FocusOrigin): void;
+    /** Re-runs the validators on the start/end inputs. */
+    private _revalidate;
+    /** Registers the current date selection model with the start/end inputs. */
+    private _registerModel;
+    /** 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; }; }, {}, never, ["input[matStartDate]", "input[matEndDate]"], true, never>;
+    static ngAcceptInputType_required: unknown;
+    static ngAcceptInputType_disabled: unknown;
 }
 
-/** Input for entering the start date in a `mat-date-range-input`. */
-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;
-    _onKeydown(event: KeyboardEvent): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<MatStartDate<any>, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<MatStartDate<any>, "input[matStartDate]", never, {}, { "dateChange": "dateChange"; "dateInput": "dateInput"; }, never, never, true, never>;
+/** Button that will close the datepicker and assign the current selection to the data model. */
+declare class MatDatepickerApply {
+    private _datepicker;
+    constructor(...args: unknown[]);
+    _applySelection(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatDatepickerApply, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MatDatepickerApply, "[matDatepickerApply], [matDateRangePickerApply]", never, {}, {}, never, never, true, never>;
+}
+/** Button that will close the datepicker and discard the current selection. */
+declare class MatDatepickerCancel {
+    _datepicker: MatDatepickerBase<MatDatepickerControl<any>, unknown, {}>;
+    constructor(...args: unknown[]);
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatDatepickerCancel, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MatDatepickerCancel, "[matDatepickerCancel], [matDateRangePickerCancel]", never, {}, {}, never, never, true, never>;
 }
-
 /**
- * An internal component used to display a single year in the datepicker.
- * @docs-private
+ * Container that can be used to project a row of action buttons
+ * to the bottom of a datepicker or date range picker.
  */
-export declare class MatYearView<D> implements AfterContentInit, OnDestroy {
-    readonly _changeDetectorRef: ChangeDetectorRef;
-    private _dateFormats;
-    _dateAdapter: DateAdapter<D, any>;
-    private _dir;
-    private _rerenderSubscription;
-    /** Flag used to filter out space/enter keyup events that originated outside of the view. */
-    private _selectionKeyPressed;
-    /** The date to display in this year view (everything other than the year is ignored). */
-    get activeDate(): D;
-    set activeDate(value: D);
-    private _activeDate;
-    /** The currently selected date. */
-    get selected(): DateRange<D> | D | null;
-    set selected(value: DateRange<D> | D | null);
-    private _selected;
-    /** The minimum selectable date. */
-    get minDate(): D | null;
-    set minDate(value: D | null);
-    private _minDate;
-    /** The maximum selectable date. */
-    get maxDate(): D | null;
-    set maxDate(value: D | null);
-    private _maxDate;
-    /** A function used to filter which dates are selectable. */
-    dateFilter: (date: D) => boolean;
-    /** Function that can be used to add custom CSS classes to date cells. */
-    dateClass: MatCalendarCellClassFunction<D>;
-    /** Emits when a new month is selected. */
-    readonly selectedChange: EventEmitter<D>;
-    /** Emits the selected month. This doesn't imply a change on the selected date */
-    readonly monthSelected: EventEmitter<D>;
-    /** Emits when any date is activated. */
-    readonly activeDateChange: EventEmitter<D>;
-    /** The body of calendar table */
-    _matCalendarBody: MatCalendarBody;
-    /** Grid of calendar cells representing the months of the year. */
-    _months: MatCalendarCell[][];
-    /** The label for this year (e.g. "2017"). */
-    _yearLabel: string;
-    /** The month in this year that today falls on. Null if today is in a different year. */
-    _todayMonth: number | null;
-    /**
-     * The month in this year that the selected Date falls on.
-     * Null if the selected Date is in a different year.
-     */
-    _selectedMonth: number | null;
+declare class MatDatepickerActions implements AfterViewInit, OnDestroy {
+    private _datepicker;
+    private _viewContainerRef;
+    _template: TemplateRef<unknown>;
+    private _portal;
     constructor(...args: unknown[]);
-    ngAfterContentInit(): void;
+    ngAfterViewInit(): void;
     ngOnDestroy(): void;
-    /** Handles when a new month is selected. */
-    _monthSelected(event: MatCalendarUserEvent<number>): void;
-    /**
-     * Takes the index of a calendar body cell wrapped in an event as argument. For the date that
-     * corresponds to the given cell, set `activeDate` to that date and fire `activeDateChange` with
-     * that date.
-     *
-     * This function is used to match each component's model of the active date with the calendar
-     * body cell that was focused. It updates its value of `activeDate` synchronously and updates the
-     * parent's value asynchronously via the `activeDateChange` event. The child component receives an
-     * updated value asynchronously via the `activeCell` Input.
-     */
-    _updateActiveDate(event: MatCalendarUserEvent<number>): void;
-    /** Handles keydown events on the calendar body when calendar is in year view. */
-    _handleCalendarBodyKeydown(event: KeyboardEvent): void;
-    /** Handles keyup events on the calendar body when calendar is in year view. */
-    _handleCalendarBodyKeyup(event: KeyboardEvent): void;
-    /** Initializes this year view. */
-    _init(): void;
-    /** Focuses the active cell after the microtask queue is empty. */
-    _focusActiveCell(): void;
-    /** Schedules the matCalendarBody to focus the active cell after change detection has run */
-    _focusActiveCellAfterViewChecked(): void;
-    /**
-     * Gets the month in this year that the given Date falls on.
-     * Returns null if the given Date is in another year.
-     */
-    private _getMonthInCurrentYear;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatDatepickerActions, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MatDatepickerActions, "mat-datepicker-actions, mat-date-range-picker-actions", never, {}, {}, never, ["*"], true, never>;
+}
+
+declare class MatDatepickerModule {
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatDatepickerModule, never>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<MatDatepickerModule, never, [typeof MatButtonModule, typeof i2.OverlayModule, typeof i1.A11yModule, typeof i3.PortalModule, typeof MatCommonModule, typeof MatCalendar, typeof MatCalendarBody, typeof MatDatepicker, typeof MatDatepickerContent, typeof MatDatepickerInput, typeof MatDatepickerToggle, typeof MatDatepickerToggleIcon, typeof MatMonthView, typeof MatYearView, typeof MatMultiYearView, typeof MatCalendarHeader, typeof MatDateRangeInput, typeof MatStartDate, typeof MatEndDate, typeof MatDateRangePicker, typeof MatDatepickerActions, typeof MatDatepickerCancel, typeof MatDatepickerApply], [typeof i5.CdkScrollableModule, typeof MatCalendar, typeof MatCalendarBody, typeof MatDatepicker, typeof MatDatepickerContent, typeof MatDatepickerInput, typeof MatDatepickerToggle, typeof MatDatepickerToggleIcon, typeof MatMonthView, typeof MatYearView, typeof MatMultiYearView, typeof MatCalendarHeader, typeof MatDateRangeInput, typeof MatStartDate, typeof MatEndDate, typeof MatDateRangePicker, typeof MatDatepickerActions, typeof MatDatepickerCancel, typeof MatDatepickerApply]>;
+    static ɵinj: i0.ɵɵInjectorDeclaration<MatDatepickerModule>;
+}
+
+/** Injection token used to customize the date range selection behavior. */
+declare const MAT_DATE_RANGE_SELECTION_STRATEGY: InjectionToken<MatDateRangeSelectionStrategy<any>>;
+/** Object that can be provided in order to customize the date range selection behavior. */
+interface MatDateRangeSelectionStrategy<D> {
     /**
-     * Takes a month and returns a new date in the same day and year as the currently active date.
-     *  The returned date will have the same month as the argument date.
+     * Called when the user has finished selecting a value.
+     * @param date Date that was selected. Will be null if the user cleared the selection.
+     * @param currentRange Range that is currently show in the calendar.
+     * @param event DOM event that triggered the selection. Currently only corresponds to a `click`
+     *    event, but it may get expanded in the future.
      */
-    private _getDateFromMonth;
-    /** Creates an MatCalendarCell for the given month. */
-    private _createCellForMonth;
-    /** Whether the given month is enabled. */
-    private _shouldEnableMonth;
+    selectionFinished(date: D | null, currentRange: DateRange<D>, event: Event): DateRange<D>;
     /**
-     * Tests whether the combination month/year is after this.maxDate, considering
-     * just the month and year of this.maxDate
+     * Called when the user has activated a new date (e.g. by hovering over
+     * it or moving focus) and the calendar tries to display a date range.
+     *
+     * @param activeDate Date that the user has activated. Will be null if the user moved
+     *    focus to an element that's no a calendar cell.
+     * @param currentRange Range that is currently shown in the calendar.
+     * @param event DOM event that caused the preview to be changed. Will be either a
+     *    `mouseenter`/`mouseleave` or `focus`/`blur` depending on how the user is navigating.
      */
-    private _isYearAndMonthAfterMaxDate;
+    createPreview(activeDate: D | null, currentRange: DateRange<D>, event: Event): DateRange<D>;
     /**
-     * Tests whether the combination month/year is before this.minDate, considering
-     * just the month and year of this.minDate
+     * Called when the user has dragged a date in the currently selected range to another
+     * date. Returns the date updated range that should result from this interaction.
+     *
+     * @param dateOrigin The date the user started dragging from.
+     * @param originalRange The originally selected date range.
+     * @param newDate The currently targeted date in the drag operation.
+     * @param event DOM event that triggered the updated drag state. Will be
+     *     `mouseenter`/`mouseup` or `touchmove`/`touchend` depending on the device type.
      */
-    private _isYearAndMonthBeforeMinDate;
-    /** Determines whether the user has the RTL layout direction. */
-    private _isRtl;
-    /** Sets the currently-selected month based on a model value. */
-    private _setSelectedMonth;
-    static ɵfac: i0.ɵɵFactoryDeclaration<MatYearView<any>, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<MatYearView<any>, "mat-year-view", ["matYearView"], { "activeDate": { "alias": "activeDate"; "required": false; }; "selected": { "alias": "selected"; "required": false; }; "minDate": { "alias": "minDate"; "required": false; }; "maxDate": { "alias": "maxDate"; "required": false; }; "dateFilter": { "alias": "dateFilter"; "required": false; }; "dateClass": { "alias": "dateClass"; "required": false; }; }, { "selectedChange": "selectedChange"; "monthSelected": "monthSelected"; "activeDateChange": "activeDateChange"; }, never, never, true, never>;
+    createDrag?(dragOrigin: D, originalRange: DateRange<D>, newDate: D, event: Event): DateRange<D> | null;
+}
+/** Provides the default date range selection behavior. */
+declare class DefaultMatCalendarRangeStrategy<D> implements MatDateRangeSelectionStrategy<D> {
+    private _dateAdapter;
+    constructor(_dateAdapter: DateAdapter<D>);
+    selectionFinished(date: D, currentRange: DateRange<D>): DateRange<D>;
+    createPreview(activeDate: D | null, currentRange: DateRange<D>): DateRange<D>;
+    createDrag(dragOrigin: D, originalRange: DateRange<D>, newDate: D): DateRange<D> | null;
+    static ɵfac: i0.ɵɵFactoryDeclaration<DefaultMatCalendarRangeStrategy<any>, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<DefaultMatCalendarRangeStrategy<any>>;
 }
 
-export declare const yearsPerPage = 24;
-
-export declare const yearsPerRow = 4;
+/**
+ * Animations used by the Material datepicker.
+ * @docs-private
+ * @deprecated No longer used, will be removed.
+ * @breaking-change 21.0.0
+ */
+declare const matDatepickerAnimations: {
+    readonly transformPanel: any;
+    readonly fadeInCalendar: any;
+};
 
-export { }
+export { type DateFilterFn, DateRange, type DateSelectionModelChange, type DatepickerDropdownPositionX, type DatepickerDropdownPositionY, DefaultMatCalendarRangeStrategy, type ExtractDateTypeFromSelection, MAT_DATEPICKER_SCROLL_STRATEGY, MAT_DATEPICKER_SCROLL_STRATEGY_FACTORY, MAT_DATEPICKER_SCROLL_STRATEGY_FACTORY_PROVIDER, MAT_DATEPICKER_VALIDATORS, MAT_DATEPICKER_VALUE_ACCESSOR, MAT_DATE_RANGE_SELECTION_STRATEGY, MAT_RANGE_DATE_SELECTION_MODEL_FACTORY, MAT_RANGE_DATE_SELECTION_MODEL_PROVIDER, MAT_SINGLE_DATE_SELECTION_MODEL_FACTORY, MAT_SINGLE_DATE_SELECTION_MODEL_PROVIDER, MatCalendar, MatCalendarBody, MatCalendarCell, type MatCalendarCellClassFunction, type MatCalendarCellCssClasses, MatCalendarHeader, type MatCalendarUserEvent, type MatCalendarView, MatDateRangeInput, MatDateRangePicker, type MatDateRangeSelectionStrategy, MatDateSelectionModel, MatDatepicker, MatDatepickerActions, MatDatepickerApply, MatDatepickerCancel, MatDatepickerContent, type MatDatepickerControl, MatDatepickerInput, MatDatepickerInputEvent, MatDatepickerIntl, MatDatepickerModule, type MatDatepickerPanel, MatDatepickerToggle, MatDatepickerToggleIcon, MatEndDate, MatMonthView, MatMultiYearView, MatRangeDateSelectionModel, MatSingleDateSelectionModel, MatStartDate, MatYearView, matDatepickerAnimations, yearsPerPage, yearsPerRow };