cps-ui-kit 21.25.0 → 21.27.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cps-ui-kit",
-  "version": "21.25.0",
+  "version": "21.27.0",
   "peerDependencies": {
     "@angular/common": "^21.2.6",
     "@angular/core": "^21.2.6",

package/types/cps-ui-kit.d.ts

@@ -1,5 +1,5 @@
 import * as i0 from '@angular/core';
-import { OnChanges, InjectionToken, PipeTransform, OnDestroy, AfterViewInit, ElementRef, Renderer2, ChangeDetectorRef, EventEmitter, NgZone, SimpleChanges, OnInit, QueryList, TemplateRef, AfterContentInit, AfterViewChecked, ComponentRef, ViewContainerRef, Type, ApplicationRef, EnvironmentInjector, Injector, Signal } from '@angular/core';
+import { OnInit, OnChanges, SimpleChanges, InjectionToken, PipeTransform, OnDestroy, AfterViewInit, ElementRef, Renderer2, ChangeDetectorRef, EventEmitter, NgZone, QueryList, TemplateRef, AfterContentInit, AfterViewChecked, ComponentRef, ViewContainerRef, Type, ApplicationRef, EnvironmentInjector, Injector, Signal } from '@angular/core';
 import { ControlValueAccessor, NgControl, FormGroup } from '@angular/forms';
 import { AnimationEvent, AnimationBuilder } from '@angular/animations';
 import { OverlayService, SortEvent, FilterMetadata, SelectItem, TreeNode } from 'primeng/api';
@@ -32,8 +32,7 @@ type iconSizeType = number | string | 'fill' | 'xsmall' | 'small' | 'normal' | '
  * CpsIconComponent is a component that is used for icons.
  * @group Components
  */
-declare class CpsIconComponent implements OnChanges {
-    private document;
+declare class CpsIconComponent implements OnInit, OnChanges {
     /**
      * Name of the icon.
      * @group Props
@@ -49,15 +48,31 @@ declare class CpsIconComponent implements OnChanges {
      * @group Props
      */
     color: string;
+    /**
+     * Accessible label for the icon.
+     * When provided the icon is treated as informative (role="img", aria-hidden removed).
+     * When omitted the icon is treated as decorative (aria-hidden="true", role removed).
+     * @group Props
+     * @default ''
+     */
+    set ariaLabel(v: string);
+    get ariaLabel(): string;
+    private _ariaLabel;
+    hasAriaLabel(): boolean;
     iconColor: string;
     url: string;
     cvtSize: string;
     classesList: string[];
-    constructor(document: Document);
-    ngOnChanges(): void;
+    private _document;
+    private _elementRef;
+    private _renderer;
+    private _staticAriaLabel;
+    ngOnInit(): void;
+    ngOnChanges(changes: SimpleChanges): void;
+    private _syncAriaLabel;
     setClasses(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<CpsIconComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<CpsIconComponent, "cps-icon", never, { "icon": { "alias": "icon"; "required": false; }; "size": { "alias": "size"; "required": false; }; "color": { "alias": "color"; "required": false; }; }, {}, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<CpsIconComponent, "cps-icon", never, { "icon": { "alias": "icon"; "required": false; }; "size": { "alias": "size"; "required": false; }; "color": { "alias": "color"; "required": false; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; }; }, {}, never, never, true, never>;
 }
 
 declare class LabelByValuePipe implements PipeTransform {
@@ -962,7 +977,6 @@ declare class CpsButtonComponent implements OnInit, OnChanges {
 declare class CpsCheckboxComponent implements OnInit, OnChanges, ControlValueAccessor {
     private _control;
     private document;
-    private _elementRef;
     /**
      * Label of the checkbox.
      * @group Props
@@ -1027,7 +1041,8 @@ declare class CpsCheckboxComponent implements OnInit, OnChanges, ControlValueAcc
      */
     valueChanged: EventEmitter<boolean>;
     private _value;
-    constructor(_control: NgControl, document: Document, _elementRef: ElementRef<HTMLElement>);
+    checkboxInput?: ElementRef<HTMLInputElement>;
+    constructor(_control: NgControl, document: Document);
     ngOnInit(): void;
     ngOnChanges(): void;
     onChange: (_event: any) => void;
@@ -1039,7 +1054,7 @@ declare class CpsCheckboxComponent implements OnInit, OnChanges, ControlValueAcc
     private _updateValue;
     setDisabledState(_disabled: boolean): void;
     focus(): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<CpsCheckboxComponent, [{ optional: true; self: true; }, null, null]>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CpsCheckboxComponent, [{ optional: true; self: true; }, null]>;
     static ɵcmp: i0.ɵɵComponentDeclaration<CpsCheckboxComponent, "cps-checkbox", never, { "label": { "alias": "label"; "required": false; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "infoTooltip": { "alias": "infoTooltip"; "required": false; }; "infoTooltipClass": { "alias": "infoTooltipClass"; "required": false; }; "infoTooltipMaxWidth": { "alias": "infoTooltipMaxWidth"; "required": false; }; "infoTooltipPersistent": { "alias": "infoTooltipPersistent"; "required": false; }; "infoTooltipPosition": { "alias": "infoTooltipPosition"; "required": false; }; "icon": { "alias": "icon"; "required": false; }; "iconColor": { "alias": "iconColor"; "required": false; }; "value": { "alias": "value"; "required": false; }; }, { "valueChanged": "valueChanged"; }, never, never, true, never>;
 }
 
@@ -1119,6 +1134,26 @@ declare class CpsInputComponent implements ControlValueAccessor, OnInit, OnChang
      * @group Props
      */
     ariaLabel: string;
+    /**
+     * WAI-ARIA role for the native input element.
+     * @group Props
+     */
+    inputRole: string | null;
+    /**
+     * Whether the element controlled by this input is expanded.
+     * @group Props
+     */
+    ariaExpanded: boolean | null;
+    /**
+     * Type of popup element the input controls.
+     * @group Props
+     */
+    ariaHasPopup: string | null;
+    /**
+     * ID of the element controlled by this input.
+     * @group Props
+     */
+    ariaControls: string | null;
     /**
      * Bottom hint text for the input field.
      * @group Props
@@ -1320,7 +1355,7 @@ declare class CpsInputComponent implements ControlValueAccessor, OnInit, OnChang
     onInputMousedown(): void;
     focus(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<CpsInputComponent, [{ optional: true; self: true; }, null]>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<CpsInputComponent, "cps-input", never, { "label": { "alias": "label"; "required": false; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; }; "hint": { "alias": "hint"; "required": false; }; "placeholder": { "alias": "placeholder"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "readonly": { "alias": "readonly"; "required": false; }; "autocomplete": { "alias": "autocomplete"; "required": false; }; "spellcheck": { "alias": "spellcheck"; "required": false; }; "width": { "alias": "width"; "required": false; }; "type": { "alias": "type"; "required": false; }; "loading": { "alias": "loading"; "required": false; }; "clearable": { "alias": "clearable"; "required": false; }; "prefixIcon": { "alias": "prefixIcon"; "required": false; }; "prefixIconClickable": { "alias": "prefixIconClickable"; "required": false; }; "prefixIconSize": { "alias": "prefixIconSize"; "required": false; }; "prefixIconAriaLabel": { "alias": "prefixIconAriaLabel"; "required": false; }; "prefixText": { "alias": "prefixText"; "required": false; }; "hideDetails": { "alias": "hideDetails"; "required": false; }; "persistentClear": { "alias": "persistentClear"; "required": false; }; "error": { "alias": "error"; "required": false; }; "infoTooltip": { "alias": "infoTooltip"; "required": false; }; "infoTooltipClass": { "alias": "infoTooltipClass"; "required": false; }; "infoTooltipMaxWidth": { "alias": "infoTooltipMaxWidth"; "required": false; }; "infoTooltipPersistent": { "alias": "infoTooltipPersistent"; "required": false; }; "infoTooltipPosition": { "alias": "infoTooltipPosition"; "required": false; }; "appearance": { "alias": "appearance"; "required": false; }; "valueToDisplay": { "alias": "valueToDisplay"; "required": false; }; "value": { "alias": "value"; "required": false; }; }, { "valueChanged": "valueChanged"; "focused": "focused"; "prefixIconClicked": "prefixIconClicked"; "blurred": "blurred"; "cleared": "cleared"; "enterClicked": "enterClicked"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<CpsInputComponent, "cps-input", never, { "label": { "alias": "label"; "required": false; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; }; "inputRole": { "alias": "inputRole"; "required": false; }; "ariaExpanded": { "alias": "ariaExpanded"; "required": false; }; "ariaHasPopup": { "alias": "ariaHasPopup"; "required": false; }; "ariaControls": { "alias": "ariaControls"; "required": false; }; "hint": { "alias": "hint"; "required": false; }; "placeholder": { "alias": "placeholder"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "readonly": { "alias": "readonly"; "required": false; }; "autocomplete": { "alias": "autocomplete"; "required": false; }; "spellcheck": { "alias": "spellcheck"; "required": false; }; "width": { "alias": "width"; "required": false; }; "type": { "alias": "type"; "required": false; }; "loading": { "alias": "loading"; "required": false; }; "clearable": { "alias": "clearable"; "required": false; }; "prefixIcon": { "alias": "prefixIcon"; "required": false; }; "prefixIconClickable": { "alias": "prefixIconClickable"; "required": false; }; "prefixIconSize": { "alias": "prefixIconSize"; "required": false; }; "prefixIconAriaLabel": { "alias": "prefixIconAriaLabel"; "required": false; }; "prefixText": { "alias": "prefixText"; "required": false; }; "hideDetails": { "alias": "hideDetails"; "required": false; }; "persistentClear": { "alias": "persistentClear"; "required": false; }; "error": { "alias": "error"; "required": false; }; "infoTooltip": { "alias": "infoTooltip"; "required": false; }; "infoTooltipClass": { "alias": "infoTooltipClass"; "required": false; }; "infoTooltipMaxWidth": { "alias": "infoTooltipMaxWidth"; "required": false; }; "infoTooltipPersistent": { "alias": "infoTooltipPersistent"; "required": false; }; "infoTooltipPosition": { "alias": "infoTooltipPosition"; "required": false; }; "appearance": { "alias": "appearance"; "required": false; }; "valueToDisplay": { "alias": "valueToDisplay"; "required": false; }; "value": { "alias": "value"; "required": false; }; }, { "valueChanged": "valueChanged"; "focused": "focused"; "prefixIconClicked": "prefixIconClicked"; "blurred": "blurred"; "cleared": "cleared"; "enterClicked": "enterClicked"; }, never, never, true, never>;
 }
 
 /**
@@ -1328,6 +1363,11 @@ declare class CpsInputComponent implements ControlValueAccessor, OnInit, OnChang
  * @group Types
  */
 type CpsDatepickerAppearanceType = 'outlined' | 'underlined' | 'borderless';
+/**
+ * CpsDatepickerDateFormat defines the display and input format of the date string.
+ * @group Types
+ */
+type CpsDatepickerDateFormat = 'DD/MM/YYYY' | 'MM/DD/YYYY' | 'YYYY/MM/DD';
 /**
  * CpsDatepickerComponent is an input component to provide date input.
  * @group Components
@@ -1355,7 +1395,12 @@ declare class CpsDatepickerComponent implements ControlValueAccessor, OnInit, On
      */
     width: number | string;
     /**
-     * Placeholder text.
+     * Date format for displaying and parsing the date string.
+     * @group Props
+     */
+    dateFormat: CpsDatepickerDateFormat;
+    /**
+     * Placeholder text. Defaults to the configured dateFormat.
      * @group Props
      */
     placeholder: string;
@@ -1423,12 +1468,12 @@ declare class CpsDatepickerComponent implements ControlValueAccessor, OnInit, On
      * Minimal date availalbe for selection.
      * @group Props
      */
-    minDate: Date;
+    minDate: Date | undefined;
     /**
      * Maximal date availalbe for selection.
      * @group Props
      */
-    maxDate: Date;
+    maxDate: Date | undefined;
     /**
      * Value of the datepicker.
      * @default null
@@ -1444,16 +1489,24 @@ declare class CpsDatepickerComponent implements ControlValueAccessor, OnInit, On
     valueChanged: EventEmitter<Date | null>;
     datepickerInput: CpsInputComponent;
     calendarMenu: CpsMenuComponent;
+    private _datepicker;
+    readonly calendarId: string;
     stringDate: string;
     isOpened: boolean;
     error: string;
     cvtWidth: string;
     private _statusChangesSubscription?;
     private _value;
+    private _focusCalendarOnOpen;
+    private _suppressNextContentClick;
+    private _captureKeydown;
+    private _calendarContainer;
     constructor(_control: NgControl);
     ngOnInit(): void;
-    ngOnChanges(): void;
+    ngOnChanges(changes: SimpleChanges): void;
     ngOnDestroy(): void;
+    private _removeCalendarListeners;
+    private _onCaptureKeydown;
     onChange: (_event: any) => void;
     onTouched: () => void;
     registerOnChange(fn: any): void;
@@ -1462,24 +1515,31 @@ declare class CpsDatepickerComponent implements ControlValueAccessor, OnInit, On
     writeValue(value: Date | null): void;
     private _updateValue;
     private _updateValueFromInputString;
+    private _parseFormatParts;
     private _checkDateFormat;
     private _checkDateInRange;
     private _dateToString;
     private _stringToDate;
     private _checkErrors;
-    onClearCalendarDate(): void;
     onSelectCalendarDate(dateVal: Date | null): void;
     onInputBlur(): void;
     onInputFocus(): void;
+    onInputKeydown(event: KeyboardEvent): void;
     onInputEnterClicked(): void;
     onClickCalendarIcon(): void;
-    onBeforeCalendarHidden(): void;
+    onCalendarClick(_event: MouseEvent): void;
+    onYearSelected(): void;
+    private _initFocusableViewCell;
+    onCalendarMenuShown(): void;
+    private _focusActiveCalendarCell;
+    onDatepickerMonthChange(): void;
+    onBeforeCalendarHidden(reason: CpsMenuHideReason): void;
     onInputClear(): void;
     onCalendarContentClick(): void;
     focusInput(): void;
-    toggleCalendar(show?: boolean): void;
+    toggleCalendar(show?: boolean, needFocusInput?: boolean): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<CpsDatepickerComponent, [{ optional: true; self: true; }]>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<CpsDatepickerComponent, "cps-datepicker", never, { "label": { "alias": "label"; "required": false; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "width": { "alias": "width"; "required": false; }; "placeholder": { "alias": "placeholder"; "required": false; }; "hint": { "alias": "hint"; "required": false; }; "clearable": { "alias": "clearable"; "required": false; }; "hideDetails": { "alias": "hideDetails"; "required": false; }; "persistentClear": { "alias": "persistentClear"; "required": false; }; "showTodayButton": { "alias": "showTodayButton"; "required": false; }; "openOnInputFocus": { "alias": "openOnInputFocus"; "required": false; }; "infoTooltip": { "alias": "infoTooltip"; "required": false; }; "infoTooltipClass": { "alias": "infoTooltipClass"; "required": false; }; "infoTooltipMaxWidth": { "alias": "infoTooltipMaxWidth"; "required": false; }; "infoTooltipPersistent": { "alias": "infoTooltipPersistent"; "required": false; }; "infoTooltipPosition": { "alias": "infoTooltipPosition"; "required": false; }; "appearance": { "alias": "appearance"; "required": false; }; "minDate": { "alias": "minDate"; "required": false; }; "maxDate": { "alias": "maxDate"; "required": false; }; "value": { "alias": "value"; "required": false; }; }, { "valueChanged": "valueChanged"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<CpsDatepickerComponent, "cps-datepicker", never, { "label": { "alias": "label"; "required": false; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "width": { "alias": "width"; "required": false; }; "dateFormat": { "alias": "dateFormat"; "required": false; }; "placeholder": { "alias": "placeholder"; "required": false; }; "hint": { "alias": "hint"; "required": false; }; "clearable": { "alias": "clearable"; "required": false; }; "hideDetails": { "alias": "hideDetails"; "required": false; }; "persistentClear": { "alias": "persistentClear"; "required": false; }; "showTodayButton": { "alias": "showTodayButton"; "required": false; }; "openOnInputFocus": { "alias": "openOnInputFocus"; "required": false; }; "infoTooltip": { "alias": "infoTooltip"; "required": false; }; "infoTooltipClass": { "alias": "infoTooltipClass"; "required": false; }; "infoTooltipMaxWidth": { "alias": "infoTooltipMaxWidth"; "required": false; }; "infoTooltipPersistent": { "alias": "infoTooltipPersistent"; "required": false; }; "infoTooltipPosition": { "alias": "infoTooltipPosition"; "required": false; }; "appearance": { "alias": "appearance"; "required": false; }; "minDate": { "alias": "minDate"; "required": false; }; "maxDate": { "alias": "maxDate"; "required": false; }; "value": { "alias": "value"; "required": false; }; }, { "valueChanged": "valueChanged"; }, never, never, true, never>;
 }
 
 /**
@@ -1492,7 +1552,6 @@ type CpsDividerType = 'solid' | 'dashed' | 'dotted';
  * @group Components
  */
 declare class CpsDividerComponent {
-    private document;
     /**
      * Determines whether the divider is vertically aligned.
      * @group Props
@@ -1514,10 +1573,10 @@ declare class CpsDividerComponent {
     /**
      * Thickness of the divider, a number denoting pixels or a string.
      * @group Props
-     * @default 1px
+     * @default 0.0625rem
      */
     thickness: i0.InputSignal<string | number>;
-    constructor(document: Document);
+    private document;
     borderTop: i0.Signal<string>;
     borderRight: i0.Signal<string>;
     private _constructBorder;
@@ -1529,7 +1588,7 @@ declare class CpsDividerComponent {
  * CpsExpansionPanelComponent is a component that provides content on expansion.
  * @group Components
  */
-declare class CpsExpansionPanelComponent implements OnInit, AfterViewInit {
+declare class CpsExpansionPanelComponent implements OnInit, OnChanges, AfterViewInit {
     private _animationBuilder;
     private document;
     private _renderer;
@@ -1564,7 +1623,7 @@ declare class CpsExpansionPanelComponent implements OnInit, AfterViewInit {
      */
     bordered: boolean;
     /**
-     * The border radius of the component.
+     * The border radius of the component of type number denoting pixels or string.
      * @group Props
      */
     borderRadius: number | string;
@@ -1599,11 +1658,21 @@ declare class CpsExpansionPanelComponent implements OnInit, AfterViewInit {
     private _contentExpandAnimation;
     private _contentCollapseAnimation;
     private _contentAnimationPlayer;
+    readonly contentPanelId: string;
+    isKeyboardActive: boolean;
+    cvtWidth: string;
+    cvtBorderColor: string;
+    cvtBackgroundColor: string;
+    cvtBorderRadius: string;
     constructor(_animationBuilder: AnimationBuilder, document: Document, _renderer: Renderer2);
     ngOnInit(): void;
+    ngOnChanges(changes: SimpleChanges): void;
     ngAfterViewInit(): void;
+    onHeaderKeydown(event: KeyboardEvent): void;
+    onHeaderKeyup(event: KeyboardEvent): void;
     toggleExpansion(): void;
     private _updateContentVisibilityStyles;
+    private _logHeaderTitleError;
     static ɵfac: i0.ɵɵFactoryDeclaration<CpsExpansionPanelComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<CpsExpansionPanelComponent, "cps-expansion-panel", never, { "headerTitle": { "alias": "headerTitle"; "required": false; }; "backgroundColor": { "alias": "backgroundColor"; "required": false; }; "showChevron": { "alias": "showChevron"; "required": false; }; "isExpanded": { "alias": "isExpanded"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "bordered": { "alias": "bordered"; "required": false; }; "borderRadius": { "alias": "borderRadius"; "required": false; }; "borderColor": { "alias": "borderColor"; "required": false; }; "width": { "alias": "width"; "required": false; }; "prefixIcon": { "alias": "prefixIcon"; "required": false; }; }, { "afterCollapse": "afterCollapse"; "afterExpand": "afterExpand"; }, never, ["*"], true, never>;
 }
@@ -1771,8 +1840,7 @@ declare class CpsInfoCircleComponent {
  * CpsLoaderComponent is a fetch data indicator.
  * @group Components
  */
-declare class CpsLoaderComponent implements OnInit {
-    private document;
+declare class CpsLoaderComponent implements OnInit, OnChanges, AfterViewInit, OnDestroy {
     /**
      * Option for loader component to take up the whole screen.
      * @group Props
@@ -1793,19 +1861,39 @@ declare class CpsLoaderComponent implements OnInit {
      * @group Props
      */
     showLabel: boolean;
+    /**
+     * Text shown visually when showLabel is true.
+     * @group Props
+     */
+    label: string;
+    /**
+     * Text announced by screen readers. Used when showLabel is false or label
+     * is empty.
+     * @group Props
+     */
+    ariaLabel: string;
+    /**
+     * Text announced by screen readers when the loader is destroyed.
+     * @group Props
+     */
+    doneAriaLabel: string;
     backgroundColor: string;
-    constructor(document: Document);
+    cvtLabelColor: string;
+    private _document;
+    private _announcer;
     ngOnInit(): void;
+    ngAfterViewInit(): void;
+    ngOnChanges(changes: SimpleChanges): void;
+    ngOnDestroy(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<CpsLoaderComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<CpsLoaderComponent, "cps-loader", never, { "fullScreen": { "alias": "fullScreen"; "required": false; }; "opacity": { "alias": "opacity"; "required": false; }; "labelColor": { "alias": "labelColor"; "required": false; }; "showLabel": { "alias": "showLabel"; "required": false; }; }, {}, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<CpsLoaderComponent, "cps-loader", never, { "fullScreen": { "alias": "fullScreen"; "required": false; }; "opacity": { "alias": "opacity"; "required": false; }; "labelColor": { "alias": "labelColor"; "required": false; }; "showLabel": { "alias": "showLabel"; "required": false; }; "label": { "alias": "label"; "required": false; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; }; "doneAriaLabel": { "alias": "doneAriaLabel"; "required": false; }; }, {}, never, never, true, never>;
 }
 
 /**
  * CpsPaginatorComponent is a generic component to display content in paged format.
  * @group Components
  */
-declare class CpsPaginatorComponent implements OnInit {
-    private document;
+declare class CpsPaginatorComponent implements OnInit, OnChanges {
     /**
      * Zero-relative number of the first row to be displayed.
      * @group Props
@@ -1841,6 +1929,13 @@ declare class CpsPaginatorComponent implements OnInit {
      * @group Props
      */
     resetPageOnRowsChange: boolean;
+    /**
+     * Accessible label for the paginator component.
+     * Falls back to "Pagination" when empty value is provided.
+     * @group Props
+     * @default Pagination
+     */
+    ariaLabel: string;
     /**
      * Callback to invoke when page changes, the event object contains information about the new state.
      * @param {any} any - page changed.
@@ -1848,16 +1943,34 @@ declare class CpsPaginatorComponent implements OnInit {
      */
     pageChanged: EventEmitter<any>;
     paginator: Paginator;
+    cvtBackgroundColor: string;
+    computedAriaLabel: string;
+    paginatorPt: {
+        first: {
+            'aria-disabled': string | null;
+            tabindex: number;
+        };
+    };
     rowOptions: {
         label: string;
         value: number;
     }[];
-    constructor(document: Document);
+    private _currentRowsPerPageOptions;
+    private readonly _document;
+    private readonly _elementRef;
+    private readonly _staticAriaLabel;
     ngOnInit(): void;
+    ngOnChanges(changes: SimpleChanges): void;
+    private _syncRows;
+    private _updateAriaLabel;
+    private _buildPaginatorPt;
     onPageChange(event: any): void;
+    onKeydown(event: KeyboardEvent): void;
+    private _getPageButtons;
+    private _focusSelectedPageButton;
     onRowsPerPageChange(rows: number): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<CpsPaginatorComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<CpsPaginatorComponent, "cps-paginator", never, { "first": { "alias": "first"; "required": false; }; "rows": { "alias": "rows"; "required": false; }; "totalRecords": { "alias": "totalRecords"; "required": false; }; "rowsPerPageOptions": { "alias": "rowsPerPageOptions"; "required": false; }; "alwaysShow": { "alias": "alwaysShow"; "required": false; }; "backgroundColor": { "alias": "backgroundColor"; "required": false; }; "resetPageOnRowsChange": { "alias": "resetPageOnRowsChange"; "required": false; }; }, { "pageChanged": "pageChanged"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<CpsPaginatorComponent, "cps-paginator", never, { "first": { "alias": "first"; "required": false; }; "rows": { "alias": "rows"; "required": false; }; "totalRecords": { "alias": "totalRecords"; "required": false; }; "rowsPerPageOptions": { "alias": "rowsPerPageOptions"; "required": false; }; "alwaysShow": { "alias": "alwaysShow"; "required": false; }; "backgroundColor": { "alias": "backgroundColor"; "required": false; }; "resetPageOnRowsChange": { "alias": "resetPageOnRowsChange"; "required": false; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; }; }, { "pageChanged": "pageChanged"; }, never, never, true, never>;
 }
 
 /**
@@ -1877,8 +1990,7 @@ declare class CpsPaginatePipe implements PipeTransform {
  * CpsProgressCircularComponent is a process status indicator in a form of a spinner.
  * @group Components
  */
-declare class CpsProgressCircularComponent implements OnInit {
-    private document;
+declare class CpsProgressCircularComponent implements OnInit, OnChanges {
     /**
      * Diameter of the progress bar, of type number denoting pixels or string.
      * @group Props
@@ -1894,10 +2006,24 @@ declare class CpsProgressCircularComponent implements OnInit {
      * @group Props
      */
     color: string;
-    constructor(document: Document);
+    /**
+     * Accessible label announced by screen readers to describe what is loading.
+     * Falls back to "Loading" when empty value is provided.
+     * @group Props
+     * @default Loading
+     */
+    ariaLabel: string;
+    private readonly _document;
+    private readonly _staticAriaLabel;
+    cvtDiameter: string;
+    cvtStrokeWidth: string;
+    cvtColor: string;
+    computedAriaLabel: string;
     ngOnInit(): void;
+    ngOnChanges(changes: SimpleChanges): void;
+    private _updateAriaLabel;
     static ɵfac: i0.ɵɵFactoryDeclaration<CpsProgressCircularComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<CpsProgressCircularComponent, "cps-progress-circular", never, { "diameter": { "alias": "diameter"; "required": false; }; "strokeWidth": { "alias": "strokeWidth"; "required": false; }; "color": { "alias": "color"; "required": false; }; }, {}, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<CpsProgressCircularComponent, "cps-progress-circular", never, { "diameter": { "alias": "diameter"; "required": false; }; "strokeWidth": { "alias": "strokeWidth"; "required": false; }; "color": { "alias": "color"; "required": false; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; }; }, {}, never, never, true, never>;
 }
 
 /**
@@ -1941,14 +2067,23 @@ declare class CpsProgressLinearComponent {
      * @default 0
      */
     radius: i0.InputSignal<string | number>;
-    private readonly document;
+    /**
+     * Accessible label announced by screen readers to describe what is loading.
+     * Falls back to "Loading" when empty value is provided.
+     * @group Props
+     * @default Loading
+     */
+    ariaLabel: i0.InputSignal<string>;
+    private readonly _document;
+    private readonly _staticAriaLabel;
     cvtWidth: i0.Signal<string>;
     cvtHeight: i0.Signal<string>;
     cvtRadius: i0.Signal<string>;
     cssColor: i0.Signal<string>;
     cssBgColor: i0.Signal<string>;
+    computedAriaLabel: i0.Signal<string>;
     static ɵfac: i0.ɵɵFactoryDeclaration<CpsProgressLinearComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<CpsProgressLinearComponent, "cps-progress-linear", never, { "width": { "alias": "width"; "required": false; "isSignal": true; }; "height": { "alias": "height"; "required": false; "isSignal": true; }; "color": { "alias": "color"; "required": false; "isSignal": true; }; "bgColor": { "alias": "bgColor"; "required": false; "isSignal": true; }; "opacity": { "alias": "opacity"; "required": false; "isSignal": true; }; "radius": { "alias": "radius"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<CpsProgressLinearComponent, "cps-progress-linear", never, { "width": { "alias": "width"; "required": false; "isSignal": true; }; "height": { "alias": "height"; "required": false; "isSignal": true; }; "color": { "alias": "color"; "required": false; "isSignal": true; }; "bgColor": { "alias": "bgColor"; "required": false; "isSignal": true; }; "opacity": { "alias": "opacity"; "required": false; "isSignal": true; }; "radius": { "alias": "radius"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 /**
@@ -2779,16 +2914,20 @@ declare class CpsSidebarMenuComponent {
  * CpsSwitchComponent is a component used to toggle a boolean value.
  * @group Components
  */
-declare class CpsSwitchComponent implements ControlValueAccessor {
+declare class CpsSwitchComponent implements OnInit, OnChanges, ControlValueAccessor {
     private _control;
-    private _elementRef;
     /**
-     * Label of the component.
+     * Label of the switch component.
      * @group Props
      */
     label: string;
     /**
-     * Determines whether the component is disabled.
+     * Aria label for the switch component, used for accessibility, it takes precedence over label.
+     * @group Props
+     */
+    ariaLabel: string;
+    /**
+     * Determines whether the switch component is disabled.
      * @group Props
      */
     disabled: boolean;
@@ -2831,7 +2970,10 @@ declare class CpsSwitchComponent implements ControlValueAccessor {
      */
     valueChanged: EventEmitter<boolean>;
     private _value;
-    constructor(_control: NgControl, _elementRef: ElementRef<HTMLElement>);
+    switchInput?: ElementRef<HTMLInputElement>;
+    constructor(_control: NgControl);
+    ngOnInit(): void;
+    ngOnChanges(): void;
     onChange: (_event: any) => void;
     onTouched: () => void;
     registerOnChange(fn: any): void;
@@ -2841,8 +2983,8 @@ declare class CpsSwitchComponent implements ControlValueAccessor {
     private _updateValue;
     setDisabledState(_disabled: boolean): void;
     focus(): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<CpsSwitchComponent, [{ optional: true; self: true; }, null]>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<CpsSwitchComponent, "cps-switch", never, { "label": { "alias": "label"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "infoTooltip": { "alias": "infoTooltip"; "required": false; }; "infoTooltipClass": { "alias": "infoTooltipClass"; "required": false; }; "infoTooltipMaxWidth": { "alias": "infoTooltipMaxWidth"; "required": false; }; "infoTooltipPersistent": { "alias": "infoTooltipPersistent"; "required": false; }; "infoTooltipPosition": { "alias": "infoTooltipPosition"; "required": false; }; "value": { "alias": "value"; "required": false; }; }, { "valueChanged": "valueChanged"; }, never, never, true, never>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CpsSwitchComponent, [{ optional: true; self: true; }]>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<CpsSwitchComponent, "cps-switch", never, { "label": { "alias": "label"; "required": false; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "infoTooltip": { "alias": "infoTooltip"; "required": false; }; "infoTooltipClass": { "alias": "infoTooltipClass"; "required": false; }; "infoTooltipMaxWidth": { "alias": "infoTooltipMaxWidth"; "required": false; }; "infoTooltipPersistent": { "alias": "infoTooltipPersistent"; "required": false; }; "infoTooltipPosition": { "alias": "infoTooltipPosition"; "required": false; }; "value": { "alias": "value"; "required": false; }; }, { "valueChanged": "valueChanged"; }, never, never, true, never>;
 }
 
 /**
@@ -4053,7 +4195,7 @@ declare class CpsTableDetectFilterTypePipe implements PipeTransform {
  * CpsTagComponent is used to categorize content.
  * @group Components
  */
-declare class CpsTagComponent implements ControlValueAccessor, OnChanges {
+declare class CpsTagComponent implements ControlValueAccessor, OnInit, OnChanges {
     private _control;
     private document;
     /**
@@ -4090,17 +4232,23 @@ declare class CpsTagComponent implements ControlValueAccessor, OnChanges {
      */
     valueChanged: EventEmitter<boolean>;
     classesList: string[];
+    pressing: boolean;
+    cvtColor: string;
     private _value;
     constructor(_control: NgControl, document: Document);
-    ngOnChanges(): void;
+    ngOnInit(): void;
+    ngOnChanges(changes: SimpleChanges): void;
     setClasses(): void;
     onChange: (_event: any) => void;
     onTouched: () => void;
     registerOnChange(fn: any): void;
     registerOnTouched(fn: any): void;
     writeValue(value: boolean): void;
+    handleEnterKeydown(event: Event): void;
+    handleSpaceKeydown(event: Event): void;
     toggleSelected(): void;
     private _updateValue;
+    private _logMissingLabelError;
     static ɵfac: i0.ɵɵFactoryDeclaration<CpsTagComponent, [{ optional: true; self: true; }, null]>;
     static ɵcmp: i0.ɵɵComponentDeclaration<CpsTagComponent, "cps-tag", never, { "label": { "alias": "label"; "required": false; }; "color": { "alias": "color"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "selectable": { "alias": "selectable"; "required": false; }; "value": { "alias": "value"; "required": false; }; }, { "valueChanged": "valueChanged"; }, never, never, true, never>;
 }
@@ -5915,6 +6063,16 @@ interface CpsNotificationConfig {
      * @default undefined
      */
     maxWidth?: string;
+    /**
+     * Whether to announce error notifications politely instead of assertively.
+     * @default false
+     */
+    politeError?: boolean;
+    /**
+     * Whether to announce warning notifications politely instead of assertively.
+     * @default false
+     */
+    politeWarning?: boolean;
 }
 
 /**
@@ -5966,6 +6124,7 @@ declare class CpsNotificationService {
     private _createNotification;
     private _initConfig;
     private _appendNotificationToContainer;
+    private _createContainerComponent;
     private _tryRemoveContainer;
     static ɵfac: i0.ɵɵFactoryDeclaration<CpsNotificationService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<CpsNotificationService>;
@@ -6438,6 +6597,50 @@ declare class CpsCronValidationService {
  */
 declare const CPS_CRON_VALIDATION_SERVICE: InjectionToken<CpsCronValidationService | null>;
 
+type CpsLiveAnnouncerPoliteness = 'polite' | 'assertive';
+/**
+ * Service for making accessible live-region announcements without relying on a
+ * specific component's live region. Creates two persistent hidden elements in
+ * document.body (one polite, one assertive) that screen readers monitor for
+ * content changes.
+ */
+declare class CpsLiveAnnouncerService implements OnDestroy {
+    private _document;
+    private _ngZone;
+    private _platformId;
+    private _isBrowser;
+    private _regions;
+    /**
+     * Announces a message through the appropriate live region. Clears any
+     * existing text first so the same message can be re-announced, then writes
+     * the new text on the next tick so screen readers observe the content change.
+     * After `duration` ms the region is cleared automatically; pass `0` to keep
+     * the message indefinitely. Defaults to 5000ms.
+     */
+    announce(message: string, politeness?: CpsLiveAnnouncerPoliteness, durationMs?: number): void;
+    /**
+     * Clears the live region without making a new announcement.
+     */
+    clear(politeness?: CpsLiveAnnouncerPoliteness): void;
+    ngOnDestroy(): void;
+    private _createElement;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CpsLiveAnnouncerService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<CpsLiveAnnouncerService>;
+}
+/**
+ * Injection token for the live-announcer service.
+ *
+ * By default it resolves to the singleton {@link CpsLiveAnnouncerService}.
+ * Consumer applications can override it to supply a custom implementation or
+ * provide `null` to disable all live-region announcements.
+ *
+ * @example Disable announcements:
+ * ```typescript
+ * providers: [{ provide: CPS_LIVE_ANNOUNCER_SERVICE, useValue: null }]
+ * ```
+ */
+declare const CPS_LIVE_ANNOUNCER_SERVICE: InjectionToken<CpsLiveAnnouncerService | null>;
+
 /**
  * Collects all --cps-color-* CSS custom properties from :root rules only.
  * Theme overrides (e.g. [data-theme='dark']) are excluded to avoid duplicates,
@@ -6447,5 +6650,5 @@ declare const getCpsColors: (_document: Document) => [string, string][];
 declare const getCSSColor: (val: string, _document: Document) => string;
 declare const getTextColor: (backgroundColor: string) => string;
 
-export { CPS_CRON_VALIDATION_SERVICE, CPS_FOCUS_SERVICE, CPS_RADIO_GROUP, CPS_ROOT_FONT_SIZE_SERVICE, CpsAutocompleteComponent, CpsButtonComponent, CpsButtonToggleComponent, CpsCheckboxComponent, CpsChipComponent, CpsColumnFilterMatchMode, CpsCronValidationService, CpsDatepickerComponent, CpsDialogConfig, CpsDialogRef, CpsDialogService, CpsDividerComponent, CpsExpansionPanelComponent, CpsFileUploadComponent, CpsFocusService, CpsIconComponent, CpsInfoCircleComponent, CpsInputComponent, CpsLoaderComponent, CpsMenuComponent, CpsMenuHideReason, CpsNotificationAppearance, CpsNotificationPosition, CpsNotificationService, CpsPaginatePipe, CpsPaginatorComponent, CpsProgressCircularComponent, CpsProgressLinearComponent, CpsRadioComponent, CpsRadioGroupComponent, CpsRootFontSizeService, CpsSchedulerComponent, CpsSelectComponent, CpsSidebarMenuComponent, CpsSwitchComponent, CpsTabComponent, CpsTabGroupComponent, CpsTableColumnFilterDirective, CpsTableColumnResizableDirective, CpsTableColumnSortableDirective, CpsTableComponent, CpsTableDetectFilterTypePipe, CpsTableHeaderSelectableDirective, CpsTableRowSelectableDirective, CpsTagComponent, CpsTextareaComponent, CpsThemeService, CpsTimepickerComponent, CpsTooltipDirective, CpsTreeAutocompleteComponent, CpsTreeSelectComponent, CpsTreeTableColumnFilterDirective, CpsTreeTableColumnResizableDirective, CpsTreeTableColumnSortableDirective, CpsTreeTableComponent, CpsTreeTableDetectFilterTypePipe, CpsTreeTableHeaderSelectableDirective, CpsTreeTableRowSelectableDirective, CpsTreetableRowTogglerDirective, ICONS_PATH, getCSSColor, getCpsColors, getTextColor, iconNames, tableFactory, treeTableFactory };
-export type { CpsAutocompleteAppearanceType, CpsBaseTheme, CpsButtonToggleOption, CpsColorTheme, CpsColumnFilterCategoryOption, CpsColumnFilterType, CpsDatepickerAppearanceType, CpsDialogAutoFocusTarget, CpsDividerType, CpsInputAppearanceType, CpsMenuAttachPosition, CpsMenuItem, CpsNotificationConfig, CpsRadioOption, CpsRadiusTheme, CpsSelectAppearanceType, CpsSidebarMenuItem, CpsTabChangeEvent, CpsTableExportFormat, CpsTableSize, CpsTableSortMode, CpsTableToolbarSize, CpsTabsAlignmentType, CpsTabsAnimationType, CpsTheme, CpsTime, CpsTooltipOpenOn, CpsTooltipPosition, CpsTreeAutocompleteAppearanceType, CpsTreeSelectAppearanceType, CpsTreeTableSize, CpsTreeTableSortMode, CpsTreeTableToolbarSize, IconType, iconSizeType };
+export { CPS_CRON_VALIDATION_SERVICE, CPS_FOCUS_SERVICE, CPS_LIVE_ANNOUNCER_SERVICE, CPS_RADIO_GROUP, CPS_ROOT_FONT_SIZE_SERVICE, CpsAutocompleteComponent, CpsButtonComponent, CpsButtonToggleComponent, CpsCheckboxComponent, CpsChipComponent, CpsColumnFilterMatchMode, CpsCronValidationService, CpsDatepickerComponent, CpsDialogConfig, CpsDialogRef, CpsDialogService, CpsDividerComponent, CpsExpansionPanelComponent, CpsFileUploadComponent, CpsFocusService, CpsIconComponent, CpsInfoCircleComponent, CpsInputComponent, CpsLiveAnnouncerService, CpsLoaderComponent, CpsMenuComponent, CpsMenuHideReason, CpsNotificationAppearance, CpsNotificationPosition, CpsNotificationService, CpsPaginatePipe, CpsPaginatorComponent, CpsProgressCircularComponent, CpsProgressLinearComponent, CpsRadioComponent, CpsRadioGroupComponent, CpsRootFontSizeService, CpsSchedulerComponent, CpsSelectComponent, CpsSidebarMenuComponent, CpsSwitchComponent, CpsTabComponent, CpsTabGroupComponent, CpsTableColumnFilterDirective, CpsTableColumnResizableDirective, CpsTableColumnSortableDirective, CpsTableComponent, CpsTableDetectFilterTypePipe, CpsTableHeaderSelectableDirective, CpsTableRowSelectableDirective, CpsTagComponent, CpsTextareaComponent, CpsThemeService, CpsTimepickerComponent, CpsTooltipDirective, CpsTreeAutocompleteComponent, CpsTreeSelectComponent, CpsTreeTableColumnFilterDirective, CpsTreeTableColumnResizableDirective, CpsTreeTableColumnSortableDirective, CpsTreeTableComponent, CpsTreeTableDetectFilterTypePipe, CpsTreeTableHeaderSelectableDirective, CpsTreeTableRowSelectableDirective, CpsTreetableRowTogglerDirective, ICONS_PATH, getCSSColor, getCpsColors, getTextColor, iconNames, tableFactory, treeTableFactory };
+export type { CpsAutocompleteAppearanceType, CpsBaseTheme, CpsButtonToggleOption, CpsColorTheme, CpsColumnFilterCategoryOption, CpsColumnFilterType, CpsDatepickerAppearanceType, CpsDatepickerDateFormat, CpsDialogAutoFocusTarget, CpsDividerType, CpsInputAppearanceType, CpsLiveAnnouncerPoliteness, CpsMenuAttachPosition, CpsMenuItem, CpsNotificationConfig, CpsRadioOption, CpsRadiusTheme, CpsSelectAppearanceType, CpsSidebarMenuItem, CpsTabChangeEvent, CpsTableExportFormat, CpsTableSize, CpsTableSortMode, CpsTableToolbarSize, CpsTabsAlignmentType, CpsTabsAnimationType, CpsTheme, CpsTime, CpsTooltipOpenOn, CpsTooltipPosition, CpsTreeAutocompleteAppearanceType, CpsTreeSelectAppearanceType, CpsTreeTableSize, CpsTreeTableSortMode, CpsTreeTableToolbarSize, IconType, iconSizeType };