cps-ui-kit 21.26.0 → 21.27.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cps-ui-kit",
-  "version": "21.26.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 {
@@ -1825,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
@@ -1847,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
@@ -1895,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.
@@ -1902,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>;
 }
 
 /**
@@ -1931,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
@@ -1948,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>;
 }
 
 /**
@@ -1995,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>;
 }
 
 /**
@@ -6516,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,
@@ -6525,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, CpsDatepickerDateFormat, 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 };