cps-ui-kit 21.14.0 → 21.16.0

package/package.json

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

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

@@ -829,7 +829,7 @@ declare class CpsButtonToggleComponent implements ControlValueAccessor, OnInit,
     private _rootFontSizePx;
     constructor(_control: NgControl, document: Document, platformId: object, renderer: Renderer2, cdr: ChangeDetectorRef);
     ngOnInit(): void;
-    ngOnChanges(): void;
+    ngOnChanges(changes: SimpleChanges): void;
     onChange: (_event: any) => void;
     onTouched: () => void;
     setDisabledState(_disabled: boolean): void;
@@ -930,7 +930,7 @@ declare class CpsButtonComponent implements OnChanges {
     classesList: string[];
     enterActive: boolean;
     constructor(document: Document);
-    ngOnChanges(): void;
+    ngOnChanges(changes: SimpleChanges): void;
     setClasses(): void;
     onClick(event: Event): void;
     onEnterKeydown(): void;
@@ -1014,7 +1014,7 @@ declare class CpsCheckboxComponent implements OnInit, OnChanges, ControlValueAcc
     private _value;
     constructor(_control: NgControl, document: Document, _elementRef: ElementRef<HTMLElement>);
     ngOnInit(): void;
-    ngOnChanges(): void;
+    ngOnChanges(changes: SimpleChanges): void;
     onChange: (_event: any) => void;
     onTouched: () => void;
     registerOnChange(fn: any): void;
@@ -2014,7 +2014,7 @@ declare class CpsRadioGroupComponent implements ControlValueAccessor, OnInit, On
     error: string;
     constructor(_control: NgControl);
     ngOnInit(): void;
-    ngOnChanges(): void;
+    ngOnChanges(changes: SimpleChanges): void;
     ngOnDestroy(): void;
     onChange: (_event: any) => void;
     onTouched: () => void;
@@ -2760,12 +2760,17 @@ declare class CpsSwitchComponent implements ControlValueAccessor {
  * CpsTabComponent is a tab within a tab-group.
  * @group Components
  */
-declare class CpsTabComponent {
+declare class CpsTabComponent implements OnChanges {
     /**
      * Label of the tab.
      * @group Props
      */
     label: string;
+    /**
+     * Aria label for the tab component, used for accessibility, it takes precedence over label.
+     * @group Props
+     */
+    ariaLabel: string;
     /**
      * Icon before the label.
      * @group Props
@@ -2808,8 +2813,9 @@ declare class CpsTabComponent {
     badgeTooltip: string;
     content: TemplateRef<any>;
     active: boolean;
+    ngOnChanges(changes: SimpleChanges): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<CpsTabComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<CpsTabComponent, "cps-tab", never, { "label": { "alias": "label"; "required": false; }; "icon": { "alias": "icon"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "tooltipText": { "alias": "tooltipText"; "required": false; }; "tooltipContentClass": { "alias": "tooltipContentClass"; "required": false; }; "tooltipMaxWidth": { "alias": "tooltipMaxWidth"; "required": false; }; "tooltipPersistent": { "alias": "tooltipPersistent"; "required": false; }; "badgeValue": { "alias": "badgeValue"; "required": false; }; "badgeTooltip": { "alias": "badgeTooltip"; "required": false; }; }, {}, never, ["*"], true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<CpsTabComponent, "cps-tab", never, { "label": { "alias": "label"; "required": false; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; }; "icon": { "alias": "icon"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "tooltipText": { "alias": "tooltipText"; "required": false; }; "tooltipContentClass": { "alias": "tooltipContentClass"; "required": false; }; "tooltipMaxWidth": { "alias": "tooltipMaxWidth"; "required": false; }; "tooltipPersistent": { "alias": "tooltipPersistent"; "required": false; }; "badgeValue": { "alias": "badgeValue"; "required": false; }; "badgeTooltip": { "alias": "badgeTooltip"; "required": false; }; }, {}, never, ["*"], true, never>;
 }
 
 /**
@@ -2860,6 +2866,12 @@ declare class CpsTabGroupComponent implements OnInit, AfterContentInit, AfterVie
      * @group Props
      */
     alignment: CpsTabsAlignmentType;
+    /**
+     * When true, tabs activate automatically as focus moves between them via arrow keys.
+     * When false, arrow keys only move focus; press Enter or Space to activate the focused tab.
+     * @group Props
+     */
+    autoActivation: boolean;
     /**
      * Class to apply to the tab content wrapper.
      * @group Props
@@ -2909,10 +2921,14 @@ declare class CpsTabGroupComponent implements OnInit, AfterContentInit, AfterVie
     backBtnVisible: boolean;
     forwardBtnVisible: boolean;
     animationState: 'slideLeft' | 'slideRight' | 'fadeIn' | 'fadeOut';
+    readonly tabGroupId: string;
     windowResize$: Subscription;
     listScroll$: Subscription;
+    private readonly _tabPanelEls;
+    readonly panelTabindex: i0.WritableSignal<number>;
     private _currentTabIndex;
     private _previousTabIndex;
+    private readonly _focusService;
     constructor(cdRef: ChangeDetectorRef, document: Document);
     ngOnInit(): void;
     ngOnChanges(changes: SimpleChanges): void;
@@ -2920,7 +2936,16 @@ declare class CpsTabGroupComponent implements OnInit, AfterContentInit, AfterVie
     ngAfterViewInit(): void;
     ngOnDestroy(): void;
     get selectedTab(): CpsTabComponent | undefined;
+    getTabId(index: number): string;
+    getPanelId(index: number): string;
+    getTabFocusOrderTabIndex(tabIndex: number): 0 | -1;
+    getTabAriaLabel(tab: CpsTabComponent): string | null;
     onTabClick(index: number): void;
+    onMouseDown(event: MouseEvent): void;
+    onTabKeydown(event: KeyboardEvent, index: number): void;
+    private _scrollTabIntoView;
+    private _hasFocusableIn;
+    private _nextEnabledTab;
     selectTab(silent?: boolean): void;
     onScroll(event: any): void;
     onResize(): void;
@@ -2930,7 +2955,7 @@ declare class CpsTabGroupComponent implements OnInit, AfterContentInit, AfterVie
     private _getVisibleButtonWidths;
     private _getWidth;
     static ɵfac: i0.ɵɵFactoryDeclaration<CpsTabGroupComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<CpsTabGroupComponent, "cps-tab-group", never, { "selectedIndex": { "alias": "selectedIndex"; "required": false; }; "isSubTabs": { "alias": "isSubTabs"; "required": false; }; "alignment": { "alias": "alignment"; "required": false; }; "contentWrapClass": { "alias": "contentWrapClass"; "required": false; }; "headerClass": { "alias": "headerClass"; "required": false; }; "stretched": { "alias": "stretched"; "required": false; }; "animationType": { "alias": "animationType"; "required": false; }; "navButtonsBackground": { "alias": "navButtonsBackground"; "required": false; }; "tabsBackground": { "alias": "tabsBackground"; "required": false; }; }, { "beforeTabChanged": "beforeTabChanged"; "afterTabChanged": "afterTabChanged"; }, ["tabs"], never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<CpsTabGroupComponent, "cps-tab-group", never, { "selectedIndex": { "alias": "selectedIndex"; "required": false; }; "isSubTabs": { "alias": "isSubTabs"; "required": false; }; "alignment": { "alias": "alignment"; "required": false; }; "autoActivation": { "alias": "autoActivation"; "required": false; }; "contentWrapClass": { "alias": "contentWrapClass"; "required": false; }; "headerClass": { "alias": "headerClass"; "required": false; }; "stretched": { "alias": "stretched"; "required": false; }; "animationType": { "alias": "animationType"; "required": false; }; "navButtonsBackground": { "alias": "navButtonsBackground"; "required": false; }; "tabsBackground": { "alias": "tabsBackground"; "required": false; }; }, { "beforeTabChanged": "beforeTabChanged"; "afterTabChanged": "afterTabChanged"; }, ["tabs"], never, true, never>;
 }
 
 /**
@@ -5908,6 +5933,14 @@ declare class CpsFocusService {
      * Shorthand for `lastInput() === 'keyboard'`.
      */
     isKeyboard(): boolean;
+    /**
+     * Suppresses the focus-visible ring on `el` for its next focus event.
+     *
+     * Adds `suppress-focus-visible` to the element and removes it automatically
+     * on the next `blur`. Call from a `mousedown` handler to prevent the ring
+     * from appearing when the browser moves focus to the element via pointer.
+     */
+    suppressNextFocusRing(el: HTMLElement): void;
     /**
      * Focuses `el`, conditionally suppressing the focus-visible ring.
      *