docs: add descriptions to properties initialized through the constructor

Adds the missing docs to some of the properties that are declared through the constructor params.

Author: crisbeto

src/lib/autocomplete/autocomplete.ts

@@ -33,7 +33,12 @@ let _uniqueAutocompleteIdCounter = 0;
 
 /** Event object that is emitted when an autocomplete option is selected */
 export class MatAutocompleteSelectedEvent {
-  constructor(public source: MatAutocomplete, public option: MatOption) { }
+  constructor(
+    /** Reference to the autocomplete panel that emitted the event. */
+    public source: MatAutocomplete,
+
+    /** Option that was selected. */
+    public option: MatOption) { }
 }
 
 

src/lib/chips/chip-list.ts

@@ -60,7 +60,12 @@ let nextUniqueId = 0;
 
 /** Change event object that is emitted when the chip list value has changed. */
 export class MatChipListChange {
-  constructor(public source: MatChipList, public value: any) { }
+  constructor(
+    /** Chip list that emitted the event. */
+    public source: MatChipList,
+
+    /** Value of the chip list when the event was emitted. */
+    public value: any) { }
 }
 
 

src/lib/chips/chip.ts

@@ -29,7 +29,15 @@ export interface MatChipEvent {
 
 /** Event object emitted by MatChip when selected or deselected. */
 export class MatChipSelectionChange {
-  constructor(public source: MatChip, public selected: boolean, public isUserInput = false) { }
+  constructor(
+    /** Reference to the chip that emitted the event. */
+    public source: MatChip,
+
+    /** Whether the chip that emitted the event is selected. */
+    public selected: boolean,
+
+    /** Whether the selection change was a result of a user interaction. */
+    public isUserInput = false) { }
 }
 
 

src/lib/core/option/option.ts

@@ -32,7 +32,11 @@ let _uniqueIdCounter = 0;
 
 /** Event object emitted by MatOption when selected or deselected. */
 export class MatOptionSelectionChange {
-  constructor(public source: MatOption, public isUserInput = false) { }
+  constructor(
+    /** Reference to the option that emitted the event. */
+    public source: MatOption,
+    /** Whether the change in the option's value was a result of a user action. */
+    public isUserInput = false) { }
 }
 
 /**

src/lib/datepicker/datepicker-input.ts

@@ -61,7 +61,11 @@ export class MatDatepickerInputEvent<D> {
   /** The new value for the target datepicker input. */
   value: D | null;
 
-  constructor(public target: MatDatepickerInput<D>, public targetElement: HTMLElement) {
+  constructor(
+    /** Reference to the datepicker input component that emitted the event. */
+    public target: MatDatepickerInput<D>,
+    /** Reference to the native input element associated with the datepicker input. */
+    public targetElement: HTMLElement) {
     this.value = this.target.value;
   }
 }

src/lib/select/select.ts

@@ -137,7 +137,11 @@ export const MAT_SELECT_SCROLL_STRATEGY_PROVIDER = {
 
 /** Change event object that is emitted when the select value has changed. */
 export class MatSelectChange {
-  constructor(public source: MatSelect, public value: any) { }
+  constructor(
+    /** Reference to the select that emitted the change event. */
+    public source: MatSelect,
+    /** Current value of the select that emitted the event. */
+    public value: any) { }
 }
 
 // Boilerplate for applying mixins to MatSelect.

src/lib/sidenav/drawer.ts

@@ -51,7 +51,11 @@ export function throwMatDuplicatedDrawerError(position: string) {
  * @deprecated
  */
 export class MatDrawerToggleResult {
-  constructor(public type: 'open' | 'close', public animationFinished: boolean) {}
+  constructor(
+    /** Whether the drawer is opened or closed. */
+    public type: 'open' | 'close',
+    /** Whether the drawer animation is finished. */
+    public animationFinished: boolean) {}
 }