@angular/material 11.0.3 → 11.1.1

package/datepicker/datepicker-base.d.ts

@@ -8,8 +8,8 @@
 import { Directionality } from '@angular/cdk/bidi';
 import { BooleanInput } from '@angular/cdk/coercion';
 import { Overlay, ScrollStrategy } from '@angular/cdk/overlay';
-import { ComponentType } from '@angular/cdk/portal';
-import { AfterViewInit, ElementRef, EventEmitter, InjectionToken, NgZone, OnDestroy, ViewContainerRef, ChangeDetectorRef, OnChanges, SimpleChanges } from '@angular/core';
+import { ComponentType, TemplatePortal } from '@angular/cdk/portal';
+import { AfterViewInit, ElementRef, EventEmitter, InjectionToken, NgZone, OnDestroy, ViewContainerRef, ChangeDetectorRef, OnChanges, SimpleChanges, OnInit } from '@angular/core';
 import { CanColor, CanColorCtor, DateAdapter, ThemePalette } from '@angular/material/core';
 import { MatDialog } from '@angular/material/dialog';
 import { Subject, Observable } from 'rxjs';
@@ -46,12 +46,13 @@ declare const _MatDatepickerContentMixinBase: CanColorCtor & typeof MatDatepicke
  * future. (e.g. confirmation buttons).
  * @docs-private
  */
