igniteui-angular 12.1.4 → 12.1.8

package/lib/core/i18n/resources.d.ts

@@ -13,6 +13,15 @@ export interface IResourceStrings extends IGridResourceStrings, ITimePickerResou
 }
 /**
  * @hidden
+ * IF YOU EDIT THIS OBJECT, DO NOT FORGET TO UPDATE
+ * projects/igniteui-angular-i18n as well (create the appropriately named files,
+ * containing the new/updated component string keys and EN strings for values + create a separate issue + pending-localization label)
+ *
+ * TODO Add automation tests:
+ * 1) each of the folders/languages under \projects\igniteui-angular-i18n\src\ contain resources.ts file with matching components count.
+ *    \projects\igniteui-angular-i18n\src\BG\resources.ts contains IgxResourceStringsBG.count matching this.CurrentResourceStrings.count
+ * 2) \igniteui-angular\projects\igniteui-angular\src\public_api.ts --> Check if the new interface is added
+ *    to IInputResourceStrings (just a proxy as it is later on imported in the angular-i18n package)
  */
 export declare const CurrentResourceStrings: {
     GridResStrings: any;

package/lib/core/utils.d.ts

@@ -236,6 +236,7 @@ export declare const resolveNestedPath: (obj: any, path: string) => any;
  */
 export declare const reverseMapper: (path: string, value: any) => {};
 export declare const yieldingLoop: (count: number, chunkSize: number, callback: (index: number) => void, done: () => void) => void;
+export declare const isConstructor: (ref: any) => boolean;
 export declare const reverseAnimationResolver: (animation: AnimationReferenceMetadata) => AnimationReferenceMetadata;
 export declare const isHorizontalAnimation: (animation: AnimationReferenceMetadata) => boolean;
 export declare const isVerticalAnimation: (animation: AnimationReferenceMetadata) => boolean;

package/lib/date-picker/date-picker.component.d.ts

@@ -1,4 +1,4 @@
-import { EventEmitter, OnDestroy, ElementRef, NgModuleRef, OnInit, AfterViewInit, Injector, AfterViewChecked, QueryList, Renderer2, PipeTransform } from '@angular/core';
+import { EventEmitter, OnDestroy, ElementRef, NgModuleRef, OnInit, AfterViewInit, Injector, AfterViewChecked, QueryList, Renderer2, PipeTransform, ChangeDetectorRef } from '@angular/core';
 import { ControlValueAccessor, AbstractControl, ValidationErrors, Validator } from '@angular/forms';
 import { WEEKDAYS, IFormattingViews, IFormattingOptions } from '../calendar/public_api';
 import { IgxLabelDirective, IgxInputGroupType } from '../input-group/public_api';
@@ -33,6 +33,7 @@ export declare class IgxDatePickerComponent extends PickerBaseDirective implemen
     private _injector;
     private _renderer;
     private platform;
+    private cdr;
     protected _displayDensityOptions?: IDisplayDensityOptions;
     protected _inputGroupType?: IgxInputGroupType;
     /**
@@ -296,7 +297,7 @@ export declare class IgxDatePickerComponent extends PickerBaseDirective implemen
     private _onChangeCallback;
     private _onTouchedCallback;
     private _onValidatorChange;
-    constructor(element: ElementRef<HTMLElement>, _localeId: string, _overlayService: IgxOverlayService, _moduleRef: NgModuleRef<any>, _injector: Injector, _renderer: Renderer2, platform: PlatformUtil, _displayDensityOptions?: IDisplayDensityOptions, _inputGroupType?: IgxInputGroupType);
+    constructor(element: ElementRef<HTMLElement>, _localeId: string, _overlayService: IgxOverlayService, _moduleRef: NgModuleRef<any>, _injector: Injector, _renderer: Renderer2, platform: PlatformUtil, cdr: ChangeDetectorRef, _displayDensityOptions?: IDisplayDensityOptions, _inputGroupType?: IgxInputGroupType);
     /** @hidden @internal */
     get required(): boolean;
     /** @hidden @internal */

package/lib/directives/notification/notifications.directive.d.ts

@@ -1,7 +1,7 @@
 import { ElementRef, OnDestroy } from '@angular/core';
 import { Subject } from 'rxjs';
 import { IToggleView } from '../../core/navigation';
-import { IPositionStrategy, OverlaySettings } from '../../services/public_api';
+import { IPositionStrategy } from '../../services/public_api';
 import { IgxOverlayOutletDirective, IgxToggleDirective } from '../toggle/toggle.directive';
 export declare abstract class IgxNotificationsDirective extends IgxToggleDirective implements IToggleView, OnDestroy {
     /**
@@ -37,7 +37,7 @@ export declare abstract class IgxNotificationsDirective extends IgxToggleDirecti
      * @hidden
      * @internal
      */
-    textMessage: string | OverlaySettings;
+    textMessage: string;
     /**
      * @hidden
      */

package/lib/grids/api.service.d.ts

@@ -28,6 +28,13 @@ export declare class GridBaseAPIService<T extends IgxGridBaseDirective & GridTyp
     get_row_index_in_data(rowID: any, dataCollection?: any[]): number;
     get_row_by_key(rowSelector: any): IgxRowDirective<IgxGridBaseDirective & GridType>;
     get_row_by_index(rowIndex: number): IgxRowDirective<IgxGridBaseDirective & GridType>;
+    /**
+     * Gets the rowID of the record at the specified data view index
+     *
+     * @param index
+     * @param dataCollection
+     */
+    get_rec_id_by_index(index: number, dataCollection?: any[]): any;
     get_cell_by_key(rowSelector: any, field: string): IgxGridCellComponent;
     get_cell_by_index(rowIndex: number, columnID: number | string): IgxGridCellComponent;
     get_cell_by_visible_index(rowIndex: number, columnIndex: number): IgxGridCellComponent;
@@ -49,6 +56,13 @@ export declare class GridBaseAPIService<T extends IgxGridBaseDirective & GridTyp
     get_row_expansion_state(record: any): boolean;
     set_row_expansion_state(rowID: any, expanded: boolean, event?: Event): void;
     get_rec_by_id(rowID: any): any;
+    /**
+     * Returns the index of the record in the data view by pk or -1 if not found or primaryKey is not set.
+     *
+     * @param pk
+     * @param dataCollection
+     */
+    get_rec_index_by_id(pk: string | number, dataCollection?: any[]): number;
     allow_expansion_state_change(rowID: any, expanded: any): boolean;
     prepare_sorting_expression(stateCollections: Array<Array<any>>, expression: ISortingExpression): void;
     remove_grouping_expression(_fieldName: any): void;

package/lib/grids/grid-base.directive.d.ts

@@ -1869,6 +1869,7 @@ export declare abstract class IgxGridBaseDirective extends DisplayDensityBase im
     private rowEditPositioningStrategy;
     private rowEditSettings;
     private transactionChange$;
+    private _rendered;
     private readonly DRAG_SCROLL_DELTA;
     /**
      * @hidden @internal
@@ -2267,15 +2268,20 @@ export declare abstract class IgxGridBaseDirective extends DisplayDensityBase im
      * @hidden @internal
      */
     get summariesMargin(): number;
+    /**
+     * @hidden
+     * @internal
+     */
+    get columns(): IgxColumnComponent[];
     /**
      * Gets an array of `IgxColumnComponent`s.
      *
      * @example
      * ```typescript
-     * const colums = this.grid.columns.
+     * const colums = this.grid.columnsCollection.
      * ```
      */
-    get columns(): IgxColumnComponent[];
+    get columnsCollection(): IgxColumnComponent[];
     /**
      * Gets an array of the pinned `IgxColumnComponent`s.
      *
@@ -3200,6 +3206,36 @@ export declare abstract class IgxGridBaseDirective extends DisplayDensityBase im
      * @param commit
      */
     endEdit(commit?: boolean, event?: Event): void;
+    /**
+     * Enters add mode by spawning the UI under the specified row by rowID.
+     *
+     * @remarks
+     * If null is passed as rowID, the row adding UI is spawned as the first record in the data view
+     * @remarks
+     * Spawning the UI to add a child for a record only works if you provide a rowID
+     * @example
+     * ```typescript
+     * this.grid.beginAddRowById('ALFKI');
+     * this.grid.beginAddRowById('ALFKI', true);
+     * this.grid.beginAddRowById(null);
+     * ```
+     * @param rowID - The rowID to spawn the add row UI for, or null to spawn it as the first record in the data view
+     * @param asChild - Whether the record should be added as a child. Only applicable to igxTreeGrid.
+     */
+    beginAddRowById(rowID: any, asChild?: boolean): void;
+    /**
+     * Enters add mode by spawning the UI at the specified index.
+     *
+     * @remarks
+     * Accepted values for index are integers from 0 to this.grid.dataView.length
+     * @example
+     * ```typescript
+     * this.grid.beginAddRowByIndex(0);
+     * ```
+     * @param index - The index to spawn the UI at. Accepts integers from 0 to this.grid.dataView.length
+     */
+    beginAddRowByIndex(index: number): void;
+    protected beginAddRowForIndex(index: number, asChild?: boolean): void;
     protected switchTransactionService(val: boolean): void;
     protected subscribeToTransactions(): void;
     protected transactionStatusUpdate(event: StateUpdateEvent): void;

package/lib/grids/tree-grid/tree-grid-api.service.d.ts

@@ -15,6 +15,20 @@ export declare class IgxTreeGridAPIService extends GridBaseAPIService<IgxTreeGri
     get_selected_children(record: ITreeGridRecord, selectedRowIDs: any[]): void;
     row_deleted_transaction(rowID: any): boolean;
     get_rec_by_id(rowID: any): ITreeGridRecord;
+    /**
+     * Gets the rowID of the record at the specified data view index
+     *
+     * @param index
+     * @param dataCollection
+     */
+    get_rec_id_by_index(index: number, dataCollection?: any[]): any;
+    /**
+     * Returns the index of the record in the data view by pk or -1 if not found or primaryKey is not set.
+     *
+     * @param pk
+     * @param dataCollection
+     */
+    get_rec_index_by_id(pk: string | number, dataCollection?: any[]): number;
     addRowToData(data: any, parentRowID?: any): void;
     filterDataByExpressions(expressionsTree: IFilteringExpressionsTree): any[];
     protected update_row_in_array(value: any, rowID: any, index: number): void;

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

@@ -336,6 +336,26 @@ export declare class IgxTreeGridComponent extends IgxGridBaseDirective implement
      * @memberof IgxTreeGridComponent
      */
     addRow(data: any, parentRowID?: any): void;
+    /**
+     * Enters add mode by spawning the UI with the context of the specified row by index.
+     *
+     * @remarks
+     * Accepted values for index are integers from 0 to this.grid.dataView.length
+     * @remarks
+     * When adding the row as a child, the parent row is the specified row.
+     * @remarks
+     * To spawn the UI on top, call the function with index = null or a negative number.
+     * In this case trying to add this row as a child will result in error.
+     * @example
+     * ```typescript
+     * this.grid.beginAddRowByIndex(10);
+     * this.grid.beginAddRowByIndex(10, true);
+     * this.grid.beginAddRowByIndex(null);
+     * ```
+     * @param index - The index to spawn the UI at. Accepts integers from 0 to this.grid.dataView.length
+     * @param asChild - Whether the record should be added as a child. Only applicable to igxTreeGrid.
+     */
+    beginAddRowByIndex(index: number, asChild?: boolean): void;
     /**
      * @hidden
      */

package/lib/snackbar/snackbar.component.d.ts

@@ -1,5 +1,5 @@
 import { EventEmitter, OnInit } from '@angular/core';
-import { OverlaySettings } from '../services/public_api';
+import { PositionSettings } from '../services/public_api';
 import { IgxNotificationsDirective } from '../directives/notification/notifications.directive';
 import { ToggleViewEventArgs } from '../directives/toggle/toggle.directive';
 /**
@@ -71,13 +71,52 @@ export declare class IgxSnackbarComponent extends IgxNotificationsDirective impl
      * ```
      */
     animationDone: EventEmitter<ToggleViewEventArgs>;
+    /**
+     * Get the position and animation settings used by the snackbar.
+     * ```typescript
+     * @ViewChild('snackbar', { static: true }) public snackbar: IgxSnackbarComponent;
+     * let currentPosition: PositionSettings = this.snackbar.positionSettings
+     * ```
+     */
+    get positionSettings(): PositionSettings;
+    /**
+     * Set the position and animation settings used by the snackbar.
+     * ```html
+     * <igx-snackbar [positionSettings]="newPositionSettings"></igx-snackbar>
+     * ```
+     * ```typescript
+     * import { slideInTop, slideOutBottom } from 'igniteui-angular';
+     * ...
+     * @ViewChild('snackbar', { static: true }) public snackbar: IgxSnackbarComponent;
+     *  public newPositionSettings: PositionSettings = {
+     *      openAnimation: useAnimation(slideInTop, { params: { duration: '1000ms', fromPosition: 'translateY(100%)'}}),
+     *      closeAnimation: useAnimation(slideOutBottom, { params: { duration: '1000ms', fromPosition: 'translateY(0)'}}),
+     *      horizontalDirection: HorizontalAlignment.Left,
+     *      verticalDirection: VerticalAlignment.Middle,
+     *      horizontalStartPoint: HorizontalAlignment.Left,
+     *      verticalStartPoint: VerticalAlignment.Middle,
+     *      minSize: { height: 100, width: 100 }
+     *  };
+     * this.snackbar.positionSettings = this.newPositionSettings;
+     * ```
+     */
+    set positionSettings(settings: PositionSettings);
+    private _positionSettings;
     /**
      * Shows the snackbar and hides it after the `displayTime` is over if `autoHide` is set to `true`.
      * ```typescript
      * this.snackbar.open();
      * ```
      */
-    open(message?: string | OverlaySettings): void;
+    open(message?: string): void;
+    /**
+     * Opens or closes the snackbar, depending on its current state.
+     *
+     * ```typescript
+     * this.snackbar.toggle();
+     * ```
+     */
+    toggle(): void;
     /**
      * @hidden
      */

package/lib/tabs/tabs.directive.d.ts

@@ -17,8 +17,6 @@ export interface ITabsSelectedItemChangeEventArgs extends ITabsBaseEventArgs {
     readonly newItem: IgxTabItemDirective;
 }
 export declare abstract class IgxTabsDirective extends IgxCarouselComponentBase implements IgxTabsBase, AfterViewInit, OnDestroy {
-    /** @hidden */
-    role: string;
     /**
      * An @Input property that gets/sets the index of the selected item.
      * Default value is 0 if contents are defined otherwise defaults to -1.

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

@@ -1,6 +1,6 @@
 import { ChangeDetectorRef, ElementRef, EventEmitter, OnInit } from '@angular/core';
 import { IgxNavigationService } from '../core/navigation';
-import { IgxOverlayService, OverlaySettings } from '../services/public_api';
+import { IgxOverlayService, PositionSettings } from '../services/public_api';
 import { IgxNotificationsDirective } from '../directives/notification/notifications.directive';
 import { ToggleViewEventArgs } from '../directives/toggle/toggle.directive';
 /**
@@ -78,6 +78,36 @@ export declare class IgxToastComponent extends IgxNotificationsDirective impleme
      * @memberof IgxToastComponent
      */
     position: IgxToastPosition;
+    /**
+     * Get the position and animation settings used by the toast.
+     * ```typescript
+     * @ViewChild('toast', { static: true }) public toast: IgxToastComponent;
+     * let currentPosition: PositionSettings = this.toast.positionSettings
+     * ```
+     */
+    get positionSettings(): PositionSettings;
+    /**
+     * Set the position and animation settings used by the toast.
+     * ```html
+     * <igx-toast [positionSettings]="newPositionSettings"></igx-toast>
+     * ```
+     * ```typescript
+     * import { slideInTop, slideOutBottom } from 'igniteui-angular';
+     * ...
+     * @ViewChild('toast', { static: true }) public toast: IgxToastComponent;
+     *  public newPositionSettings: PositionSettings = {
+     *      openAnimation: useAnimation(slideInTop, { params: { duration: '1000ms', fromPosition: 'translateY(100%)'}}),
+     *      closeAnimation: useAnimation(slideOutBottom, { params: { duration: '1000ms', fromPosition: 'translateY(0)'}}),
+     *      horizontalDirection: HorizontalAlignment.Left,
+     *      verticalDirection: VerticalAlignment.Middle,
+     *      horizontalStartPoint: HorizontalAlignment.Left,
+     *      verticalStartPoint: VerticalAlignment.Middle
+     *  };
+     * this.toast.positionSettings = this.newPositionSettings;
+     * ```
+     */
+    set positionSettings(settings: PositionSettings);
+    private _positionSettings;
     /**
      * Gets the nativeElement of the toast.
      * ```typescript
@@ -96,7 +126,15 @@ export declare class IgxToastComponent extends IgxNotificationsDirective impleme
      * this.toast.open();
      * ```
      */
-    open(message?: string | OverlaySettings): void;
+    open(message?: string): void;
+    /**
+     * Opens or closes the toast, depending on its current state.
+     *
+     * ```typescript
+     * this.toast.toggle();
+     * ```
+     */
+    toggle(): void;
     /**
      * @hidden
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "igniteui-angular",
-  "version": "12.1.4",
+  "version": "12.1.8",
   "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

@@ -113,5 +113,7 @@ export { IDatePickerResourceStrings } from './lib/core/i18n/date-picker-resource
 export { IDateRangePickerResourceStrings } from './lib/core/i18n/date-range-picker-resources';
 export { IListResourceStrings } from './lib/core/i18n/list-resources';
 export { ITreeResourceStrings } from './lib/core/i18n/tree-resources';
+export { IInputResourceStrings } from './lib/core/i18n/input-resources';
+export { IChipResourceStrings } from './lib/core/i18n/chip-resources';
 export { PickerInteractionMode } from './lib/date-common/types';
 export { SplitterType } from './lib/splitter/splitter.component';