chore(*): Merging with master

Author: kdinev

CHANGELOG.md

@@ -49,6 +49,7 @@ For more detailed information, see the [README](https://github.com/IgniteUI/igni
     - A new boolean `hideGroupedColumns` input controls whether the grouped columns should be hidden as well (defaults to false).
     - **Breaking change** `cellClasses` input on `IgxColumnComponent` now accepts an object literal to allow conditional cell styling.
     - Exposing a mechanism for cells to grow according to their content.
+    - `sortStrategy` input exposed to provide custom sort strategy for the `IgxColumnComponent`. The custom strategy should implement the `ISortingStrategy` interface, or can extend the base `SortingStrategy` class and override all or some of its public/protected members.
 - `igxFor`
     - Added support for variable heights.
 - `igx-datePicker` selector is deprecated. Use `igx-date-picker` selector instead.
@@ -155,6 +156,8 @@ When you focus a specific cell and press one of the following key combinations,
 
 ## 6.1.8
 
+### General
+
 ### Bug fixes
 
 - Fix sorting and groupby expression not syncing when there are already sorted columns. #2786

gulpfile.js

@@ -247,6 +247,10 @@ gulp.task('typedoc-build:doc:ja:localization', ['typedoc-build', 'typedoc:clean-
     shell.task(`typedoc ${TYPEDOC.PROJECT_PATH} --generate-from-json ${TYPEDOC.OUTPUT_PATH}/${TYPEDOC.REPO.TRANSLATIONS_REPO_NAME}/ja/ --templateStrings ${TYPEDOC.TEMPLATE_STRINGS_PATH} --localize jp`)
 );
 
+gulp.task('typedoc-build:doc:en:localization', ['typedoc-build', 'typedoc:clean-docs-dir', 'typedoc:copy-translations'],
+    shell.task(`typedoc ${TYPEDOC.PROJECT_PATH} --generate-from-json ${TYPEDOC.OUTPUT_PATH}/${TYPEDOC.REPO.TRANSLATIONS_REPO_NAME}/en/`)
+);
+
 gulp.task('typedoc-serve', ['typedoc-watch'], () => {
     browserSync.init({
         server: './dist/igniteui-angular/docs/typescript'

projects/igniteui-angular/src/lib/calendar/calendar.component.spec.ts

@@ -22,6 +22,7 @@ import {
     IgxCalendarSubheaderTemplateDirective
 } from './calendar.directives';
 import { DateRangeDescriptor, DateRangeType } from '../core/dates/dateRange';
+import { isDate } from 'util';
 
 let NEXT_ID = 0;
 
@@ -830,6 +831,10 @@ export class IgxCalendarComponent implements OnInit, ControlValueAccessor {
      *```
      */
     public selectDate(value: Date | Date[]) {
+        if (value === null || value === undefined || (Array.isArray(value) && value.length === 0)) {
+            throw new Error('Date or array should be set for the selectDate method.');
+        }
+
         switch (this.selection) {
             case 'single':
                 this.selectSingle(value as Date);
@@ -850,8 +855,13 @@ export class IgxCalendarComponent implements OnInit, ControlValueAccessor {
      *````
      */
     public deselectDate(value?: Date | Date[]) {
+        if (this.selectedDates === null || this.selectedDates === []) {
+            return;
+        }
+
         if (value === null || value === undefined) {
             this.selectedDates = this.selection === 'single' ? null : [];
+            this._onChangeCallback(this.selectedDates);
             return;
         }
 
@@ -1164,8 +1174,8 @@ export class IgxCalendarComponent implements OnInit, ControlValueAccessor {
         if (Array.isArray(value)) {
             this.rangeStarted = false;
             value.sort((a: Date, b: Date) => a.valueOf() - b.valueOf());
-            start = this.getDateOnly(value.shift());
-            end = this.getDateOnly(value.pop());
+            start = this.getDateOnly(value[0]);
+            end = this.getDateOnly(value[value.length - 1]);
             this.selectedDates = [start, ...this.generateDateRange(start, end)];
         } else {
             if (!this.rangeStarted) {
@@ -1201,7 +1211,7 @@ export class IgxCalendarComponent implements OnInit, ControlValueAccessor {
      * @hidden
      */
     private deselectSingle(value: Date) {
-        if (this.selectedDates !== null && value !== null &&
+        if (this.selectedDates !== null &&
             this.getDateOnlyInMs(value as Date) === this.getDateOnlyInMs(this.selectedDates)) {
             this.selectedDates = null;
             this._onChangeCallback(this.selectedDates);
@@ -1213,10 +1223,6 @@ export class IgxCalendarComponent implements OnInit, ControlValueAccessor {
      * @hidden
      */
     private deselectMultiple(value: Date[]) {
-        if (value === null) {
-            return;
-        }
-
         value = value.filter(v => v !== null);
         const selectedDatesCount = this.selectedDates.length;
         const datesInMsToDeselect: Set<number> = new Set<number>(
@@ -1238,21 +1244,23 @@ export class IgxCalendarComponent implements OnInit, ControlValueAccessor {
      * @hidden
      */
     private deselectRange(value: Date[]) {
-        if (value === null) {
-            return;
-        }
-
-        value = value.filter(v => v !== null);
-        if (value.length < 2) {
+        value = value.filter(v => v !== null && isDate(v));
+        if (value.length < 1) {
             return;
         }
 
         value.sort((a: Date, b: Date) => a.valueOf() - b.valueOf());
-        const start = this.getDateOnly(value.shift());
-        const end = this.getDateOnly(value.pop());
+        const valueStart = this.getDateOnlyInMs(value[0]);
+        const valueEnd = this.getDateOnlyInMs(value[value.length - 1]);
+
+        this.selectedDates.sort((a: Date, b: Date) => a.valueOf() - b.valueOf());
+        const selectedDatesStart = this.getDateOnlyInMs(this.selectedDates[0]);
+        const selectedDatesEnd = this.getDateOnlyInMs(this.selectedDates[this.selectedDates.length - 1]);
 
-        const deselectRange = [start, ...this.generateDateRange(start, end)];
-        this.deselectMultiple(deselectRange);
+        if (!(valueEnd < selectedDatesStart) && !(valueStart > selectedDatesEnd)) {
+            this.selectedDates = [];
+            this._onChangeCallback(this.selectedDates);
+        }
     }
 
     /**

projects/igniteui-angular/src/lib/calendar/calendar.component.ts

@@ -401,5 +401,9 @@
         @return map-get($themes, $theme);
     }
 
-    @return call(get-function(#{$theme}-theme));
+    @if (function-exists('get-function')) {
+        @return call(get-function(#{$theme}-theme));
+    } @else {
+        @return call((#{$theme}-theme));
+    }
 }

projects/igniteui-angular/src/lib/core/styles/base/utilities/_functions.scss

@@ -87,6 +87,20 @@ export function isDate(value: any) {
     return Object.prototype.toString.call(value) === '[object Date]';
 }
 
+/**
+ * Cehcks if the two passed arguments are equal
+ * Currently supports date objects
+ * @param obj1
+ * @param obj2
+ * @returns: `boolean`
+ */
+export function isEqual(obj1, obj2): boolean {
+    if (isDate(obj1) && isDate(obj2)) {
+        return obj1.getTime() === obj2.getTime();
+    }
+    return obj1 === obj2;
+}
+
 /**
  *@hidden
  */

projects/igniteui-angular/src/lib/core/utils.ts

@@ -1,3 +1,5 @@
+import { ISortingStrategy } from './sorting-strategy';
+
 /**
  * Represents sorting expressions.
  */
@@ -11,4 +13,5 @@ export interface ISortingExpression {
    fieldName: string;
    dir: SortingDirection;
    ignoreCase?: boolean;
+   strategy?: ISortingStrategy;
 }

projects/igniteui-angular/src/lib/data-operations/sorting-expression.interface.ts

@@ -38,14 +38,18 @@ export class SortingStrategy implements ISortingStrategy {
         }
         return a > b ? 1 : a < b ? -1 : 0;
     }
-    protected compareObjects(obj1: object, obj2: object, key: string, reverse: number, ignoreCase: boolean) {
+    protected compareObjects(obj1: object, obj2: object, key: string, reverse: number, ignoreCase: boolean, strategy: ISortingStrategy) {
         let a = obj1[key];
         let b = obj2[key];
         if (ignoreCase) {
             a = a && a.toLowerCase ? a.toLowerCase() : a;
             b = b && b.toLowerCase ? b.toLowerCase() : b;
         }
-        return reverse * this.compareValues(a, b);
+        if (strategy) {
+            return reverse * strategy.compareValues(a, b);
+        } else {
+            return reverse * this.compareValues(a, b);
+        }
     }
     protected arraySort<T>(data: T[], compareFn?): T[] {
         return data.sort(compareFn);
@@ -78,7 +82,7 @@ export class SortingStrategy implements ISortingStrategy {
             false;
         const reverse = (expression.dir === SortingDirection.Desc ? -1 : 1);
         const cmpFunc = (obj1, obj2) => {
-            return this.compareObjects(obj1, obj2, key, reverse, ignoreCase);
+            return this.compareObjects(obj1, obj2, key, reverse, ignoreCase, expression.strategy);
         };
         return this.arraySort(data, cmpFunc);
     }

projects/igniteui-angular/src/lib/data-operations/sorting-strategy.ts

@@ -33,10 +33,9 @@ let NEXT_ID = 0;
  *
  * @export
  */
-export interface ISelectionEventArgs {
+export interface ISelectionEventArgs extends CancelableEventArgs {
     oldSelection: IgxDropDownItemBase;
     newSelection: IgxDropDownItemBase;
-    cancel: boolean;
 }
 
 /** @hidden */
@@ -419,7 +418,7 @@ export class IgxDropDownBase implements OnInit, IToggleView {
      * @hidden
      */
     onToggleOpening(e: CancelableEventArgs) {
-        const eventArgs = { cancel: false};
+        const eventArgs = { cancel: false };
         this.onOpening.emit(eventArgs);
         e.cancel = eventArgs.cancel;
         if (eventArgs.cancel) {
@@ -449,7 +448,7 @@ export class IgxDropDownBase implements OnInit, IToggleView {
      * @hidden
      */
     onToggleClosing(e: CancelableEventArgs) {
-        const eventArgs = { cancel: false};
+        const eventArgs = { cancel: false };
         this.onClosing.emit(eventArgs);
         e.cancel = eventArgs.cancel;
     }
@@ -605,7 +604,7 @@ export class IgxDropDownItemNavigationDirective {
             const key = event.code ? event.code.toLowerCase() : event.key.toLowerCase();
             if (!this.target.collapsed) { // If dropdown is opened
                 const navKeys = ['esc', 'escape', 'enter', 'tab', 'space', 'spacebar',
-            'arrowup', 'up', 'arrowdown', 'down', 'home', 'end'];
+                    'arrowup', 'up', 'arrowdown', 'down', 'home', 'end'];
                 if (navKeys.indexOf(key) === -1) { // If key has appropriate function in DD
                     return;
                 }

projects/igniteui-angular/src/lib/drop-down/drop-down.component.ts

@@ -278,6 +278,7 @@ Inputs available on the **IgxGridColumnComponent** to define columns:
 |`field`|string|Column field name|
 |`header`|string|Column header text|
 |`sortable`|boolean|Set column to be sorted or not|
+|`sortStrategy`| Provide custom sort strategy to be used when sorting|
 |`editable`|boolean|Set column values to be editable|
 |`filterable`|boolean|Set column values to be filterable|
 |`hasSummary`| boolean  |Sets whether or not the specific column has summaries enabled.|