@coreui/angular 5.7.26 → 5.7.28

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coreui/angular",
-  "version": "5.7.26",
+  "version": "5.7.28",
   "description": "CoreUI Components Library for Angular",
   "copyright": "Copyright 2026 creativeLabs Łukasz Holeczek",
   "license": "MIT",
@@ -29,7 +29,7 @@
     "@angular/core": "^22.1.0",
     "@angular/router": "^22.1.0",
     "@coreui/coreui": "^5.9.0",
-    "@coreui/icons-angular": "~5.7.26",
+    "@coreui/icons-angular": "~5.7.28",
     "rxjs": "^7.8.2"
   },
   "repository": {

package/types/coreui-angular.d.ts

@@ -100,7 +100,7 @@ declare class ThemeDirective {
     #private;
     /**
      * Sets the dark theme attribute on the host element.
-     * @returns 'dark' | 'light' | undefined
+     * @returns 'dark' | 'light'
      */
     readonly colorScheme: _angular_core.InputSignal<"dark" | "light" | undefined>;
     /**
@@ -125,7 +125,7 @@ declare class SharedModule {
 declare class AccordionButtonDirective {
     /**
      * Toggles an accordion button collapsed state. Use in accordionHeaderTemplate.
-     * @returns boolean
+     * @returns boolean | undefined
      */
     readonly collapsed: _angular_core.InputSignal<boolean | undefined>;
     /**
@@ -213,8 +213,8 @@ declare class AlertComponent {
     readonly role: _angular_core.InputSignal<string>;
     /**
      * Set the alert variant to a solid.
-     * @returns string
-     * @default 'solid'
+     * @returns 'solid'
+     * @default undefined
      */
     readonly variant: _angular_core.InputSignal<"solid" | undefined>;
     /**
@@ -285,7 +285,7 @@ declare class AvatarComponent {
     /**
      * Size the component small, large, or extra large.
      * @returns Omit<Sizes, 'xxl'>
-     * @default 'md'
+     * @default ''
      */
     readonly size: _angular_core.InputSignal<Omit<string, "xxl">>;
     /**
@@ -502,7 +502,7 @@ declare class ButtonDirective {
     readonly shape: _angular_core.InputSignal<string | undefined>;
     /**
      * Size the component small or large.
-     * @returns 'sm' | 'lg' | ''
+     * @returns '' | 'sm' | 'lg'
      */
     readonly size: _angular_core.InputSignal<"" | "sm" | "lg">;
     /**
@@ -657,7 +657,7 @@ declare class CardHeaderActionsComponent {
 declare class CardImgDirective {
     /**
      * Optionally orientate the image to the top, bottom, or make it overlaid across the card.
-     * @returns 'top' | 'bottom' | 'start' | 'end'
+     * @returns 'top' | 'bottom' | 'start' | 'end' | undefined
      */
     readonly orientation: _angular_core.InputSignal<"start" | "end" | "top" | "bottom" | undefined>;
     readonly hostClasses: _angular_core.Signal<Record<string, boolean>>;
@@ -782,13 +782,13 @@ declare class CarouselControlComponent {
     #private;
     /**
      * Carousel control caption
-     * @returns string
+     * @returns string | undefined
      */
     readonly captionInput: _angular_core.InputSignal<string | undefined>;
     readonly caption: _angular_core.WritableSignal<string>;
     /**
      * Carousel control direction.
-     * @returns 'next' | 'prev'
+     * @returns 'prev' | 'next'
      */
     readonly direction: _angular_core.InputSignal<"next" | "prev">;
     /**
@@ -1008,7 +1008,7 @@ declare class DropdownToggleDirective implements AfterViewInit {
     dropdown: DropdownToken | null;
     /**
      * Reference to dropdown component.
-     * @returns DropdownComponent | undefined
+     * @returns DropdownComponent
      * @default undefined
      */
     readonly dropdownComponent: _angular_core.InputSignal<DropdownComponent | undefined>;
@@ -1149,7 +1149,7 @@ declare class DropdownItemDirective implements FocusableOption {
     /**
      * Disables a dropdown-item.
      * @returns boolean
-     * @default undefined
+     * @default false
      */
     readonly disabledInput: _angular_core.InputSignalWithTransform<boolean, unknown>;
     set disabled(value: boolean);
@@ -1222,7 +1222,7 @@ declare class DropdownModule {
 declare class FooterComponent {
     /**
      * Place footer in non-static positions
-     * @returns Positions
+     * @returns Positions | undefined
      */
     readonly position: InputSignal<Positions | undefined>;
     /**
@@ -1362,7 +1362,8 @@ declare class FormFeedbackComponent {
 declare class FormFloatingDirective {
     /**
      * Enable floating labels
-     * @dafault boolean
+     * @returns boolean
+     * @default true
      */
     readonly floating: _angular_core.InputSignalWithTransform<boolean, unknown>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<FormFloatingDirective, never>;
@@ -1377,7 +1378,8 @@ declare class FormLabelDirective {
     readonly col: _angular_core.InputSignal<"" | "col">;
     /**
      * Size the label small or large.
-     * @default ''
+     * @returns '' | 'sm' | 'lg'
+     * @default undefined
      */
     readonly sizing: _angular_core.InputSignal<"" | "sm" | "lg" | undefined>;
     readonly hostClasses: _angular_core.Signal<Record<string, boolean>>;
@@ -1430,7 +1432,8 @@ declare class FormModule {
 declare class ContainerComponent {
     /**
      * Set container 100% wide until a breakpoint.
-     * @returns 'sm' | 'md' | 'lg' | 'xl' | 'xxl'
+     * @returns Exclude<Breakpoints, 'xs'>
+     * @values 'sm' | 'md' | 'lg' | 'xl' | 'xxl'
      * @default ''
      */
     readonly breakpoint: _angular_core.InputSignal<string>;
@@ -1757,7 +1760,7 @@ declare class ListGroupItemDirective {
     readonly active: InputSignalWithTransform<boolean, unknown>;
     /**
      * Sets the color context of the component to one of CoreUI’s themed colors.
-     * @returns Colors
+     * @returns Colors | undefined
      */
     readonly color: InputSignal<string | undefined>;
     /**
@@ -1841,7 +1844,7 @@ declare class NavGroupComponent {
     readonly toggler: _angular_core.InputSignal<string | undefined>;
     /**
      * Template for the group toggler content, receives the visible state as `$implicit`.
-     * @returns TemplateRef
+     * @returns TemplateRef<{ $implicit: boolean; visible: boolean }>
      */
     readonly togglerTemplate: _angular_core.InputSignal<TemplateRef<{
         $implicit: boolean;
@@ -1849,7 +1852,7 @@ declare class NavGroupComponent {
     }> | undefined>;
     /**
      * Show nav group items. Sets the initial state, and follows every later change.
-     * @returns boolean
+     * @returns boolean | undefined
      */
     readonly visible: _angular_core.InputSignalWithTransform<boolean | undefined, unknown>;
     /**
@@ -1857,8 +1860,8 @@ declare class NavGroupComponent {
      * @returns boolean
      */
     readonly visibleChange: _angular_core.OutputEmitterRef<boolean>;
-    readonly display: _angular_core.WritableSignal<string | null>;
     readonly visibleState: _angular_core.Signal<boolean>;
+    readonly display: _angular_core.WritableSignal<string | null>;
     readonly hostClasses: _angular_core.Signal<Record<string, boolean>>;
     toggleGroup(event: Event): void;
     openBranch(): void;
@@ -1885,6 +1888,10 @@ declare class NavGroupService {
      * Id of the open group at this level, `undefined` when none is open.
      */
     readonly activeId: _angular_core.WritableSignal<string | undefined>;
+    /**
+     * Whether an active nav link opens the branch it sits in. Inherited by nested levels.
+     */
+    readonly openOnActive: _angular_core.WritableSignal<boolean>;
     /**
      * Opens the level owner within its own parent and cascades up to the root.
      * Replaced by the owning `c-nav-group`; stays a no-op for the root level.
@@ -1901,7 +1908,7 @@ declare class NavItemComponent {
     static ngAcceptInputType_tabindex: NumberInput;
     /**
      * Toggle the active state for the nav link rendered for `href`.
-     * @returns boolean
+     * @returns boolean | undefined
      * @default undefined
      */
     readonly active: _angular_core.InputSignalWithTransform<boolean | undefined, unknown>;
@@ -2023,7 +2030,7 @@ declare class NavbarTogglerDirective {
     constructor();
     /**
      * Reference to navbar collapse element (via # template variable)
-     * @returns CollapseDirective
+     * @returns CollapseDirective | undefined
      */
     readonly collapseRef: _angular_core.InputSignal<CollapseDirective | undefined>;
     /**
@@ -2183,7 +2190,7 @@ declare class ModalComponent implements OnInit, OnDestroy, AfterViewInit {
     /**
      * Set aria-modal html attr for modal
      * @returns boolean
-     * @default null
+     * @default false
      */
     readonly ariaModalInput: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly ariaModal: _angular_core.Signal<true | null>;
@@ -2289,7 +2296,7 @@ declare class OffcanvasComponent implements OnInit, OnDestroy {
     readonly portal: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /**
      * Responsive offcanvas property hides content outside the viewport from a specified breakpoint and down.
-     * @returns boolean | 'sm' | 'md' | 'lg' | 'xl' | 'xxl';
+     * @returns (boolean | 'sm' | 'md' | 'lg' | 'xl' | 'xxl') | undefined
      * @default true
      * @since 4.3.10
      */
@@ -2505,7 +2512,7 @@ declare class PopoverComponent implements OnDestroy {
     readonly renderer: Renderer2;
     /**
      * Content of popover
-     * @returns {string | TemplateRef}
+     * @returns string | TemplateRef<any>
      */
     readonly content: _angular_core.InputSignal<string | TemplateRef<any>>;
     /**
@@ -2538,7 +2545,7 @@ declare class PopoverDirective implements OnDestroy, OnInit, AfterViewInit {
     #private;
     /**
      * Content of popover
-     * @returns {string | TemplateRef}
+     * @returns string | TemplateRef<any> | undefined
      */
     readonly content: _angular_core.InputSignal<string | TemplateRef<any> | undefined>;
     /**
@@ -2554,20 +2561,21 @@ declare class PopoverDirective implements OnDestroy, OnInit, AfterViewInit {
     }>;
     /**
      * Describes the placement of your component after Popper.js has applied all the modifiers that may have flipped or altered the originally provided placement property.
-     * @return: 'top' | 'bottom' | 'left' | 'right'
-     * @default: 'top'
+     * @returns 'top' | 'bottom' | 'left' | 'right'
+     * @default 'top'
      */
     readonly placement: _angular_core.InputSignal<"top" | "bottom" | "right" | "left">;
     /**
      * ElementRefDirective for positioning the tooltip on reference element
-     * @return: ElementRefDirective
-     * @default: undefined
+     * @returns ElementRefDirective | undefined
+     * @default undefined
+     * @since 5.7.27
      */
     readonly reference: _angular_core.InputSignal<ElementRefDirective | undefined>;
     readonly referenceRef: _angular_core.Signal<ElementRef<any>>;
     /**
      * Sets which event handlers you’d like provided to your toggle prop. You can specify one trigger or an array of them.
-     * @return: Triggers | Triggers[]
+     * @returns Triggers | Triggers[]
      */
     readonly trigger: _angular_core.InputSignal<Triggers | Triggers[]>;
     /**
@@ -2593,7 +2601,7 @@ declare class PopoverDirective implements OnDestroy, OnInit, AfterViewInit {
     private addTooltipElement;
     private removeTooltipElement;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<PopoverDirective, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<PopoverDirective, "[cPopover]", ["cPopover"], { "content": { "alias": "cPopover"; "required": false; "isSignal": true; }; "popperOptions": { "alias": "cPopoverOptions"; "required": false; "isSignal": true; }; "placement": { "alias": "cPopoverPlacement"; "required": false; "isSignal": true; }; "reference": { "alias": "cTooltipRef"; "required": false; "isSignal": true; }; "trigger": { "alias": "cPopoverTrigger"; "required": false; "isSignal": true; }; "visible": { "alias": "cPopoverVisible"; "required": false; "isSignal": true; }; }, { "visible": "cPopoverVisibleChange"; }, never, never, true, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<PopoverDirective, "[cPopover]", ["cPopover"], { "content": { "alias": "cPopover"; "required": false; "isSignal": true; }; "popperOptions": { "alias": "cPopoverOptions"; "required": false; "isSignal": true; }; "placement": { "alias": "cPopoverPlacement"; "required": false; "isSignal": true; }; "reference": { "alias": "cPopoverRef"; "required": false; "isSignal": true; }; "trigger": { "alias": "cPopoverTrigger"; "required": false; "isSignal": true; }; "visible": { "alias": "cPopoverVisible"; "required": false; "isSignal": true; }; }, { "visible": "cPopoverVisibleChange"; }, never, never, true, never>;
 }
 
 declare class PopoverModule {
@@ -2629,7 +2637,7 @@ declare class ProgressBarDirective {
     readonly animated: _angular_core.InputSignalWithTransform<boolean | undefined, unknown>;
     /**
      * Sets the color context of the component to one of CoreUI’s themed colors.
-     * @values 'primary', 'secondary', 'success', 'danger', 'warning', 'info', 'dark', 'light'
+     * @returns Colors
      */
     readonly color: _angular_core.InputSignal<string | undefined>;
     /**
@@ -3126,7 +3134,8 @@ declare class SidebarNavGroupComponent implements OnInit, OnDestroy {
      * Determines when an inactive `c-sidebar-nav-group` closes.
      * - `path`: on an active route change only
      * - `close`: when another group is clicked
-     * - `none`: never, the group stays open
+     * - `none`: never, the group stays open — it stops reacting to the route altogether,
+     *   so a matching route neither opens it on init nor on a later navigation
      */
     readonly dropdownMode: _angular_core.InputSignal<"none" | "close" | "path">;
     /**
@@ -3165,7 +3174,7 @@ declare class SidebarNavComponent implements OnChanges {
     readonly router: Router;
     /**
      * Configuration object for sidebar-nav.
-     * @returns INavData[]
+     * @returns INavData[] | undefined
      * @default []
      */
     readonly navItems: _angular_core.InputSignal<INavData[] | undefined>;
@@ -3173,7 +3182,8 @@ declare class SidebarNavComponent implements OnChanges {
      * Determines when an inactive `c-sidebar-nav-group` closes.
      * - `path`: on an active route change only
      * - `close`: when another group is clicked
-     * - `none`: never, the group stays open
+     * - `none`: never, the group stays open — it stops reacting to the route altogether,
+     *   so a matching route neither opens it on init nor on a later navigation
      */
     readonly dropdownMode: _angular_core.InputSignal<"none" | "close" | "path">;
     /**
@@ -3192,7 +3202,14 @@ declare class SidebarNavComponent implements OnChanges {
      * @default 'navigation'
      */
     readonly role: _angular_core.InputSignal<string>;
+    /**
+     * Set the sidebar nav variant to tree.
+     * @default undefined
+     * @since 5.7.28
+     */
+    readonly variant: _angular_core.InputSignal<"tree" | undefined>;
     readonly hostClasses: _angular_core.Signal<{
+        [x: string]: boolean | undefined;
         'sidebar-nav': boolean;
         'nav-group-items': boolean | undefined;
         compact: boolean | undefined;
@@ -3201,7 +3218,7 @@ declare class SidebarNavComponent implements OnChanges {
     ngOnChanges(changes: SimpleChanges): void;
     hideMobile(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<SidebarNavComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SidebarNavComponent, "c-sidebar-nav", never, { "navItems": { "alias": "navItems"; "required": false; "isSignal": true; }; "dropdownMode": { "alias": "dropdownMode"; "required": false; "isSignal": true; }; "groupItems": { "alias": "groupItems"; "required": false; "isSignal": true; }; "compact": { "alias": "compact"; "required": false; "isSignal": true; }; "role": { "alias": "role"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SidebarNavComponent, "c-sidebar-nav", never, { "navItems": { "alias": "navItems"; "required": false; "isSignal": true; }; "dropdownMode": { "alias": "dropdownMode"; "required": false; "isSignal": true; }; "groupItems": { "alias": "groupItems"; "required": false; "isSignal": true; }; "compact": { "alias": "compact"; "required": false; "isSignal": true; }; "role": { "alias": "role"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
 }
 
 declare class SidebarNavDividerComponent {
@@ -3328,8 +3345,7 @@ declare class SpinnerComponent {
     readonly label: _angular_core.InputSignal<string>;
     /**
      * Size the component small.
-     * @returns string
-     * @values 'sm'
+     * @returns 'sm'
      */
     readonly size: _angular_core.InputSignal<"sm" | undefined>;
     /**
@@ -3358,7 +3374,7 @@ declare class SpinnerModule {
 declare class TableColorDirective {
     /**
      * Use contextual color for tables, table rows or individual cells.
-     * @returns Colors
+     * @returns Colors | undefined
      */
     readonly color: _angular_core.InputSignal<string | undefined>;
     readonly hostClasses: _angular_core.Signal<Record<string, boolean>>;
@@ -3386,8 +3402,7 @@ declare class TableDirective {
     static ngAcceptInputType_stripedColumns: BooleanInput$1;
     /**
      * Set the vertical alignment.
-     * @returns string
-     * @values 'bottom' | 'middle' | 'top'
+     * @returns 'bottom' | 'middle' | 'top'
      */
     readonly align: _angular_core.InputSignal<"top" | "middle" | "bottom" | undefined>;
     /**
@@ -3423,7 +3438,8 @@ declare class TableDirective {
     readonly hover: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /**
      * Make table responsive across all viewports or pick a maximum breakpoint with which to have a responsive table up to.
-     * @values: {boolean | 'sm' | 'md' | 'lg' | 'xl' | 'xxl'}
+     * @returns boolean | Omit<Breakpoints, 'xs'>
+     * @values true | 'sm' | 'md' | 'lg' | 'xl' | 'xxl'
      */
     readonly responsive: _angular_core.InputSignal<boolean | Omit<string, "xs"> | undefined>;
     /**
@@ -3679,7 +3695,7 @@ declare class TabPanelComponent {
     #private;
     /**
      * aria-labelledby attribute
-     * @returns string
+     * @returns string | undefined
      * @default undefined
      */
     readonly ariaLabelledBy: _angular_core.InputSignal<string | undefined>;
@@ -3765,7 +3781,7 @@ declare class ToasterComponent implements OnInit {
     get placement(): string;
     /**
      * Toaster position
-     * @returns (string | 'absolute' | 'fixed' | 'static')
+     * @returns string | 'absolute' | 'fixed' | 'static'
      */
     readonly position: _angular_core.InputSignal<string>;
     readonly toasterHost: _angular_core.Signal<ToasterHostDirective>;
@@ -3927,7 +3943,7 @@ declare class TooltipComponent implements OnDestroy {
     readonly renderer: Renderer2;
     /**
      * Content of tooltip
-     * @returns {string | TemplateRef}
+     * @returns string | TemplateRef<any>
      */
     readonly content: _angular_core.InputSignal<string | TemplateRef<any>>;
     /**
@@ -3960,7 +3976,7 @@ declare class TooltipDirective implements OnDestroy, OnInit, AfterViewInit {
     #private;
     /**
      * Content of tooltip
-     * @returns {string | TemplateRef}
+     * @returns string | TemplateRef<any> | undefined
      */
     readonly content: _angular_core.InputSignal<string | TemplateRef<any> | undefined>;
     /**
@@ -3976,20 +3992,21 @@ declare class TooltipDirective implements OnDestroy, OnInit, AfterViewInit {
     }>;
     /**
      * Describes the placement of your component after Popper.js has applied all the modifiers that may have flipped or altered the originally provided placement property.
-     * @return: 'top' | 'bottom' | 'left' | 'right'
-     * @default: 'top'
+     * @returns 'top' | 'bottom' | 'left' | 'right'
+     * @default 'top'
      */
     readonly placement: _angular_core.InputSignal<"top" | "bottom" | "right" | "left">;
     /**
      * ElementRefDirective for positioning the tooltip on reference element
-     * @return: ElementRefDirective
-     * @default: undefined
+     * @returns ElementRefDirective | undefined
+     * @default undefined
+     * @since 5.1.0
      */
     readonly reference: _angular_core.InputSignal<ElementRefDirective | undefined>;
     readonly referenceRef: _angular_core.Signal<ElementRef<any>>;
     /**
      * Sets which event handlers you’d like provided to your toggle prop. You can specify one trigger or an array of them.
-     * @return: 'Triggers | Triggers[]
+     * @returns Triggers | Triggers[]
      */
     readonly trigger: _angular_core.InputSignal<Triggers | Triggers[]>;
     /**
@@ -4027,7 +4044,7 @@ declare class TooltipModule {
 declare class AlignDirective {
     /**
      * Set vertical alignment of inline, inline-block, inline-table, and table cell elements
-     * @returns Alignment
+     * @returns Alignment | undefined
      */
     readonly align: _angular_core.InputSignal<Alignment | undefined>;
     readonly hostClasses: _angular_core.Signal<Record<string, boolean>>;
@@ -4226,7 +4243,7 @@ declare class WidgetStatDComponent extends CardComponent {
      */
     /**
      * Values and subtitles for your component.
-     * @returns WidgetStatDValue
+     * @returns WidgetStatDValue[]
      */
     readonly values: _angular_core.InputSignal<WidgetStatDValue[] | undefined>;
     readonly headerClasses: _angular_core.Signal<Record<string, boolean>>;