Merge branch 'master' into rkaraivanov/copilot-instructions

Author: kdinev

.github/CONTRIBUTING.md

@@ -94,20 +94,31 @@ There are several ways to localize components' string resources:
     1.1. Localize a given instance of component - each component which supports localization has input property `resourceStrings`. Setting a newly instantiated object to this property will localize only that given component's instance.
     1.2. Localize all resources for a component type - each component which supports localization has input property `resourceStrings`. To localize all instances of a given component in the application the following steps should be performed - get the value of the input property `resourceStrings` of the component to be localized; do not create a new instance but replace the existing strings within the object. By default all components of a given type in an application share one instance of the resource strings. Replacing a value in that instance affects all components of that type in the application.
     1.3. Localize all resources for all components - use global method `getCurrentResourceStrings` to get an object containing current resource strings for all components. To provide localized resources just pass an object of type `IResourceStrings` to the global method `changei18n`.
+    1.4 As of 21.1.x the localization has new implementation and you can use the new API `registerI18n` to register resource string for a component or all components for the whole app, as well as which locale it corresponds to. To localize a single component you will need to get is corresponding resource string keys using one of the available resources and provide only those keys.
 
 2. Using npm package:
 We've created new repository which will hold the resource strings for languages different than English:
 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`  
+**NOTE** The localization repo has been moved to live inside the `igniteui-angular` repository under `./projects/igniteui-angular-i18n`
+**NOTE** As of 21.1.x the localization resource strings have been moved to the [`igniteui-i18n`](https://github.com/IgniteUI/igniteui-i18n) repository under `projects/igniteui-i18n-resources`.
 
 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:
+
+**Example:**
+
 Inside app.module you can perform:
-_import { IgxResouceStringsJA } from ‘igniteui-angular-i18n’;_
-And then:
-_Changei18n(IgxResouceStringsJA);_
+```ts
+import { IgxResouceStringsJA } from ‘igniteui-angular-i18n’;
+changei18n(IgxResouceStringsJA);
+```
+
+**Example new API:**
+```ts
+import { ResouceStringsJA } from ‘igniteui-i18n-resources’;
+registerI18n(IgxResouceStringsJA, 'ja');
+```
 
 ### Resource strings keys naming convention
 Each key in the `IResourceStrings` (and `IGridResourceStrings`, `ITimePickerResourceStrings`, etc.) is prefixed with components' selector and followed by the resource string key. Having components' selectors as prefixes allows us to have same resource strings keys for more than one component.

CHANGELOG.md

@@ -2,22 +2,81 @@
 
 All notable changes for each version of this project will be documented in this file.
 
-## 21.0.0
+## 21.1.0
 
-### Themes
+# Localization(i18n)
 
-- `IgxButton`
-    - **Breaking Change**
-        - The following shadow-related parameters were removed from the `outlined-button-theme` and `flat-button-theme`:
-            - `resting-shadow`
-            - `hover-shadow`
-            - `focus-shadow`
-            - `active-shadow`
+- `IgxActionStrip`, `IgxBanner`, `IgxCalendar`, `IgxCarousel`, `IgxChip`, `IgxCombo`, `IgxDatePicker`, `IgxDateRangePicker`, `IgxGrid`, `IgxTreeGrid`, `IgxHierarchicalGrid`, `IgxPivotGrid`, `IgxInputs`, `IgxList`, `IgxPaginator`, `IgxQueryBuilder`, `IgxTimePicker`, `IgxTree`
+  - New `Intl` implementation for all currently supported components that format and render data like dates and numbers.
+  - New localization implementation for the currently supported languages for all components that have resource strings in the currently supported languages.
+  - New public localization API and package named `igniteui-i18n-resources` containing the new resources that are used in conjunction.
+  - Added API to toggle off Angular's default formatting completely in favor of the new `Intl` implementation. Otherwise `Intl` will be used when a locale is not defined for Angular to use.
+  - Old resources and API should still remain working and not experience any change in behavior, despite internally using the new localization as well.
 
 ## 21.0.0
 
+### New Features
+
+- **New component** `IgxChat`:
+    - A component that provides complete solution for building conversational interfaces in your applications. Read up more information in the [ReadMe](https://github.com/IgniteUI/igniteui-angular/tree/master/projects/igniteui-angular/chat/README.md)
+
+- `IgxGrid`, `IgxTreeGrid`, `IgxHierarchicalGrid`
+    - Added PDF export functionality to grid components. Grids can now be exported to PDF format alongside the existing Excel and CSV export options.
+
+        The new `IgxPdfExporterService` follows the same pattern as Excel and CSV exporters:
+
+        ```ts
+        import { IgxPdfExporterService, IgxPdfExporterOptions } from 'igniteui-angular';
+
+        constructor(private pdfExporter: IgxPdfExporterService) {}
+        
+        exportToPdf() {
+            const options = new IgxPdfExporterOptions('MyGridExport');
+            options.pageOrientation = 'landscape'; // 'portrait' or 'landscape' (default: 'landscape')
+            options.pageSize = 'a4'; // 'a3', 'a4', 'a5', 'letter', 'legal', etc.
+            options.fontSize = 10;
+            options.showTableBorders = true;
+            
+            this.pdfExporter.export(this.grid, options);
+        }
+        ```
+
+        The grid toolbar exporter component now includes a PDF export button:
+
+        ```html
+        <igx-grid-toolbar>
+            <igx-grid-toolbar-exporter 
+                [exportPDF]="true" 
+                [exportExcel]="true" 
+                [exportCSV]="true">
+            </igx-grid-toolbar-exporter>
+        </igx-grid-toolbar>
+        ```
+
+        Key features:
+        - **Multi-page support** with automatic page breaks
+        - **Hierarchical visualization** for TreeGrid (with indentation) and HierarchicalGrid (with child tables)
+        - **Multi-level column headers** (column groups) support
+        - **Summary rows** with proper value formatting
+        - **Text truncation** with ellipsis for long content
+        - **Landscape orientation** by default (suitable for wide grids)
+        - **Internationalization** support for all 19 supported languages
+        - Respects all grid export options (ignoreFiltering, ignoreSorting, ignoreColumnsVisibility, etc.)
+
 ### Breaking Changes
 
+- `IgxButton`
+    - The following shadow-related parameters were removed from the `outlined-button-theme` and `flat-button-theme`:
+        - `resting-shadow`
+        - `hover-shadow`
+        - `focus-shadow`
+        - `active-shadow`
+
+#### Dependency Injection Refactor
+- All internal DI now uses the `inject()` API across `igniteui-angular` (no more constructor DI in library code).
+- If you extend our components/services or call their constructors directly, remove DI params and switch to `inject()` (e.g., `protected foo = inject(FooService);`).
+- App usage via templates remains the same; no action needed unless you subclass/override our types.
+
 #### Multiple Entry Points Support
 
 The library now supports multiple entry points for better tree-shaking and code splitting. While the main entry point (`igniteui-angular`) remains fully backwards compatible by re-exporting all granular entry points, we recommend migrating to the new entry points for optimal bundle sizes.
@@ -38,7 +97,7 @@ The `ng update` migration will prompt you to optionally migrate your imports to
 
 To migrate manually later:
 ```bash
