@angular/material 12.0.0 → 12.0.4

package/core/typography/_typography.scss

@@ -2,7 +2,13 @@
 @use 'typography-utils';
 @use '../theming/theming';
 
-// Represents a typography level from the Material design spec.
+/// Defines a typography level from the Material Design spec.
+/// @param {String} $font-size The font-size for this level.
+/// @param {String | Number} $line-height The line-height for this level.
+/// @param {String | Number} $font-weight The font-weight for this level.
+/// @param {String} $font-family The font-family for this level.
+/// @param {String} $letter-spacing The letter-spacing for this level.
+/// @returns {Map} A map representing the definition of this typpographic level.
 @function define-typography-level(
   $font-size,
   $line-height: $font-size,
@@ -19,10 +25,27 @@
   );
 }
 
-// Represents a collection of typography levels.
-// Defaults come from https://material.io/guidelines/style/typography.html
-// Note: The spec doesn't mention letter spacing. The values here come from
-// eyeballing it until it looked exactly like the spec examples.
+/// Defines a collection of typography levels to configure typography for an application.
+/// Any level not specified defaults to the values defined in the Material Design specification:
+/// https://material.io/guidelines/style/typography.html.
+///
+/// Note that the Material Design specification does not describe explicit letter-spacing values.
+/// The values here come from reverse engineering the Material Design examples.
+/// @param {String} $font-family Default font-family for levels that don't specify font-family.
+/// @param {Map} $display-4 Configuration for the "display-4" typographic level.
+/// @param {Map} $display-3 Configuration for the "display-3" typographic level.
+/// @param {Map} $display-2 Configuration for the "display-2" typographic level.
+/// @param {Map} $display-1 Configuration for the "display-1" typographic level.
+/// @param {Map} $headline Configuration for the "headline" typographic level.
+/// @param {Map} $title Configuration for the "title" typographic level.
+/// @param {Map} $subheading-2 Configuration for the "subheading-2" typographic level.
+/// @param {Map} $subheading-1 Configuration for the "subheading-1" typographic level.
+/// @param {Map} $body-2 Configuration for the "body-2" typographic level.
+/// @param {Map} $body-1 Configuration for the "body-1" typographic level.
+/// @param {Map} $caption Configuration for the "caption" typographic level.
+/// @param {Map} $button Configuration for the "button" typographic level.
+/// @param {Map} $input Configuration for the "input" typographic level.
+/// @returns {Map} A typography config for the application.
 @function define-typography-config(
   $font-family:   'Roboto, "Helvetica Neue", sans-serif',
   $display-4:     define-typography-level(112px, 112px, 300, $letter-spacing: -0.05em),
@@ -148,8 +171,12 @@
   @return $config;
 }
 
-// Adds the base typography styles, based on a config.
-// stylelint-disable-next-line material/theme-mixin-api
+// stylelint-disable material/theme-mixin-api
+
+/// Emits baseline typographic styles based on a given config.
+/// @param {Map} $config-or-theme A typography config for an entire theme.
+/// @param {String} $selector Ancestor selector under which native elements, such as h1, will
+///     be styled.
 @mixin typography-hierarchy($config-or-theme, $selector: '.mat-typography') {
   $config: private-typography-to-2014-config(theming.get-typography-config($config-or-theme));
 
@@ -236,3 +263,5 @@
     margin: 0 0 64px;
   }
 }
+
+// stylelint-enable material/theme-mixin-api

package/datepicker/_datepicker-legacy-index.scss

@@ -0,0 +1,9 @@
+@forward 'datepicker-theme' hide $calendar-body-font-size, $calendar-weekday-table-font-size,
+$range-fade-amount, $selected-fade-amount, $selected-today-box-shadow-width, $today-fade-amount,
+color, date-range-colors, theme, typography;
+@forward 'datepicker-theme' as mat-* hide $mat-range-fade-amount, $mat-selected-fade-amount,
+$mat-selected-today-box-shadow-width, $mat-today-fade-amount, mat-color, mat-density, mat-theme,
+mat-typography, mat-unselected-cell;
+@forward 'datepicker-theme' as mat-datepicker-* hide $mat-datepicker-calendar-body-font-size,
+$mat-datepicker-calendar-weekday-table-font-size, mat-datepicker-color,
+mat-datepicker-date-range-colors, mat-datepicker-density, mat-datepicker-unselected-cell;

package/datepicker/calendar.d.ts

@@ -48,10 +48,7 @@ export declare class MatCalendarHeader<D> {
     /** Whether the two dates represent the same view in the current view mode (month or year). */
     private _isSameView;
 }
-/**
- * A calendar that is used as part of the datepicker.
- * @docs-private
- */
+/** A calendar that is used as part of the datepicker. */
 export declare class MatCalendar<D> implements AfterContentInit, AfterViewChecked, OnDestroy, OnChanges {
     private _dateAdapter;
     private _dateFormats;
@@ -137,6 +134,7 @@ export declare class MatCalendar<D> implements AfterContentInit, AfterViewChecke
     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;

package/datepicker/datepicker-base.d.ts

@@ -124,7 +124,6 @@ export declare abstract class MatDatepickerBase<C extends MatDatepickerControl<D
     private _viewContainerRef;
     private _dateAdapter;
     private _dir;
-    private _document;
     private _model;
     private _scrollStrategy;
     private _inputStateChanges;
@@ -220,7 +219,12 @@ export declare abstract class MatDatepickerBase<C extends MatDatepickerControl<D
      * @deprecated `_dialog` parameter is no longer being used and it will be removed.
      * @breaking-change 13.0.0
      */
-    _dialog: any, _overlay: Overlay, _ngZone: NgZone, _viewContainerRef: ViewContainerRef, scrollStrategy: any, _dateAdapter: DateAdapter<D>, _dir: Directionality, _document: any, _model: MatDateSelectionModel<S, D>);
+    _dialog: any, _overlay: Overlay, _ngZone: NgZone, _viewContainerRef: ViewContainerRef, scrollStrategy: any, _dateAdapter: DateAdapter<D>, _dir: Directionality, 
+    /**
+     * @deprecated No longer being used. To be removed.
+     * @breaking-change 13.0.0
+     */
+    _document: any, _model: MatDateSelectionModel<S, D>);
     ngOnChanges(changes: SimpleChanges): void;
     ngOnDestroy(): void;
     /** Selects the given date */