igniteui-angular 12.2.4 → 12.3.0-alpha.0

package/lib/combo/combo.pipes.d.ts

@@ -5,7 +5,7 @@ import { IComboFilteringOptions } from './combo.component';
  * @hidden
  */
 export declare class IgxComboFilteringPipe implements PipeTransform {
-    transform(collection: any[], searchValue: any, displayKey: any, shouldFilter: boolean, filteringOptions: IComboFilteringOptions): any[];
+    transform(collection: any[], searchValue: any, displayKey: any, filteringOptions: IComboFilteringOptions, shouldFilter?: boolean): any[];
 }
 /**
  * @hidden

package/lib/data-operations/data-util.d.ts

@@ -6,6 +6,7 @@ import { IGroupByKey } from './groupby-expand-state.interface';
 import { IGroupByRecord } from './groupby-record.interface';
 import { IGroupingState } from './groupby-state.interface';
 import { ISortingExpression } from './sorting-expression.interface';
+import { IGridGroupingStrategy } from './grouping-strategy';
 import { ITreeGridRecord } from '../grids/tree-grid/public_api';
 import { Transaction, HierarchicalTransaction } from '../services/transaction/transaction';
 import { GridType } from '../grids/common/grid.interface';
@@ -30,7 +31,7 @@ export declare class DataUtil {
     static sort<T>(data: T[], expressions: ISortingExpression[], sorting?: IGridSortingStrategy, grid?: GridType): T[];
     static treeGridSort(hierarchicalData: ITreeGridRecord[], expressions: ISortingExpression[], sorting?: IGridSortingStrategy, parent?: ITreeGridRecord, grid?: GridType): ITreeGridRecord[];
     static cloneTreeGridRecord(hierarchicalRecord: ITreeGridRecord): ITreeGridRecord;
-    static group<T>(data: T[], state: IGroupingState, grid?: GridType, groupsRecords?: any[], fullResult?: IGroupByResult): IGroupByResult;
+    static group<T>(data: T[], state: IGroupingState, grouping?: IGridGroupingStrategy, grid?: GridType, groupsRecords?: any[], fullResult?: IGroupByResult): IGroupByResult;
     static page<T>(data: T[], state: IPagingState, dataLength?: number): T[];
     static filter<T>(data: T[], state: IFilteringState, grid?: GridType): T[];
     static correctPagingState(state: IPagingState, length: number): void;

package/lib/data-operations/grouping-strategy.d.ts

@@ -1,6 +1,9 @@
-import { IgxSorting } from './sorting-strategy';
+import { IgxSorting, IGridSortingStrategy } from './sorting-strategy';
 import { IGroupingState } from './groupby-state.interface';
 import { IGroupByResult } from './grouping-result.interface';
-export declare class IgxGrouping extends IgxSorting {
+export interface IGridGroupingStrategy extends IGridSortingStrategy {
+    groupBy(data: any[], state: IGroupingState, grid?: any, groupsRecords?: any[], fullResult?: IGroupByResult): IGroupByResult;
+}
+export declare class IgxGrouping extends IgxSorting implements IGridGroupingStrategy {
     groupBy(data: any[], state: IGroupingState, grid?: any, groupsRecords?: any[], fullResult?: IGroupByResult): IGroupByResult;
 }

package/lib/grids/grid/grid.component.d.ts

@@ -13,6 +13,7 @@ import { IgxGroupByRowSelectorDirective } from '../selection/row-selectors';
 import { RowType } from '../common/row.interface';
 import { IgxGridGroupByAreaComponent } from '../grouping/grid-group-by-area.component';
 import { CellType } from '../common/cell.interface';
+import { IGridGroupingStrategy } from '../../data-operations/grouping-strategy';
 export interface IGroupingDoneEventArgs extends IBaseEventArgs {
     expressions: Array<ISortingExpression> | ISortingExpression;
     groupedColumns: Array<IgxColumnComponent> | IgxColumnComponent;
@@ -181,6 +182,10 @@ export declare class IgxGridComponent extends IgxGridBaseDirective implements Gr
      * @hidden
      */
     protected _groupAreaTemplate: TemplateRef<any>;
