cps-ui-kit 22.0.1 → 22.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cps-ui-kit",
-  "version": "22.0.1",
+  "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>;
 }
@@ -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`.
      *
@@ -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.
      */