Merge branch 'master' into patch-2

Author: kdinev

.github/CONTRIBUTING.md

@@ -12,7 +12,7 @@ In order to perform all the necessary checks before pulling your changes in, you
     npm install
     npm test
 
-[Naming Convention](../../../wiki/General-Naming-Guidelines-for-Ignite-UI-for-Angular)  
+[General Naming and Coding Guidelines](../../../wiki/General-Naming-and-Coding-Guidelines-for-Ignite-UI-for-Angular)  
 [CSS Naming Convention](../css-naming-convention.md)  
 
 # Workflow
@@ -101,7 +101,7 @@ https://github.com/IgniteUI/igniteui-angular-i18n
 
 **NOTE** The localization repo has been moved to live inside the `igniteui-angular` repository under `./projects/igniteui-angular-i18n`  
 
-A npm package should be published each time we release new version of IgniteUI for Angular. Its version should correspond to the version of the igniteui-angular npm package.
+A npm package should be published each time we release new version of Ignite UI for Angular. Its version should correspond to the version of the igniteui-angular npm package.
 One could localize an application by importing the corresponding localized resource strings from the localization package (`igniteui-angular-i18n`) and use the methods described in the previous bullet to localize the whole application or part of it.
 Example:
 Inside app.module you can perform:
@@ -178,30 +178,32 @@ if (isDevMode()) {
 `
 Write migrations.
 
-## Deprecating methods
-When a method is deprecated a few steps have to be done:
-1. Add the `@deprecated` tag at the begging of the method description followed by the version in which the method has been deprecated and what can be used instead. Example:
-```ts
-/**
- * @deprecated in version 12.1.0. Use 'data' instead
- *
- * The data record that populates the row
- */
-public getRowData(): any {
-    return this.data;
-}
-```
-2. Ensure that the deprecated method is no longer used in IgniteUI for Angular codebase, samples and documentation snippets.
-3. Write migrations.
-
-## Deprecating class properties
-When a class property is deprecated a few steps have to be done:
-1. Add the `@deprecated` tag at the begging of the property description followed by the version in which the property has been deprecated and what can be used instead.
-2. Ensure that the deprecated property is no longer used in IgniteUI for Angular codebase, samples and documentation snippets.
+## Deprecating members
+When a property or method is deprecated a few steps have to be done:
+1. Add the `@deprecated` tag after the member description (since it's a block tag), followed by the version in which the member has been deprecated and what can be used instead. Example:
+    ```ts
+    /**
+     * Enables selecting multiple buttons.
+     *
+     * @deprecated in version 16.1.0. Use the `selectionMode` property instead.
+     */
+    @Input()
+    public get multiSelection() { /* ... */ }
+    public set multiSelection(value: boolean) { /* ... */ }
+
+    /**
+     * The data record that populates the row
+     *
+     * @deprecated in version 12.1.0. Use the `data` property instead.
+     */
+    public getRowData(): any {
+        return this.data;
+    }
+    ```
+    Note: Use full specific version followed by full stop and if possible keep the alternative use short and in the same line.
+2. Ensure that the deprecated member is no longer used in Ignite UI for Angular codebase, samples and documentation snippets.
 3. Write migrations.
 
-NOTE: TypeScript disallows adding descriptions to both the get and set accessor for a single member. Instead, the description for the member must be applied to the first accessor specified in document order. Having this in mind the `@deprecated` tag is applied only once.
-
 # Testing a PR
 In order to test a pull request that is awaiting test, perform the following actions.
 

.vscode/extensions.json

@@ -0,0 +1,13 @@
+{
+    // See https://go.microsoft.com/fwlink/?LinkId=827846 to learn about workspace recommendations.
+    // Extension identifier format: ${publisher}.${name}. Example: vscode.csharp
+    // List of extensions which should be recommended for users of this workspace.
+    "recommendations": [
+        "editorconfig.editorconfig",
+        "dbaeumer.vscode-eslint",
+        "angular.ng-template",
+        "streetsidesoftware.code-spell-checker"
+    ],
+    // List of extensions recommended by VS Code that should not be recommended for users of this workspace.
+    "unwantedRecommendations": []
+}

CHANGELOG.md

@@ -2,6 +2,19 @@
 
 All notable changes for each version of this project will be documented in this file.
 
+## 17.2.0
+### New Features
+- `IgxCalendar`
+    - Completely revamped calendar themes.
+    - New years view.
+    - Updated months view.
+    - Updated keyboard navigation and accessibility.
+    - Added selection preview in range selection mode.
+    - Added the ability to change the orientation of the calendar when multiple day views are present.
+    - Replaced the `vertical` property with `orientation` that can be set to either `horizontal`(default) or `vertical`.
+    - Standalone views support full-blown keyboard navigation, accessibility improvements and the ability to change pages automatically on keyboard navigation.
+    - Standalone views now emit `pageChanged` event whenever the active view page changes.
+
 ## 17.1.0
 ### New Features
 - `IgxGrid`, `IgxTreeGrid`, `IgxHierarchicalGrid`

README.md

@@ -12,7 +12,7 @@
 [![npm version](https://badge.fury.io/js/igniteui-angular.svg)](https://badge.fury.io/js/igniteui-angular)
 [![Discord](https://img.shields.io/discord/836634487483269200?logo=discord&logoColor=ffffff)](https://discord.gg/39MjrTRqds)
 
-[Ignite UI for Angular](https://www.infragistics.com/products/ignite-ui-angular) is a complete set of Material-based UI Widgets, Components & Sketch, Adobe XD and Figma [UI kits](https://www.infragistics.com/products/appbuilder/ui-toolkit) by Infragistics. Ignite UI for Angular is designed to enable developers to build enterprise-ready, high-performance HTML5 & JavaScript apps for modern desktop browsers. With the use of all features, the world’s fastest Angular grid, 60+ real-time Angular charts, and more, you are empowered to engineer excellent mobile experiences and deliver progressive web apps (PWA’s) using Google's [Angular](https://angular.io/) framework.
+[Ignite UI for Angular](https://www.infragistics.com/products/ignite-ui-angular) is a complete library of Angular-native, Material-based Angular UI components designed to enable developers to build enterprise-ready HTML5 & JavaScript apps for modern desktop browsers. It packs full-featured components, including Pivot Grids, Dock Manager, Hierarchical Grid, Bottom Navigation, etc., 60+ high-performance Angular Charts for all business needs and any app scenario, and more.
 
 You can find source files under the [`src`](https://github.com/IgniteUI/igniteui-angular/tree/master/src) folder, including samples and tests.
 Or visit [Ignite UI for Angular Discord](https://discord.com/channels/836634487483269200/836636712292581456) and join the dev community there.

ROADMAP.md

@@ -2,30 +2,28 @@
 
 # Current Milestone
 
-## Milestone 29, (Due by Feb, 2024)
+## Milestone 30, (Due by Apr, 2024)
 
-1. Improve package tree-shaking [#13562](https://github.com/IgniteUI/igniteui-angular/issues/13562)
-2. Deprecate rowID and rowData in interfaces [#10617](https://github.com/IgniteUI/igniteui-angular/issues/10617)
-3. Update calendar theme to match material [#10400](https://github.com/IgniteUI/igniteui-angular/issues/10400)
-4. Calendar: Default date formatting in the header [#13811](https://github.com/IgniteUI/igniteui-angular/issues/13811)
-5. Component: Icon Button [#13590](https://github.com/IgniteUI/igniteui-angular/issues/13590)  
+1. Update calendar theme to match material [#10400](https://github.com/IgniteUI/igniteui-angular/issues/10400)
+2. Calendar: Default date formatting in the header [#13811](https://github.com/IgniteUI/igniteui-angular/issues/13811)
+3. Button: States and size improvements request [#1033](https://github.com/IgniteUI/igniteui-angular/issues/1033)
+4. Provide a way to replace part of (or all) icons used by components with icons from other icon sets [#13987](https://github.com/IgniteUI/igniteui-angular/issues/13987)
+5. Date/datetime/time editors should accept the same formats that the angular pipes accept [#14011](https://github.com/IgniteUI/igniteui-angular/issues/14011)
 
 ## Going down the road
 
-1. Scheduler component [#8097](https://github.com/IgniteUI/igniteui-angular/issues/8097)
-2. Rework default sorting/filtering strategy's and their methods to be grid agnostic [#10922](https://github.com/IgniteUI/igniteui-angular/issues/10922) 
-3. PDF Export feature on Angular Grid [#5696](https://github.com/IgniteUI/igniteui-angular/issues/5696)
-4. Getting only one sort and one filter event after changing the state of grid using setState function [#8064](https://github.com/IgniteUI/igniteui-angular/issues/8064)
-5. Grid Cell Merging [#3514](https://github.com/IgniteUI/igniteui-angular/issues/3514) 
-6. Classes to indicate position of auto overlay [#9481](https://github.com/IgniteUI/igniteui-angular/issues/9481) 
-7. Switch overlay service from angular animations to native Web Animations [#8780](https://github.com/IgniteUI/igniteui-angular/issues/8780)
-8. Suggestion for igx-grid group by row template [#12752](https://github.com/IgniteUI/igniteui-angular/issues/12752)
-9. Way to filter auto-generated columns [#12577](https://github.com/IgniteUI/igniteui-angular/issues/12577)
-10. IgxDateRangePicker UX improvement [#11994](https://github.com/IgniteUI/igniteui-angular/issues/11994)
-11. Resizing [IgxDrag] [#6283](https://github.com/IgniteUI/igniteui-angular/issues/6283)
+1. Grid: Remove deprecated usage of displayDensity [#14015](https://github.com/IgniteUI/igniteui-angular/issues/14015)
+2. Expose a header template for the chip area of the headers of the rows dimension in the pivot grid [#14016](https://github.com/IgniteUI/igniteui-angular/issues/14016)
 
 # Previous Milestone
 
+## Milestone 29, version 17.1 (Released Feb 26th, 2024)
+
+1. Improve package tree-shaking [#13562](https://github.com/IgniteUI/igniteui-angular/issues/13562)
+2. Deprecate rowID and rowData in interfaces [#10617](https://github.com/IgniteUI/igniteui-angular/issues/10617)
+3. Component: Icon Button [#13590](https://github.com/IgniteUI/igniteui-angular/issues/13590)
+4. HammerJS is now an optional dependency
+
 ## Milestone 28, version 17.0 (Released Nov 9th, 2023) [Release Blog 17.0](https://www.infragistics.com/community/blogs/b/infragistics/posts/ignite-ui-for-angular-17-0-0)
 
 1. **[DONE]** Support of Angular 17

package-lock.json

@@ -61,16 +61,16 @@
     "@angular/compiler": "^17.2.1",
     "@angular/core": "^17.2.1",
     "@angular/forms": "^17.2.1",
-    "@angular/platform-browser-dynamic": "^17.2.1",
     "@angular/platform-browser": "^17.2.1",
+    "@angular/platform-browser-dynamic": "^17.2.1",
     "@angular/platform-server": "^17.2.1",
     "@angular/router": "^17.2.1",
     "@angular/ssr": "^17.2.0",
     "@igniteui/material-icons-extended": "^3.0.0",
     "@types/source-map": "0.5.2",
     "express": "^4.19.2",
     "fflate": "^0.8.1",
-    "igniteui-theming": "^5.0.1",
+    "igniteui-theming": "^6.0.1",
     "igniteui-trial-watermark": "^3.0.2",
     "lodash-es": "^4.17.21",
     "rxjs": "^7.8.0",
@@ -82,8 +82,8 @@
     "@angular-devkit/build-angular": "^17.2.0",
     "@angular-devkit/schematics": "^17.2.0",
     "@angular-eslint/builder": "^17.2.1",
-    "@angular-eslint/eslint-plugin-template": "^17.2.1",
     "@angular-eslint/eslint-plugin": "^17.2.1",
+    "@angular-eslint/eslint-plugin-template": "^17.2.1",
     "@angular-eslint/schematics": "^17.2.1",
     "@angular-eslint/template-parser": "^17.2.1",
     "@angular/cli": "^17.2.0",
@@ -105,39 +105,39 @@
     "eslint": "^8.53.0",
     "fs-extra": "^11.1.1",
     "globby": "^13.2.2",
+    "gulp": "^4.0.2",
     "gulp-cached": "^1.1.1",
     "gulp-concat": "^2.6.1",
     "gulp-shell": "^0.6.5",
     "gulp-typescript": "^5.0.1",
     "gulp-uglify": "^3.0.1",
-    "gulp": "^4.0.2",
     "hammer-simulator": "0.0.1",
     "hammerjs": "^2.0.8",
     "ig-typedoc-theme": "^5.0.3",
     "igniteui-sassdoc-theme": "^1.2.3",
     "igniteui-webcomponents": "^4.7.0",
-    "jasmine-core": "~5.1.2",
     "jasmine": "^5.1.0",
+    "jasmine-core": "~5.1.2",
+    "karma": "^6.4.2",
     "karma-chrome-launcher": "~3.2.0",
     "karma-coverage": "^2.0.3",
     "karma-jasmine": "~5.1.0",
     "karma-junit-reporter": "^2.0.1",
     "karma-parallel": "^0.3.1",
     "karma-spec-reporter": "^0.0.36",
-    "karma": "^6.4.2",
     "ng-packagr": "^17.2.0",
-    "postcss-scss": "^4.0.6",
     "postcss": "^8.4.31",
+    "postcss-scss": "^4.0.6",
     "puppeteer": "^22.1.0",
     "sass-embedded": "^1.69.1",
     "sass-true": "^6.0.1",
-    "sassdoc-plugin-localization": "^1.4.3",
     "sassdoc": "^2.7.4",
-    "stylelint-scss": "^4.1.0",
+    "sassdoc-plugin-localization": "^1.4.3",
     "stylelint": "^15.1.0",
+    "stylelint-scss": "^4.1.0",
     "ts-node": "^10.8.1",
-    "typedoc-plugin-localization": "^3.0.4",
     "typedoc": "^0.25.3",
+    "typedoc-plugin-localization": "^3.0.4",
     "typescript": "5.2.2"
   }
 }

package.json

@@ -4,10 +4,18 @@ import { ICalendarResourceStrings } from 'igniteui-angular';
 const CalendarResourceStringsBG_: ExpandRequire<ICalendarResourceStrings> = {
     igx_calendar_previous_month: 'Предходен месец',
     igx_calendar_next_month: 'Следващ месец',
+    igx_calendar_previous_year: 'Предходна година',
+    igx_calendar_next_year: 'Следваща година',
+    igx_calendar_previous_years: 'Предходни {0} години',
+    igx_calendar_next_years: 'Следващи {0} години',
+    igx_calendar_select_date: 'Избор на дата',
     igx_calendar_select_month: 'Избор на месец',
     igx_calendar_select_year: 'Избор на година',
     igx_calendar_range_start: 'Начало на диапазона',
     igx_calendar_range_end: 'Край на диапазона',
+    igx_calendar_range_label_start: 'Начало',
+    igx_calendar_range_label_end: 'Край',
+    igx_calendar_range_placeholder: 'Избери диапазон',
     igx_calendar_selected_month_is: 'Избраният месец е ',
     igx_calendar_first_picker_of: 'Първия селектор от {0} започва от',
     igx_calendar_multi_selection: 'Календар с множествен избор с {0} избирачи на дати',

projects/igniteui-angular-i18n/src/i18n/BG/calendar-resources.ts

@@ -4,10 +4,18 @@ import { ICalendarResourceStrings } from 'igniteui-angular';
 const CalendarResourceStringsCS_: ExpandRequire<ICalendarResourceStrings> = {
     igx_calendar_previous_month: 'Předchozí měsíc',
     igx_calendar_next_month: 'Příští měsíc',
+    igx_calendar_previous_year: 'Previous Year',
+    igx_calendar_next_year: 'Next Year',
+    igx_calendar_previous_years: 'Previous {0} Years',
+    igx_calendar_next_years: 'Next {0} Years',
+    igx_calendar_select_date: 'Select Date',
     igx_calendar_select_month: 'Vyberte měsíc',
     igx_calendar_select_year: 'Vyberte rok',
     igx_calendar_range_start: 'Začátek dosahu',
     igx_calendar_range_end: 'Konec rozsahu',
+    igx_calendar_range_label_start: 'Start',
+    igx_calendar_range_label_end: 'End',
+    igx_calendar_range_placeholder: 'Select Range',
     igx_calendar_selected_month_is: 'Vybraný měsíc je ',
     igx_calendar_first_picker_of: 'První výběr z {0} začíná od',
     igx_calendar_multi_selection: 'Kalendář s více výběry s {0} nástroji pro výběr data',

projects/igniteui-angular-i18n/src/i18n/CS/calendar-resources.ts

@@ -4,10 +4,18 @@ import { ICalendarResourceStrings } from 'igniteui-angular';
 const CalendarResourceStringsDA_: ExpandRequire<ICalendarResourceStrings> = {
     igx_calendar_previous_month: 'Forrige måned',
     igx_calendar_next_month: 'Næste måned',
+    igx_calendar_previous_year: 'Previous Year',
+    igx_calendar_next_year: 'Next Year',
+    igx_calendar_previous_years: 'Previous {0} Years',
+    igx_calendar_next_years: 'Next {0} Years',
+    igx_calendar_select_date: 'Select Date',
     igx_calendar_select_month: 'Vælg måned',
     igx_calendar_select_year: 'Vælg år',
     igx_calendar_range_start: 'Interval start',
     igx_calendar_range_end: 'Interval slut',
+    igx_calendar_range_label_start: 'Start',
+    igx_calendar_range_label_end: 'End',
+    igx_calendar_range_placeholder: 'Select Range',
     igx_calendar_selected_month_is: 'Den valgte måned er ',
     igx_calendar_first_picker_of: 'Første vælger af {0} starter fra',
     igx_calendar_multi_selection: 'Kalender med flere markeringer med {0} datovælgere',