+    /**
+     * @hidden
+     */
+    protected _groupStrategy: IGridGroupingStrategy;
     /**
      * @hidden
      */
@@ -269,6 +274,18 @@ export declare class IgxGridComponent extends IgxGridBaseDirective implements Gr
      */
     get hideGroupedColumns(): boolean;
     set hideGroupedColumns(value: boolean);
+    /**
+     * Gets/Sets the grouping strategy of the grid.
+     *
+     * @remarks The default IgxGrouping extends from IgxSorting and a custom one can be used as a `sortStrategy` as well.
+     *
+     * @example
+     * ```html
+     *  <igx-grid #grid [data]="localData" [groupStrategy]="groupStrategy"></igx-grid>
+     * ```
+     */
+    get groupStrategy(): IGridGroupingStrategy;
+    set groupStrategy(value: IGridGroupingStrategy);
     /**
      * Gets/Sets the message displayed inside the GroupBy drop area where columns can be dragged on.
      *

package/lib/grids/grid/grid.pipes.d.ts

@@ -9,6 +9,7 @@ import { IgxGridBaseDirective } from '../grid-base.directive';
 import { GridType } from '../common/grid.interface';
 import { IFilteringStrategy } from '../../data-operations/filtering-strategy';
 import { IGridSortingStrategy } from '../../data-operations/sorting-strategy';
+import { IGridGroupingStrategy } from '../../data-operations/grouping-strategy';
 /**
  * @hidden
  */