-ng update igniteui-angular --migrate-only --from=20.1.0 --to=21.0.0 --migrate-imports
+ng update igniteui-angular --migrate-only --from=20.1.0 --to=21.0.0
 ```
 
 **Component Relocations:**
@@ -61,7 +120,6 @@ See the [Angular Package Format documentation](https://angular.io/guide/angular-
 ## 20.1.0
 
 ### New Features
-
 - `IgxGrid`, `IgxTreeGrid`, `IgxHierarchicalGrid`
     - Introduced a new cell merging feature that allows you to configure and merge cells in a column based on same data or other custom condition, into a single cell.
 

LICENSE

@@ -1,16 +1,134 @@
+=================================================================
+
+Dual License for Ignite UI for Angular
+
+=================================================================
+
+This software package is offered under a dual-license model, which allows for both commercial and permissive open-source use, depending on the components, modules, directives, and services being used.
+
+It is crucial to understand which license applies to which part of the package.
+
+-----------------------------------------------------------------
+
+MIT License
+
+-----------------------------------------------------------------
+
+The MIT License applies exclusively to the components (encompassing all related modules and directives), directives, and services listed below and their associated source code. **All other parts of this package remain under the Infragistics Commercial License.**
+
+**Covered Components, Directives and Services with MIT License:**
+
+- `igx-accordion`
+- `igxAutocomplete`
+- `igx-avatar`
+- `igx-badge`
+- `igx-banner`
+- `igx-bottom-nav`
+- `igx-button`
+- `igx-card`
+- `igx-carousel`
+- `igx-chat`
+- `igx-checkbox`
+- `igx-chip`
+- `igx-circular-bar`
+- `igx-combo`
+- `igx-date-picker`
+- `igx-date-range-picker`
+- `igx-dialog`
+- `igx-divider`
+- `igx-drop-down`
+- `igx-expansion-panel`
+- `igx-icon`
+- `igx-input-group`
+- `igx-linear-bar`
+- `igx-list`
+- `igx-navbar`
+- `igx-nav-drawer`
+- `igx-paginator`
+- `igx-radio`
+- `igx-radio-group`
+- `igx-rating`
+- `igx-select`
+- `igx-simple-combo`
+- `igx-slider`
+- `igx-snackbar`
+- `igx-splitter-pane`
+- `igx-switch`
+- `igx-tabs`
+- `igx-toast`
+- `igx-tooltip`
+- `igx-tree`
+- `igx-time-picker`
+- `igx-stepper`
+- `igx-month-picker`
+- `igx-action-strip`
+- `igx-buttongroup`
+- `igx-calendar`
+- `igx-chip-area`
+- `igxDateTimeEditor`
+- `igxDrag`
+- `igxDrop`
+- `igxFor`
+- `igxIconButton`
+- `igxInput`
+- `igxLabel`
+- `igxLayout`
+- `igxMask`
+- `igxRipple`
+- `IgxOverlayService`
+- `IgxTextHighlightDirective`
+- `IgxTextHighlightService`
+- `igxToggle`
+
+The MIT License applies exclusively to the components (encompassing all related modules and directives), directives, and services listed above and their associated source code. 
+All other parts of this package remain under the Infragistics Commercial License.
+
+The MIT License (MIT)
+
+Copyright (c) 2025 Infragistics
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+-----------------------------------------------------------------
+
+Infragistics Commercial License
+
+-----------------------------------------------------------------
+
+All components (encompassing all related modules and directives), modules, directives, services, and code within this package, **except those listed under the MIT License section above**, are licensed under the Infragistics Commercial License (EULA).
+
 This is a commercial product, requiring a valid paid-for license for commercial use.
 This product is free to use for non-commercial educational use for students in K through 12 grades
-or University programs, and for educators to use in a classroom setting as examples / tools in their curriculum.
+or University programs, and for educators to use in a classroom setting as examples/tools in their curriculum.
 
-In order for us to verify your eligibility for free usage, please register for trial at
-https://Infragistics.com/Angular and open a support ticket with a request for free license.
+To verify eligibility for free usage, please register for trial at:
+https://www.infragistics.com/angular and open a support ticket with a request for free license.
 
-To acquire a license for commercial usage, please register for trial at https://Infragistics.com/Angular
-and refer to the purchasing options in the pricing section on the product page.
+To acquire a license for commercial usage, please register for trial at:
+https://www.infragistics.com/angular and refer to the purchasing options in the pricing section on the product page.
 
 This repository includes code originally copied from https://github.com/zloirock/core-js
 in the projects/igniteui-angular/src/lib/core/setImmediate.ts file. The original version of the code is MIT licensed. See the file header for details.
 
 © Copyright 2025 INFRAGISTICS. All Rights Reserved.
 The Infragistics Ultimate license & copyright applies to this distribution.
-For information on that license, please go to our website https://www.infragistics.com/legal/license.
+For information on that license, please go to:
+https://www.infragistics.com/legal/license
+
+For details, see https://opensource.org/licenses/MIT