-export declare class MatDatepickerContent<S, D = ExtractDateTypeFromSelection<S>> extends _MatDatepickerContentMixinBase implements AfterViewInit, OnDestroy, CanColor {
+export declare class MatDatepickerContent<S, D = ExtractDateTypeFromSelection<S>> extends _MatDatepickerContentMixinBase implements OnInit, AfterViewInit, OnDestroy, CanColor {
     private _changeDetectorRef;
-    private _model;
+    private _globalModel;
     private _dateAdapter;
     private _rangeSelectionStrategy;
     private _subscriptions;
+    private _model;
     /** Reference to the internal calendar component. */
     _calendar: MatCalendar<D>;
     /** Reference to the datepicker that created the overlay. */
@@ -70,17 +71,22 @@ export declare class MatDatepickerContent<S, D = ExtractDateTypeFromSelection<S>
     _closeButtonText: string;
     /** Whether the close button currently has focus. */
     _closeButtonFocused: boolean;
-    constructor(elementRef: ElementRef, _changeDetectorRef: ChangeDetectorRef, _model: MatDateSelectionModel<S, D>, _dateAdapter: DateAdapter<D>, _rangeSelectionStrategy: MatDateRangeSelectionStrategy<D>, 
+    /** Portal with projected action buttons. */
+    _actionsPortal: TemplatePortal | null;
+    constructor(elementRef: ElementRef, _changeDetectorRef: ChangeDetectorRef, _globalModel: MatDateSelectionModel<S, D>, _dateAdapter: DateAdapter<D>, _rangeSelectionStrategy: MatDateRangeSelectionStrategy<D>, 
     /**
      * @deprecated `intl` argument to become required.
      * @breaking-change 12.0.0
      */
     intl?: MatDatepickerIntl);
+    ngOnInit(): void;
     ngAfterViewInit(): void;
     ngOnDestroy(): void;
     _handleUserSelection(event: MatCalendarUserEvent<D | null>): void;
     _startExitAnimation(): void;
     _getSelected(): D | DateRange<D> | null;
+    /** Applies the current pending selection to the global model. */
+    _applyPendingSelection(): void;
 }
 /** Form control that can be associated with a datepicker. */
 export interface MatDatepickerControl<D> {
@@ -93,8 +99,31 @@ export interface MatDatepickerControl<D> {
     getConnectedOverlayOrigin(): ElementRef;
     stateChanges: Observable<void>;
 }
+/** A datepicker that can be attached to a {@link MatDatepickerControl}. */
+export interface MatDatepickerPanel<C extends MatDatepickerControl<D>, S, D = ExtractDateTypeFromSelection<S>> {
+    /** Stream that emits whenever the date picker is closed. */
+    closedStream: EventEmitter<void>;
+    /** Color palette to use on the datepicker's calendar. */
+    color: ThemePalette;
+    /** The input element the datepicker is associated with. */
+    datepickerInput: C;
+    /** Whether the datepicker pop-up should be disabled. */
+    disabled: boolean;
+    /** The id for the datepicker's calendar. */
+    id: string;
+    /** Whether the datepicker is open. */
+    opened: boolean;
+    /** Stream that emits whenever the date picker is opened. */
+    openedStream: EventEmitter<void>;
+    /** Emits when the datepicker's state changes. */
+    stateChanges: Subject<void>;
+    /** Opens the datepicker. */
+    open(): void;
+    /** Register an input with the datepicker. */
+    registerInput(input: C): MatDateSelectionModel<S, D>;
+}
 /** Base class for a datepicker. */
-export declare abstract class MatDatepickerBase<C extends MatDatepickerControl<D>, S, D = ExtractDateTypeFromSelection<S>> implements OnDestroy, OnChanges {
+export declare abstract class MatDatepickerBase<C extends MatDatepickerControl<D>, S, D = ExtractDateTypeFromSelection<S>> implements MatDatepickerPanel<C, S, D>, OnDestroy, OnChanges {
     private _dialog;
     private _overlay;
     private _ngZone;
@@ -180,10 +209,12 @@ export declare abstract class MatDatepickerBase<C extends MatDatepickerControl<D
     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;
+    datepickerInput: C;
     /** Emits when the datepicker's state changes. */
-    readonly _stateChanges: Subject<void>;
+    readonly stateChanges: Subject<void>;
     constructor(_dialog: MatDialog, _overlay: Overlay, _ngZone: NgZone, _viewContainerRef: ViewContainerRef, scrollStrategy: any, _dateAdapter: DateAdapter<D>, _dir: Directionality, _document: any, _model: MatDateSelectionModel<S, D>);
     ngOnChanges(changes: SimpleChanges): void;
     ngOnDestroy(): void;
@@ -200,11 +231,23 @@ export declare abstract class MatDatepickerBase<C extends MatDatepickerControl<D
      * @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>;
+    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 popup to the model. */
+    _applyPendingSelection(): void;
     /** Open the calendar as a dialog. */
     private _openAsDialog;
     /** Open the calendar as a popup. */

package/datepicker/datepicker-input-base.d.ts

@@ -50,13 +50,11 @@ export declare abstract class MatDatepickerInputBase<S, D = ExtractDateTypeFromS
     readonly dateChange: EventEmitter<MatDatepickerInputEvent<D, S>>;
     /** Emits when an `input` event is fired on this `<input>`. */
     readonly dateInput: EventEmitter<MatDatepickerInputEvent<D, S>>;
-    /** Emits when the value changes (either due to user input or programmatic change). */
-    _valueChange: EventEmitter<D | null>;
     /** Emits when the internal state has changed */
     stateChanges: Subject<void>;
     _onTouched: () => void;
     _validatorOnChange: () => void;
-    protected _cvaOnChange: (value: any) => void;
+    private _cvaOnChange;
     private _valueChangesSubscription;
     private _localeSubscription;
     /**
@@ -91,13 +89,8 @@ export declare abstract class MatDatepickerInputBase<S, D = ExtractDateTypeFromS
     protected abstract _getValueFromModel(modelValue: S): D | null;
     /** Combined form control validator for this input. */
     protected abstract _validator: ValidatorFn | null;
-    /**
-     * Callback that'll be invoked when the selection model is changed
-     * from somewhere that's not the current datepicker input.
-     */
-    protected abstract _outsideValueChanged?: () => void;
-    /** Predicate that determines whether we're allowed to emit a particular change event. */
-    protected abstract _canEmitChangeEvent(event: DateSelectionModelChange<S>): boolean;
+    /** Predicate that determines whether the input should handle a particular change event. */
+    protected abstract _shouldHandleChangeEvent(event: DateSelectionModelChange<S>): boolean;
     /** Whether the last value set on the input was valid. */
     protected _lastValueValid: boolean;
     constructor(_elementRef: ElementRef<HTMLInputElement>, _dateAdapter: DateAdapter<D>, _dateFormats: MatDateFormats);
@@ -128,6 +121,8 @@ export declare abstract class MatDatepickerInputBase<S, D = ExtractDateTypeFromS
      * by inputs extending this one which can be placed inside of a group that can be disabled.
      */
     protected _parentDisabled(): boolean;
+    /** Programmatically assigns a value to the input. */
+    protected _assignValueProgrammatically(value: D | null): void;
     /** Gets whether a value matches the current date filter. */
     _matchesFilter(value: D | null): boolean;
     static ngAcceptInputType_value: any;

package/datepicker/datepicker-input.d.ts

@@ -5,23 +5,24 @@
  * Use of this source code is governed by an MIT-style license that can be
  * found in the LICENSE file at https://angular.io/license
  */
-import { ElementRef } from '@angular/core';
+import { ElementRef, OnDestroy } from '@angular/core';
 import { ValidatorFn } from '@angular/forms';
 import { DateAdapter, MatDateFormats, ThemePalette } from '@angular/material/core';
 import { MatFormField } from '@angular/material/form-field';
-import { MatDatepicker } from './datepicker';
 import { MatDatepickerInputBase, DateFilterFn } from './datepicker-input-base';
-import { MatDatepickerControl } from './datepicker-base';
+import { MatDatepickerControl, MatDatepickerPanel } from './datepicker-base';
+import { DateSelectionModelChange } from './date-selection-model';
 /** @docs-private */
 export declare const MAT_DATEPICKER_VALUE_ACCESSOR: any;
 /** @docs-private */
 export declare const MAT_DATEPICKER_VALIDATORS: any;
 /** Directive used to connect an input to a MatDatepicker. */
-export declare class MatDatepickerInput<D> extends MatDatepickerInputBase<D | null, D> implements MatDatepickerControl<D | null> {
+export declare class MatDatepickerInput<D> extends MatDatepickerInputBase<D | null, D> implements MatDatepickerControl<D | null>, OnDestroy {
     private _formField;
+    private _closedSubscription;
     /** The datepicker that this input is associated with. */
-    set matDatepicker(datepicker: MatDatepicker<D>);
-    _datepicker: MatDatepicker<D>;
+    set matDatepicker(datepicker: MatDatepickerPanel<MatDatepickerControl<D>, D | null, D>);
+    _datepicker: MatDatepickerPanel<MatDatepickerControl<D>, D | null, D>;
     /** The minimum valid date. */
     get min(): D | null;
     set min(value: D | null);
@@ -46,6 +47,7 @@ export declare class MatDatepickerInput<D> extends MatDatepickerInputBase<D | nu
     getThemePalette(): ThemePalette;
     /** Gets the value at which the calendar should start. */
     getStartValue(): D | null;
+    ngOnDestroy(): void;
     /** Opens the associated datepicker. */
     protected _openPopup(): void;
     protected _getValueFromModel(modelValue: D | null): D | null;
@@ -56,7 +58,6 @@ export declare class MatDatepickerInput<D> extends MatDatepickerInputBase<D | nu
     _getMaxDate(): D | null;
     /** Gets the input's date filtering function. */
     protected _getDateFilter(): DateFilterFn<D | null>;
-    protected _canEmitChangeEvent(): boolean;
-    protected _outsideValueChanged: undefined;
+    protected _shouldHandleChangeEvent(event: DateSelectionModelChange<D>): boolean;
     static ngAcceptInputType_value: any;
 }

package/datepicker/datepicker-toggle.d.ts

@@ -9,7 +9,7 @@ import { BooleanInput } from '@angular/cdk/coercion';
 import { AfterContentInit, ChangeDetectorRef, OnChanges, OnDestroy, SimpleChanges } from '@angular/core';
 import { MatButton } from '@angular/material/button';
 import { MatDatepickerIntl } from './datepicker-intl';
-import { MatDatepickerBase, MatDatepickerControl } from './datepicker-base';
+import { MatDatepickerControl, MatDatepickerPanel } from './datepicker-base';
 /** Can be used to override the icon of a `matDatepickerToggle`. */
 export declare class MatDatepickerToggleIcon {
 }
@@ -18,9 +18,11 @@ export declare class MatDatepickerToggle<D> implements AfterContentInit, OnChang
     private _changeDetectorRef;
     private _stateChanges;
     /** Datepicker instance that the button will toggle. */
-    datepicker: MatDatepickerBase<MatDatepickerControl<any>, D>;
+    datepicker: MatDatepickerPanel<MatDatepickerControl<any>, D>;
     /** Tabindex for the toggle. */
     tabIndex: number | null;
+    /** Screenreader label for the button. */
+    ariaLabel: string;
     /** Whether the toggle button is disabled. */
     get disabled(): boolean;
     set disabled(value: boolean);