@@ -23,7 +24,7 @@ export declare class IgxGridSortingPipe implements PipeTransform {
 export declare class IgxGridGroupingPipe implements PipeTransform {
     private gridAPI;
     constructor(gridAPI: GridBaseAPIService<IgxGridBaseDirective & GridType>);
-    transform(collection: any[], expression: IGroupingExpression | IGroupingExpression[], expansion: IGroupByExpandState | IGroupByExpandState[], defaultExpanded: boolean, id: string, groupsRecords: any[], _pipeTrigger: number): IGroupByResult;
+    transform(collection: any[], expression: IGroupingExpression | IGroupingExpression[], expansion: IGroupByExpandState | IGroupByExpandState[], groupingStrategy: IGridGroupingStrategy, defaultExpanded: boolean, id: string, groupsRecords: any[], _pipeTrigger: number): IGroupByResult;
 }
 /**
  * @hidden

package/lib/simple-combo/public_api.d.ts

@@ -0,0 +1 @@
+export * from './simple-combo.component';

package/lib/simple-combo/simple-combo.component.d.ts

@@ -0,0 +1,109 @@
+import { AfterViewInit, ChangeDetectorRef, ElementRef, EventEmitter, Injector } from '@angular/core';
+import { ControlValueAccessor } from '@angular/forms';
+import { IgxComboDropDownComponent } from '../combo/combo-dropdown.component';
+import { IgxComboAPIService } from '../combo/combo.api';
+import { IgxComboBaseDirective } from '../combo/combo.common';
+import { IDisplayDensityOptions } from '../core/displayDensity';
+import { IgxSelectionAPIService } from '../core/selection';
+import { CancelableEventArgs, IBaseEventArgs, PlatformUtil } from '../core/utils';
+import { IgxIconService } from '../icon/public_api';
+import { IgxInputGroupType } from '../input-group/public_api';
+/** Emitted when an igx-simple-combo's selection is changing.  */
+export interface ISimpleComboSelectionChangingEventArgs extends CancelableEventArgs, IBaseEventArgs {
+    /** An object which represents the value that is currently selected */
+    oldSelection: any;
+    /** An object which represents the value that will be selected after this event */
+    newSelection: any;
+    /** The text that will be displayed in the combo text box */
+    displayText: string;
+}
+/**
+ * Represents a drop-down list that provides filtering functionality, allowing users to choose a single option from a predefined list.
+ *
+ * @igxModule IgxSimpleComboModule
+ * @igxTheme igx-combo-theme
+ * @igxKeywords combobox, single combo selection
+ * @igxGroup Grids & Lists
+ *
+ * @remarks
+ * It provides the ability to filter items as well as perform single selection on the provided data.
+ * Additionally, it exposes keyboard navigation and custom styling capabilities.
+ * @example
+ * ```html
+ * <igx-simple-combo [itemsMaxHeight]="250" [data]="locationData"
+ *  [displayKey]="'field'" [valueKey]="'field'"
+ *  placeholder="Location" searchPlaceholder="Search...">
+ * </igx-simple-combo>
+ * ```
+ */
+export declare class IgxSimpleComboComponent extends IgxComboBaseDirective implements ControlValueAccessor, AfterViewInit {
+    protected elementRef: ElementRef;
+    protected cdr: ChangeDetectorRef;
+    protected selectionService: IgxSelectionAPIService;
+    protected comboAPI: IgxComboAPIService;
+    protected _iconService: IgxIconService;
+    private platformUtil;
+    protected _displayDensityOptions: IDisplayDensityOptions;
+    protected _inputGroupType: IgxInputGroupType;
+    protected _injector: Injector;
+    /** @hidden @internal */
+    dropdown: IgxComboDropDownComponent;
+    /**
+     * Emitted when item selection is changing, before the selection completes
+     *
+     * ```html
+     * <igx-simple-combo (selectionChanging)='handleSelection()'></igx-simple-combo>
+     * ```
+     */
+    selectionChanging: EventEmitter<ISimpleComboSelectionChangingEventArgs>;
+    /** @hidden @internal */
+    composing: boolean;
+    private _updateInput;
+    /** @hidden @internal */
+    get filteredData(): any[] | null;
+    /** @hidden @internal */
+    set filteredData(val: any[] | null);
+    constructor(elementRef: ElementRef, cdr: ChangeDetectorRef, selectionService: IgxSelectionAPIService, comboAPI: IgxComboAPIService, _iconService: IgxIconService, platformUtil: PlatformUtil, _displayDensityOptions: IDisplayDensityOptions, _inputGroupType: IgxInputGroupType, _injector: Injector);
+    /**
+     * Select a defined item
+     *
+     * @param item the item to be selected
+     * ```typescript
+     * this.combo.select("New York");
+     * ```
+     */
+    select(item: any): void;
+    /**
+     * Deselect a defined item
+     *
+     * @param item the items to be deselected
+     * ```typescript
+     * this.combo.deselect("New York");
+     * ```
+     */
+    deselect(item: any): void;
+    /** @hidden @internal */
+    writeValue(value: any): void;
+    /** @hidden @internal */
+    ngAfterViewInit(): void;
+    /** @hidden @internal */
+    handleInputChange(event?: any): void;
+    /** @hidden @internal */
+    handleKeyDown(event: KeyboardEvent): void;
+    /** @hidden @internal */
+    handleKeyUp(event: KeyboardEvent): void;
+    /** @hidden @internal */
+    getEditElement(): HTMLElement;
+    /** @hidden @internal */
+    handleClear(event: Event): void;
+    /** @hidden @internal */
+    handleOpened(): void;
+    /** @hidden @internal */
+    focusSearchInput(opening?: boolean): void;
+    protected findMatch: (element: any) => boolean;
+    protected setSelection(newSelection: any): void;
+    protected createDisplayText(newSelection: any[], oldSelection: any[]): any;
+    private clearSelection;
+}
+export declare class IgxSimpleComboModule {
+}

package/lib/toast/toast.component.d.ts

@@ -1,4 +1,4 @@
-import { ChangeDetectorRef, ElementRef, EventEmitter, OnInit } from '@angular/core';
+import { ChangeDetectorRef, ElementRef, EventEmitter, OnChanges, OnInit, SimpleChanges } from '@angular/core';
 import { IgxNavigationService } from '../core/navigation';
 import { IgxOverlayService, PositionSettings } from '../services/public_api';
 import { IgxNotificationsDirective } from '../directives/notification/notifications.directive';
@@ -31,7 +31,7 @@ export declare type IgxToastPosition = (typeof IgxToastPosition)[keyof typeof Ig
  * </igx-toast>
  * ```
  */
-export declare class IgxToastComponent extends IgxNotificationsDirective implements OnInit {
+export declare class IgxToastComponent extends IgxNotificationsDirective implements OnInit, OnChanges {
     private _element;
     /**
      * @hidden
@@ -77,7 +77,8 @@ export declare class IgxToastComponent extends IgxNotificationsDirective impleme
      *
      * @memberof IgxToastComponent
      */
-    position: IgxToastPosition;
+    get position(): IgxToastPosition;
+    set position(position: IgxToastPosition);
     /**
      * Get the position and animation settings used by the toast.
      * ```typescript
@@ -107,6 +108,7 @@ export declare class IgxToastComponent extends IgxNotificationsDirective impleme
      * ```
      */
     set positionSettings(settings: PositionSettings);
+    private _position;
     private _positionSettings;
     /**
      * Gets the nativeElement of the toast.
@@ -126,7 +128,7 @@ export declare class IgxToastComponent extends IgxNotificationsDirective impleme
      * this.toast.open();
      * ```
      */
-    open(message?: string): void;
+    open(message?: string, settings?: PositionSettings): void;
     /**
      * Opens or closes the toast, depending on its current state.
      *
@@ -139,6 +141,8 @@ export declare class IgxToastComponent extends IgxNotificationsDirective impleme
      * @hidden
      */
     ngOnInit(): void;
+    ngOnChanges(changes: SimpleChanges): void;
+    private calculatePosition;
 }
 /**
  * @hidden

package/migrations/migration-collection.json

@@ -105,6 +105,11 @@
             "version": "12.1.0",
             "description": "Updates Ignite UI for Angular from v11.1.x to v12.1.0",
             "factory": "./update-12_1_0"
+        },
+        "migration-22": {
+            "version": "12.3.0",
+            "description": "Updates Ignite UI for Angular from v12.1.x to v12.3.0",
+            "factory": "./update-12_3_0"
         }
     }
 }

package/migrations/update-12_3_0/changes/members.json

@@ -0,0 +1,26 @@
+{
+    "$schema": "../../common/schema/members-changes.schema.json",
+    "changes": [
+        {
+            "member": "selectItems",
+            "replaceWith": "select",
+            "definedIn": [
+                "IgxComboComponent"
+            ]
+        },
+        {
+            "member": "deselectItems",
+            "replaceWith": "deselect",
+            "definedIn": [
+                "IgxComboComponent"
+            ]
+        },
+        {
+            "member": "selectedItems()",
+            "replaceWith": "selection",
+            "definedIn": [
+                "IgxComboBaseDirective"
+            ]
+        }
+    ]
+}

package/migrations/update-12_3_0/index.d.ts

@@ -0,0 +1,3 @@
+import { Rule } from '@angular-devkit/schematics';
+declare const _default: () => Rule;
+export default _default;

package/migrations/update-12_3_0/index.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const UpdateChanges_1 = require("../common/UpdateChanges");
+const version = '12.3.0';
+exports.default = () => (host, context) => {
+    context.logger.info(`Applying migration for Ignite UI for Angular to version ${version}`);
+    const update = new UpdateChanges_1.UpdateChanges(__dirname, host, context);
+    update.applyChanges();
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "igniteui-angular",
-  "version": "12.2.4",
+  "version": "12.3.0-alpha.0",
   "description": "Ignite UI for Angular is a dependency-free Angular toolkit for building modern web apps",
   "author": "Infragistics",
   "license": "SEE LICENSE IN LICENSE",

package/public_api.d.ts

@@ -55,6 +55,7 @@ export * from './lib/carousel/public_api';
 export * from './lib/checkbox/checkbox.component';
 export * from './lib/chips/public_api';
 export * from './lib/combo/public_api';
+export * from './lib/simple-combo/public_api';
 export * from './lib/date-picker/public_api';
 export * from './lib/dialog/dialog.component';
 export * from './lib/drop-down/public_api';