cps-ui-kit 22.0.0 → 22.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cps-ui-kit",
-  "version": "22.0.0",
+  "version": "22.1.0",
   "peerDependencies": {
     "@angular/common": "^22.1.3",
     "@angular/core": "^22.1.3",

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

@@ -160,6 +160,7 @@ declare class CpsTooltipDirective implements OnDestroy {
     private _document;
     private _platformId;
     private _domSanitizer;
+    private _liveAnnouncer;
     constructor();
     ngOnDestroy(): void;
     onMouseEnter(): void;
@@ -184,7 +185,6 @@ declare class CpsTooltipDirective implements OnDestroy {
     private _getCoordsForPosition;
     private _focusableIn;
     private _resolveAriaTarget;
-    private _announce;
     static ɵfac: i0.ɵɵFactoryDeclaration<CpsTooltipDirective, never>;
     static ɵdir: i0.ɵɵDirectiveDeclaration<CpsTooltipDirective, "[cpsTooltip]", never, { "tooltip": { "alias": "cpsTooltip"; "required": true; "isSignal": true; }; "tooltipOpenDelay": { "alias": "tooltipOpenDelay"; "required": false; "isSignal": true; }; "tooltipCloseDelay": { "alias": "tooltipCloseDelay"; "required": false; "isSignal": true; }; "tooltipOpenOn": { "alias": "tooltipOpenOn"; "required": false; "isSignal": true; }; "tooltipPosition": { "alias": "tooltipPosition"; "required": false; "isSignal": true; }; "tooltipPersistent": { "alias": "tooltipPersistent"; "required": false; "isSignal": true; }; "tooltipDisabled": { "alias": "tooltipDisabled"; "required": false; "isSignal": true; }; "tooltipMaxWidth": { "alias": "tooltipMaxWidth"; "required": false; "isSignal": true; }; "tooltipContentClass": { "alias": "tooltipContentClass"; "required": false; "isSignal": true; }; "tooltipOffset": { "alias": "tooltipOffset"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
@@ -242,7 +242,7 @@ declare class FilterService {
     };
     register(rule: string, fn: Function): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<FilterService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<FilterService>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 
 /**
@@ -717,7 +717,7 @@ declare class OverlayService {
     add(event: any): void;
     emitParentDrag(container: Element): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<OverlayService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<OverlayService>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 
 /**
@@ -1324,7 +1324,7 @@ declare class TreeDragDropService {
     startDrag(event: TreeNodeDragEvent): void;
     stopDrag(event: TreeNodeDragEvent): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<TreeDragDropService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<TreeDragDropService>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 
 /**
@@ -7897,7 +7897,7 @@ declare class UseStyle {
         css: any;
     } | undefined;
     static ɵfac: i0.ɵɵFactoryDeclaration<UseStyle, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<UseStyle>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 
 declare class BaseStyle {
@@ -7942,7 +7942,7 @@ declare class BaseStyle {
     getCommonThemeStyleSheet: (params: any, props?: {}) => any;
     getThemeStyleSheet: (params: any, props?: {}) => string;
     static ɵfac: i0.ɵɵFactoryDeclaration<BaseStyle, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<BaseStyle>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 
 declare class ThemeProvider {
@@ -7959,7 +7959,7 @@ declare class ThemeProvider {
     loadCommonTheme(): void;
     setThemeConfig(config: ThemeConfigType): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<ThemeProvider, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<ThemeProvider>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 
 declare class PrimeNG extends ThemeProvider {
@@ -7991,7 +7991,7 @@ declare class PrimeNG extends ThemeProvider {
     setTranslation(value: Translation): void;
     setConfig(config: PrimeNGConfigType): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<PrimeNG, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<PrimeNG>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 
 type Nullable$2<T = void> = T | null | undefined;
@@ -8203,7 +8203,7 @@ declare function cn(...args: any[]): string | undefined;
 declare class BaseComponentStyle extends BaseStyle {
     name: string;
     static ɵfac: i0.ɵɵFactoryDeclaration<BaseComponentStyle, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<BaseComponentStyle>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 
 declare class BaseComponent<PT = any> implements Lifecycle {
@@ -8419,7 +8419,7 @@ declare class ScrollerStyle extends BaseStyle {
         loadingIcon: string;
     };
     static ɵfac: i0.ɵɵFactoryDeclaration<ScrollerStyle, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<ScrollerStyle>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 interface ScrollerStyle extends BaseStyle {
 }
@@ -10356,7 +10356,7 @@ declare class PaginatorStyle extends BaseStyle {
         pcJumpToPageInput: string;
     };
     static ɵfac: i0.ɵɵFactoryDeclaration<PaginatorStyle, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<PaginatorStyle>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 interface PaginatorStyle extends BaseStyle {
 }
@@ -12095,7 +12095,7 @@ declare class TableStyle extends BaseStyle {
         };
     };
     static ɵfac: i0.ɵɵFactoryDeclaration<TableStyle, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<TableStyle>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 
 declare class TableService {
@@ -12115,7 +12115,7 @@ declare class TableService {
     onValueChange(value: any): void;
     onColumnsChange(columns: any[]): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<TableService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<TableService>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 /**
  * Table displays data in tabular format.
@@ -13725,7 +13725,7 @@ declare class TreeTableStyle extends BaseStyle {
         scrollableFooterTable: string;
     };
     static ɵfac: i0.ɵɵFactoryDeclaration<TreeTableStyle, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<TreeTableStyle>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 interface TreeTableStyle extends BaseStyle {
 }
@@ -13747,7 +13747,7 @@ declare class TreeTableService {
     onUIUpdate(value: any): void;
     onTotalRecordsChange(value: number): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<TreeTableService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<TreeTableService>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 /**
  * TreeTable is used to display hierarchical data in tabular format.
@@ -15183,7 +15183,7 @@ declare class TreeStyle extends BaseStyle {
         dropPoint: string;
     };
     static ɵfac: i0.ɵɵFactoryDeclaration<TreeStyle, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<TreeStyle>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 interface TreeStyle extends BaseStyle {
 }
@@ -17288,7 +17288,7 @@ declare class CpsDialogService implements OnDestroy {
     ngOnDestroy(): void;
     private _reverseForEach;
     static ɵfac: i0.ɵɵFactoryDeclaration<CpsDialogService, [null, null, null, null, { optional: true; skipSelf: true; }]>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<CpsDialogService>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 
 /**
@@ -17414,7 +17414,7 @@ declare class CpsNotificationService {
     private _createContainerComponent;
     private _tryRemoveContainer;
     static ɵfac: i0.ɵɵFactoryDeclaration<CpsNotificationService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<CpsNotificationService>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 
 /**
@@ -17465,7 +17465,7 @@ declare class CpsRootFontSizeService implements OnDestroy {
     private _refresh;
     private _readRootFontSize;
     static ɵfac: i0.ɵɵFactoryDeclaration<CpsRootFontSizeService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<CpsRootFontSizeService>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 /**
  * Injection token for the root font size service.
@@ -17524,13 +17524,21 @@ declare class CpsFocusService {
      */
     suppressNextFocusRing(el: HTMLElement): void;
     /**
-     * Focuses `el`, conditionally suppressing the focus-visible ring.
+     * Focuses `el`, optionally suppressing its focus ring and passing native
+     * focus options through to `HTMLElement.focus`.
      *
-     * When `showFocusRing` is `false`, adds the `suppress-focus-visible` CSS
-     * class to the element before focusing and removes it on the next `blur`
-     * event. This keeps the UI clean for pointer-initiated closes.
+     * @param el - The element to focus.
+     * @param showFocusRing - Whether the focus ring should be shown. When false, adds
+     * the suppress-focus-visible CSS class to the element before focusing and removes
+     * it on the next blur event to keep the UI clean for pointer-initiated closes.
+     * @param options - Native focus options, e.g. `{ preventScroll: true }`.
+     *
+     * @example
+     * ```ts
+     * focusService.focusElement(button, true, { preventScroll: true });
+     * ```
      */
-    focusElement(el: HTMLElement, showFocusRing: boolean): void;
+    focusElement(el: HTMLElement, showFocusRing: boolean, options?: Parameters<HTMLElement['focus']>[0]): void;
     /**
      * Installs a Tab key focus trap on `container`.
      *
@@ -17545,7 +17553,7 @@ declare class CpsFocusService {
     private readonly _navigationKeys;
     constructor();
     static ɵfac: i0.ɵɵFactoryDeclaration<CpsFocusService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<CpsFocusService>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 /**
  * Injection token for the focus managing service.
@@ -17678,7 +17686,7 @@ declare class CpsThemeService {
     private saveBaseThemePreference;
     private saveRadiusThemePreference;
     static ɵfac: i0.ɵɵFactoryDeclaration<CpsThemeService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<CpsThemeService>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 
 /**
@@ -17859,7 +17867,7 @@ declare class CpsCronValidationService {
      */
     private _isValidMonthName;
     static ɵfac: i0.ɵɵFactoryDeclaration<CpsCronValidationService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<CpsCronValidationService>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 /**
  * Injection token for `CpsCronValidationService`.
@@ -17900,11 +17908,11 @@ declare class CpsLiveAnnouncerService implements OnDestroy {
     /**
      * 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.
+     * the new text after `delayMs` so screen readers observe the content change.
+     * After `durationMs` the region is cleared automatically; pass `0` to keep
+     * the message indefinitely. Defaults to a next-tick write and 5000ms duration.
      */
-    announce(message: string, politeness?: CpsLiveAnnouncerPoliteness, durationMs?: number): void;
+    announce(message: string, politeness?: CpsLiveAnnouncerPoliteness, durationMs?: number, delayMs?: number): void;
     /**
      * Clears the live region without making a new announcement.
      */
@@ -17912,7 +17920,7 @@ declare class CpsLiveAnnouncerService implements OnDestroy {
     ngOnDestroy(): void;
     private _createElement;
     static ɵfac: i0.ɵɵFactoryDeclaration<CpsLiveAnnouncerService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<CpsLiveAnnouncerService>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 /**
  * Injection token for the live-announcer service.