@coreui/angular 5.7.26 → 5.7.28

package/fesm2022/coreui-angular.mjs

@@ -118,7 +118,7 @@ class ThemeDirective {
     #renderer = inject(Renderer2);
     /**
      * Sets the dark theme attribute on the host element.
-     * @returns 'dark' | 'light' | undefined
+     * @returns 'dark' | 'light'
      */
     colorScheme = input(/* @ts-ignore */
     ...(ngDevMode ? [undefined, { debugName: "colorScheme" }] : /* istanbul ignore next */ []));
@@ -178,7 +178,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.5", ngImpor
 class AccordionButtonDirective {
     /**
      * Toggles an accordion button collapsed state. Use in accordionHeaderTemplate.
-     * @returns boolean
+     * @returns boolean | undefined
      */
     collapsed = input(undefined, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "collapsed" }] : /* istanbul ignore next */ []));
@@ -586,7 +586,7 @@ class ButtonDirective {
     ...(ngDevMode ? [undefined, { debugName: "shape" }] : /* istanbul ignore next */ []));
     /**
      * Size the component small or large.
-     * @returns 'sm' | 'lg' | ''
+     * @returns '' | 'sm' | 'lg'
      */
     size = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "size" }] : /* istanbul ignore next */ []));
@@ -743,8 +743,8 @@ class AlertComponent {
     ...(ngDevMode ? [{ debugName: "role" }] : /* istanbul ignore next */ []));
     /**
      * Set the alert variant to a solid.
-     * @returns string
-     * @default 'solid'
+     * @returns 'solid'
+     * @default undefined
      */
     variant = input(/* @ts-ignore */
     ...(ngDevMode ? [undefined, { debugName: "variant" }] : /* istanbul ignore next */ []));
@@ -876,7 +876,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.5", ngImpor
 class AlignDirective {
     /**
      * Set vertical alignment of inline, inline-block, inline-table, and table cell elements
-     * @returns Alignment
+     * @returns Alignment | undefined
      */
     align = input(undefined, { ...(ngDevMode ? { debugName: "align" } : /* istanbul ignore next */ {}), alias: 'cAlign' });
     hostClasses = computed(() => {
@@ -1215,7 +1215,7 @@ class AvatarComponent {
     /**
      * Size the component small, large, or extra large.
      * @returns Omit<Sizes, 'xxl'>
-     * @default 'md'
+     * @default ''
      */
     size = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "size" }] : /* istanbul ignore next */ []));
@@ -1897,7 +1897,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.5", ngImpor
 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
      */
     orientation = input(undefined, { ...(ngDevMode ? { debugName: "orientation" } : /* istanbul ignore next */ {}), alias: 'cCardImg' });
     hostClasses = computed(() => {
@@ -2658,7 +2658,7 @@ class CarouselControlComponent {
     #carouselService = inject(CarouselService);
     /**
      * Carousel control caption
-     * @returns string
+     * @returns string | undefined
      */
     captionInput = input(undefined, { ...(ngDevMode ? { debugName: "captionInput" } : /* istanbul ignore next */ {}), alias: 'caption' });
     caption = linkedSignal({ ...(ngDevMode ? { debugName: "caption" } : /* istanbul ignore next */ {}), source: this.captionInput,
@@ -2667,7 +2667,7 @@ class CarouselControlComponent {
         } });
     /**
      * Carousel control direction.
-     * @returns 'next' | 'prev'
+     * @returns 'prev' | 'next'
      */
     direction = input('next', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "direction" }] : /* istanbul ignore next */ []));
@@ -3169,7 +3169,7 @@ class DropdownToggleDirective {
     dropdown = inject(DropdownToken, { optional: true });
     /**
      * Reference to dropdown component.
-     * @returns DropdownComponent | undefined
+     * @returns DropdownComponent
      * @default undefined
      */
     dropdownComponent = input(/* @ts-ignore */
@@ -3556,7 +3556,7 @@ class DropdownItemDirective {
     /**
      * Disables a dropdown-item.
      * @returns boolean
-     * @default undefined
+     * @default false
      */
     disabledInput = input(false, { ...(ngDevMode ? { debugName: "disabledInput" } : /* istanbul ignore next */ {}), transform: booleanAttribute, alias: 'disabled' });
     #disabled = linkedSignal(this.disabledInput, /* @ts-ignore */
@@ -3758,7 +3758,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.5", ngImpor
 class FooterComponent {
     /**
      * Place footer in non-static positions
-     * @returns Positions
+     * @returns Positions | undefined
      */
     position = input(/* @ts-ignore */
     ...(ngDevMode ? [undefined, { debugName: "position" }] : /* istanbul ignore next */ []));
@@ -4057,7 +4057,8 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.5", ngImpor
 class FormFloatingDirective {
     /**
      * Enable floating labels
-     * @dafault boolean
+     * @returns boolean
+     * @default true
      */
     floating = input(true, { ...(ngDevMode ? { debugName: "floating" } : /* istanbul ignore next */ {}), transform: booleanAttribute, alias: 'cFormFloating' });
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.1.5", ngImport: i0, type: FormFloatingDirective, deps: [], target: i0.ɵɵFactoryTarget.Directive });
@@ -4079,7 +4080,8 @@ class FormLabelDirective {
     col = input('', { ...(ngDevMode ? { debugName: "col" } : /* istanbul ignore next */ {}), alias: 'cLabel' });
     /**
      * Size the label small or large.
-     * @default ''
+     * @returns '' | 'sm' | 'lg'
+     * @default undefined
      */
     sizing = input(/* @ts-ignore */
     ...(ngDevMode ? [undefined, { debugName: "sizing" }] : /* istanbul ignore next */ []));
@@ -4253,7 +4255,8 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.5", ngImpor
 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 ''
      */
     breakpoint = input('', /* @ts-ignore */
@@ -4920,7 +4923,7 @@ class ListGroupItemDirective {
     active = input(false, { ...(ngDevMode ? { debugName: "active" } : /* istanbul ignore next */ {}), transform: booleanAttribute });
     /**
      * Sets the color context of the component to one of CoreUI’s themed colors.
-     * @returns Colors
+     * @returns Colors | undefined
      */
     color = input(/* @ts-ignore */
     ...(ngDevMode ? [undefined, { debugName: "color" }] : /* istanbul ignore next */ []));
@@ -5002,6 +5005,11 @@ class NavGroupService {
      */
     activeId = signal(undefined, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "activeId" }] : /* istanbul ignore next */ []));
+    /**
+     * Whether an active nav link opens the branch it sits in. Inherited by nested levels.
+     */
+    openOnActive = signal(true, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "openOnActive" }] : /* istanbul ignore next */ []));
     /**
      * 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.
@@ -5076,7 +5084,7 @@ class NavLinkDirective {
     #activeEffect = effect(() => {
         if (this.active()) {
             untracked(() => {
-                this.#navGroupService?.openBranch();
+                this.#openBranch();
             });
         }
     }, /* @ts-ignore */
@@ -5095,6 +5103,11 @@ class NavLinkDirective {
     ngOnDestroy() {
         this.#classObserver?.disconnect();
     }
+    #openBranch() {
+        if (this.#navGroupService?.openOnActive()) {
+            this.#navGroupService.openBranch();
+        }
+    }
     #observeActiveClass() {
         const host = this.#hostElement.nativeElement;
         if (!this.#navGroupService) {
@@ -5102,12 +5115,12 @@ class NavLinkDirective {
         }
         let wasActive = host.classList.contains('active');
         if (wasActive) {
-            this.#navGroupService.openBranch();
+            this.#openBranch();
         }
         this.#classObserver = new MutationObserver(() => {
             const active = host.classList.contains('active');
             if (active && !wasActive) {
-                this.#navGroupService?.openBranch();
+                this.#openBranch();
             }
             wasActive = active;
         });
@@ -5179,13 +5192,13 @@ class NavGroupComponent {
     ...(ngDevMode ? [undefined, { debugName: "toggler" }] : /* istanbul ignore next */ []));
     /**
      * Template for the group toggler content, receives the visible state as `$implicit`.
-     * @returns TemplateRef
+     * @returns TemplateRef<{ $implicit: boolean; visible: boolean }>
      */
     togglerTemplate = input(/* @ts-ignore */
     ...(ngDevMode ? [undefined, { debugName: "togglerTemplate" }] : /* istanbul ignore next */ []));
     /**
      * Show nav group items. Sets the initial state, and follows every later change.
-     * @returns boolean
+     * @returns boolean | undefined
      */
     visible = input(undefined, { ...(ngDevMode ? { debugName: "visible" } : /* istanbul ignore next */ {}), transform: booleanAttribute });
     /**
@@ -5195,13 +5208,14 @@ class NavGroupComponent {
     visibleChange = output();
     #uncontrolledVisible = signal(false, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "#uncontrolledVisible" }] : /* istanbul ignore next */ []));
-    display = signal(null, /* @ts-ignore */
-    ...(ngDevMode ? [{ debugName: "display" }] : /* istanbul ignore next */ []));
     visibleState = computed(() => {
         const parent = this.#parentNavGroupService;
         return parent ? parent.activeId() === this.#id : this.#uncontrolledVisible();
     }, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "visibleState" }] : /* istanbul ignore next */ []));
+    // the group drops `show` in the same pass, hiding the items before cCollapse can measure them
+    display = linkedSignal({ ...(ngDevMode ? { debugName: "display" } : /* istanbul ignore next */ {}), source: this.visibleState,
+        computation: (visible, previous) => (previous?.source && !visible ? 'block' : null) });
     hostClasses = computed(() => {
         return {
             'nav-group': true,
@@ -5219,6 +5233,13 @@ class NavGroupComponent {
         });
     }, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "#visibleEffect" }] : /* istanbul ignore next */ []));
+    #openOnActiveEffect = effect(() => {
+        const openOnActive = this.#parentNavGroupService?.openOnActive() ?? true;
+        untracked(() => {
+            this.#navGroupService.openOnActive.set(openOnActive);
+        });
+    }, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "#openOnActiveEffect" }] : /* istanbul ignore next */ []));
     toggleGroup(event) {
         event.preventDefault();
         const next = !this.visibleState();
@@ -5265,7 +5286,7 @@ class NavItemComponent {
     static ngAcceptInputType_tabindex;
     /**
      * Toggle the active state for the nav link rendered for `href`.
-     * @returns boolean
+     * @returns boolean | undefined
      * @default undefined
      */
     active = input(undefined, { ...(ngDevMode ? { debugName: "active" } : /* istanbul ignore next */ {}), transform: booleanAttribute });
@@ -5553,7 +5574,7 @@ class NavbarTogglerDirective {
     }
     /**
      * Reference to navbar collapse element (via # template variable)
-     * @returns CollapseDirective
+     * @returns CollapseDirective | undefined
      */
     collapseRef = input(undefined, { ...(ngDevMode ? { debugName: "collapseRef" } : /* istanbul ignore next */ {}), alias: 'cNavbarToggler' });
     /**
@@ -5859,7 +5880,7 @@ class ModalComponent {
     /**
      * Set aria-modal html attr for modal
      * @returns boolean
-     * @default null
+     * @default false
      */
     ariaModalInput = input(false, { ...(ngDevMode ? { debugName: "ariaModalInput" } : /* istanbul ignore next */ {}), transform: booleanAttribute, alias: 'ariaModal' });
     ariaModal = computed(() => {
@@ -6220,7 +6241,7 @@ class OffcanvasComponent {
     portal = input(false, { ...(ngDevMode ? { debugName: "portal" } : /* istanbul ignore next */ {}), transform: booleanAttribute });
     /**
      * 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
      */
@@ -6836,7 +6857,7 @@ class PopoverComponent {
     renderer = inject(Renderer2);
     /**
      * Content of popover
-     * @returns {string | TemplateRef}
+     * @returns string | TemplateRef<any>
      */
     content = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "content" }] : /* istanbul ignore next */ []));
@@ -6925,7 +6946,7 @@ class PopoverDirective {
     #timerId2;
     /**
      * Content of popover
-     * @returns {string | TemplateRef}
+     * @returns string | TemplateRef<any> | undefined
      */
     content = input(undefined, { ...(ngDevMode ? { debugName: "content" } : /* istanbul ignore next */ {}), alias: 'cPopover' });
     #contentEffect = effect(() => {
@@ -6953,21 +6974,22 @@ class PopoverDirective {
     ...(ngDevMode ? [{ debugName: "popperOptionsComputed" }] : /* istanbul ignore next */ []));
     /**
      * 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'
      */
     placement = input('top', { ...(ngDevMode ? { debugName: "placement" } : /* istanbul ignore next */ {}), alias: 'cPopoverPlacement' });
     /**
      * ElementRefDirective for positioning the tooltip on reference element
-     * @return: ElementRefDirective
-     * @default: undefined
+     * @returns ElementRefDirective | undefined
+     * @default undefined
+     * @since 5.7.27
      */
-    reference = input(undefined, { ...(ngDevMode ? { debugName: "reference" } : /* istanbul ignore next */ {}), alias: 'cTooltipRef' });
+    reference = input(undefined, { ...(ngDevMode ? { debugName: "reference" } : /* istanbul ignore next */ {}), alias: 'cPopoverRef' });
     referenceRef = computed(() => this.reference()?.elementRef ?? this.#hostElement, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "referenceRef" }] : /* istanbul ignore next */ []));
     /**
      * 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[]
      */
     trigger = input('hover', { ...(ngDevMode ? { debugName: "trigger" } : /* istanbul ignore next */ {}), alias: 'cPopoverTrigger' });
     /**
@@ -7128,7 +7150,7 @@ class PopoverDirective {
         this.#changeDetectorRef.markForCheck();
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.1.5", ngImport: i0, type: PopoverDirective, deps: [], target: i0.ɵɵFactoryTarget.Directive });
-    static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "17.1.0", version: "22.1.5", type: PopoverDirective, isStandalone: true, selector: "[cPopover]", inputs: { content: { classPropertyName: "content", publicName: "cPopover", isSignal: true, isRequired: false, transformFunction: null }, popperOptions: { classPropertyName: "popperOptions", publicName: "cPopoverOptions", isSignal: true, isRequired: false, transformFunction: null }, placement: { classPropertyName: "placement", publicName: "cPopoverPlacement", isSignal: true, isRequired: false, transformFunction: null }, reference: { classPropertyName: "reference", publicName: "cTooltipRef", isSignal: true, isRequired: false, transformFunction: null }, trigger: { classPropertyName: "trigger", publicName: "cPopoverTrigger", isSignal: true, isRequired: false, transformFunction: null }, visible: { classPropertyName: "visible", publicName: "cPopoverVisible", isSignal: true, isRequired: false, transformFunction: null } }, outputs: { visible: "cPopoverVisibleChange" }, host: { properties: { "aria-describedby": "ariaDescribedBy" } }, providers: [ListenersService, IntersectionService], exportAs: ["cPopover"], ngImport: i0 });
+    static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "17.1.0", version: "22.1.5", type: PopoverDirective, isStandalone: true, selector: "[cPopover]", inputs: { content: { classPropertyName: "content", publicName: "cPopover", isSignal: true, isRequired: false, transformFunction: null }, popperOptions: { classPropertyName: "popperOptions", publicName: "cPopoverOptions", isSignal: true, isRequired: false, transformFunction: null }, placement: { classPropertyName: "placement", publicName: "cPopoverPlacement", isSignal: true, isRequired: false, transformFunction: null }, reference: { classPropertyName: "reference", publicName: "cPopoverRef", isSignal: true, isRequired: false, transformFunction: null }, trigger: { classPropertyName: "trigger", publicName: "cPopoverTrigger", isSignal: true, isRequired: false, transformFunction: null }, visible: { classPropertyName: "visible", publicName: "cPopoverVisible", isSignal: true, isRequired: false, transformFunction: null } }, outputs: { visible: "cPopoverVisibleChange" }, host: { properties: { "aria-describedby": "ariaDescribedBy" } }, providers: [ListenersService, IntersectionService], exportAs: ["cPopover"], ngImport: i0 });
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.5", ngImport: i0, type: PopoverDirective, decorators: [{
             type: Directive,
@@ -7138,7 +7160,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.5", ngImpor
                     providers: [ListenersService, IntersectionService],
                     host: { '[aria-describedby]': 'ariaDescribedBy' }
                 }]
-        }], propDecorators: { content: [{ type: i0.Input, args: [{ isSignal: true, alias: "cPopover", required: false }] }], popperOptions: [{ type: i0.Input, args: [{ isSignal: true, alias: "cPopoverOptions", required: false }] }], placement: [{ type: i0.Input, args: [{ isSignal: true, alias: "cPopoverPlacement", required: false }] }], reference: [{ type: i0.Input, args: [{ isSignal: true, alias: "cTooltipRef", required: false }] }], trigger: [{ type: i0.Input, args: [{ isSignal: true, alias: "cPopoverTrigger", required: false }] }], visible: [{ type: i0.Input, args: [{ isSignal: true, alias: "cPopoverVisible", required: false }] }, { type: i0.Output, args: ["cPopoverVisibleChange"] }] } });
+        }], propDecorators: { content: [{ type: i0.Input, args: [{ isSignal: true, alias: "cPopover", required: false }] }], popperOptions: [{ type: i0.Input, args: [{ isSignal: true, alias: "cPopoverOptions", required: false }] }], placement: [{ type: i0.Input, args: [{ isSignal: true, alias: "cPopoverPlacement", required: false }] }], reference: [{ type: i0.Input, args: [{ isSignal: true, alias: "cPopoverRef", required: false }] }], trigger: [{ type: i0.Input, args: [{ isSignal: true, alias: "cPopoverTrigger", required: false }] }], visible: [{ type: i0.Input, args: [{ isSignal: true, alias: "cPopoverVisible", required: false }] }, { type: i0.Output, args: ["cPopoverVisibleChange"] }] } });
 
 class PopoverModule {
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.1.5", ngImport: i0, type: PopoverModule, deps: [], target: i0.ɵɵFactoryTarget.NgModule });
@@ -7220,7 +7242,7 @@ class ProgressBarDirective {
     animated = input(undefined, { ...(ngDevMode ? { debugName: "animated" } : /* istanbul ignore next */ {}), transform: booleanAttribute });
     /**
      * 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
      */
     color = input(/* @ts-ignore */
     ...(ngDevMode ? [undefined, { debugName: "color" }] : /* istanbul ignore next */ []));
@@ -8470,7 +8492,8 @@ class SidebarNavGroupComponent {
      * 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
      */
     dropdownMode = input('path', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "dropdownMode" }] : /* istanbul ignore next */ []));
@@ -8509,7 +8532,7 @@ class SidebarNavGroupComponent {
                 this.openGroup(samePath);
             }
         });
-        if (this.samePath(this.#router.routerState.snapshot.url)) {
+        if (this.dropdownMode() !== 'none' && this.samePath(this.#router.routerState.snapshot.url)) {
             this.openGroup(true);
         }
         this.navGroupSubscription = this.#sidebarNavGroupService.sidebarNavGroupState$.subscribe((next) => {
@@ -8554,7 +8577,7 @@ class SidebarNavGroupComponent {
         this.display.set(state === 'collapsed' || state === 'open' ? null : 'block');
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.1.5", ngImport: i0, type: SidebarNavGroupComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "22.1.5", type: SidebarNavGroupComponent, isStandalone: true, selector: "c-sidebar-nav-group", inputs: { item: { classPropertyName: "item", publicName: "item", isSignal: true, isRequired: false, transformFunction: null }, dropdownMode: { classPropertyName: "dropdownMode", publicName: "dropdownMode", isSignal: true, isRequired: false, transformFunction: null }, show: { classPropertyName: "show", publicName: "show", isSignal: true, isRequired: false, transformFunction: null }, compact: { classPropertyName: "compact", publicName: "compact", isSignal: true, isRequired: false, transformFunction: null } }, host: { properties: { "class": "hostClasses()" } }, providers: [SidebarNavHelper], ngImport: i0, template: "@let grpItem = item();\n<a\n  (click)=\"toggleGroup($event)\"\n  [cHtmlAttr]=\"$safeNavigationMigration(grpItem?.attributes)\"\n  class=\"nav-link nav-group-toggle\"\n  href\n>\n  <ng-container *ngTemplateOutlet=\"iconTemplate; context: { $implicit: grpItem }\" />\n  <ng-container>{{ grpItem?.name }}</ng-container>\n  @if (grpItem?.badge) {\n    <span [class]=\"grpItem | cSidebarNavBadge\">{{ grpItem?.badge?.text }}</span>\n  }\n</a>\n<c-sidebar-nav\n  (collapseChange)=\"onCollapseChange($event)\"\n  [compact]=\"compact()\"\n  [dropdownMode]=\"dropdownMode()\"\n  [groupItems]=\"true\"\n  [navItems]=\"navItems()\"\n  [style.display]=\"display()\"\n  [visible]=\"!!open()\"\n  cCollapse\n/>\n\n<ng-template #iconTemplate let-item>\n  <!--  <i *ngIf=\"item?.icon\" [class]=\"item | cSidebarNavIcon\"></i>-->\n  @if (item?.icon) {\n    <span class=\"nav-icon\">\n      <span [class]=\"item.icon ?? ''\"></span>\n    </span>\n  }\n  @if (item?.iconComponent) {\n    <svg\n      [cIcon]=\"$safeNavigationMigration(item.iconComponent?.content)\"\n      [customClasses]=\"item | cSidebarNavIcon\"\n      [name]=\"$safeNavigationMigration(item.iconComponent?.name)\"\n    />\n  }\n  @if (!item?.icon && !item?.iconComponent) {\n    <span [class]=\"item | cSidebarNavIcon\"></span>\n  }\n</ng-template>\n", styles: [".nav-group-items{display:block}\n"], dependencies: [{ kind: "directive", type: i0.forwardRef(() => CollapseDirective), selector: "[cCollapse]", inputs: ["animate", "horizontal", "visible", "navbar"], outputs: ["visibleChange", "collapseChange"], exportAs: ["cCollapse"] }, { kind: "directive", type: i0.forwardRef(() => HtmlAttributesDirective), selector: "[cHtmlAttr]", inputs: ["cHtmlAttr"], exportAs: ["cHtmlAttr"] }, { kind: "directive", type: i0.forwardRef(() => IconDirective), selector: "svg[cIcon]", inputs: ["cIcon", "customClasses", "size", "title", "height", "width", "name", "viewBox", "xmlns", "pointer-events", "role"], exportAs: ["cIcon"] }, { kind: "directive", type: i0.forwardRef(() => NgTemplateOutlet), selector: "[ngTemplateOutlet]", inputs: ["ngTemplateOutletContext", "ngTemplateOutlet", "ngTemplateOutletInjector"] }, { kind: "component", type: i0.forwardRef(() => SidebarNavComponent), selector: "c-sidebar-nav", inputs: ["navItems", "dropdownMode", "groupItems", "compact", "role"] }, { kind: "pipe", type: i0.forwardRef(() => SidebarNavIconPipe), name: "cSidebarNavIcon" }, { kind: "pipe", type: i0.forwardRef(() => SidebarNavBadgePipe), name: "cSidebarNavBadge" }] });
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "22.1.5", type: SidebarNavGroupComponent, isStandalone: true, selector: "c-sidebar-nav-group", inputs: { item: { classPropertyName: "item", publicName: "item", isSignal: true, isRequired: false, transformFunction: null }, dropdownMode: { classPropertyName: "dropdownMode", publicName: "dropdownMode", isSignal: true, isRequired: false, transformFunction: null }, show: { classPropertyName: "show", publicName: "show", isSignal: true, isRequired: false, transformFunction: null }, compact: { classPropertyName: "compact", publicName: "compact", isSignal: true, isRequired: false, transformFunction: null } }, host: { properties: { "class": "hostClasses()" } }, providers: [SidebarNavHelper], ngImport: i0, template: "@let grpItem = item();\n<a\n  (click)=\"toggleGroup($event)\"\n  [cHtmlAttr]=\"$safeNavigationMigration(grpItem?.attributes)\"\n  class=\"nav-link nav-group-toggle\"\n  href\n>\n  <ng-container *ngTemplateOutlet=\"iconTemplate; context: { $implicit: grpItem }\" />\n  <ng-container>{{ grpItem?.name }}</ng-container>\n  @if (grpItem?.badge) {\n    <span [class]=\"grpItem | cSidebarNavBadge\">{{ grpItem?.badge?.text }}</span>\n  }\n</a>\n<c-sidebar-nav\n  (collapseChange)=\"onCollapseChange($event)\"\n  [compact]=\"compact()\"\n  [dropdownMode]=\"dropdownMode()\"\n  [groupItems]=\"true\"\n  [navItems]=\"navItems()\"\n  [style.display]=\"display()\"\n  [visible]=\"!!open()\"\n  cCollapse\n/>\n\n<ng-template #iconTemplate let-item>\n  <!--  <i *ngIf=\"item?.icon\" [class]=\"item | cSidebarNavIcon\"></i>-->\n  @if (item?.icon) {\n    <span class=\"nav-icon\">\n      <span [class]=\"item.icon ?? ''\"></span>\n    </span>\n  }\n  @if (item?.iconComponent) {\n    <svg\n      [cIcon]=\"$safeNavigationMigration(item.iconComponent?.content)\"\n      [customClasses]=\"item | cSidebarNavIcon\"\n      [name]=\"$safeNavigationMigration(item.iconComponent?.name)\"\n    />\n  }\n  @if (!item?.icon && !item?.iconComponent) {\n    <span [class]=\"item | cSidebarNavIcon\"></span>\n  }\n</ng-template>\n", styles: [".nav-group-items{display:block}\n"], dependencies: [{ kind: "directive", type: i0.forwardRef(() => CollapseDirective), selector: "[cCollapse]", inputs: ["animate", "horizontal", "visible", "navbar"], outputs: ["visibleChange", "collapseChange"], exportAs: ["cCollapse"] }, { kind: "directive", type: i0.forwardRef(() => HtmlAttributesDirective), selector: "[cHtmlAttr]", inputs: ["cHtmlAttr"], exportAs: ["cHtmlAttr"] }, { kind: "directive", type: i0.forwardRef(() => IconDirective), selector: "svg[cIcon]", inputs: ["cIcon", "customClasses", "size", "title", "height", "width", "name", "viewBox", "xmlns", "pointer-events", "role"], exportAs: ["cIcon"] }, { kind: "directive", type: i0.forwardRef(() => NgTemplateOutlet), selector: "[ngTemplateOutlet]", inputs: ["ngTemplateOutletContext", "ngTemplateOutlet", "ngTemplateOutletInjector"] }, { kind: "component", type: i0.forwardRef(() => SidebarNavComponent), selector: "c-sidebar-nav", inputs: ["navItems", "dropdownMode", "groupItems", "compact", "role", "variant"] }, { kind: "pipe", type: i0.forwardRef(() => SidebarNavIconPipe), name: "cSidebarNavIcon" }, { kind: "pipe", type: i0.forwardRef(() => SidebarNavBadgePipe), name: "cSidebarNavBadge" }] });
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.5", ngImport: i0, type: SidebarNavGroupComponent, decorators: [{
             type: Component,
@@ -8577,9 +8600,10 @@ class SidebarNavComponent {
     #renderer = inject(Renderer2);
     #hostElement = inject(ElementRef);
     #sidebarService = inject(SidebarService);
+    #navGroupService = inject(NavGroupService);
     /**
      * Configuration object for sidebar-nav.
-     * @returns INavData[]
+     * @returns INavData[] | undefined
      * @default []
      */
     navItems = input([], /* @ts-ignore */
@@ -8588,7 +8612,8 @@ class SidebarNavComponent {
      * 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
      */
     dropdownMode = input('path', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "dropdownMode" }] : /* istanbul ignore next */ []));
@@ -8609,15 +8634,31 @@ class SidebarNavComponent {
      */
     role = input('navigation', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "role" }] : /* istanbul ignore next */ []));
+    /**
+     * Set the sidebar nav variant to tree.
+     * @default undefined
+     * @since 5.7.28
+     */
+    variant = input(/* @ts-ignore */
+    ...(ngDevMode ? [undefined, { debugName: "variant" }] : /* istanbul ignore next */ []));
     hostClasses = computed(() => {
         const groupItems = this.groupItems();
+        const variant = this.variant();
         return {
             'sidebar-nav': !groupItems,
             'nav-group-items': groupItems,
-            compact: groupItems && this.compact()
+            [`sidebar-nav-${variant}`]: !groupItems && !!variant,
+            compact: this.compact()
         };
     }, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "hostClasses" }] : /* istanbul ignore next */ []));
+    #dropdownModeEffect = effect(() => {
+        const openOnActive = this.dropdownMode() !== 'none';
+        untracked(() => {
+            this.#navGroupService.openOnActive.set(openOnActive);
+        });
+    }, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "#dropdownModeEffect" }] : /* istanbul ignore next */ []));
     // @HostBinding('class.nav-group-items')
     // get sidebarNavGroupItemsClass(): boolean {
     //   return !!this.groupItems;
@@ -8635,7 +8676,7 @@ class SidebarNavComponent {
         }
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.1.5", ngImport: i0, type: SidebarNavComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "22.1.5", type: SidebarNavComponent, isStandalone: true, selector: "c-sidebar-nav", inputs: { navItems: { classPropertyName: "navItems", publicName: "navItems", isSignal: true, isRequired: false, transformFunction: null }, dropdownMode: { classPropertyName: "dropdownMode", publicName: "dropdownMode", isSignal: true, isRequired: false, transformFunction: null }, groupItems: { classPropertyName: "groupItems", publicName: "groupItems", isSignal: true, isRequired: false, transformFunction: null }, compact: { classPropertyName: "compact", publicName: "compact", isSignal: true, isRequired: false, transformFunction: null }, role: { classPropertyName: "role", publicName: "role", isSignal: true, isRequired: false, transformFunction: null } }, host: { properties: { "class": "hostClasses()", "attr.role": "role()" } }, providers: [NavGroupService, SidebarNavGroupService], usesOnChanges: true, ngImport: i0, template: "@for (nItem of navItemsArray(); track nItem) {\n  @switch (helper.itemType(nItem)) {\n    @case ('group') {\n      <c-sidebar-nav-group\n        [dropdownMode]=\"dropdownMode()\"\n        [item]=\"nItem\"\n        [class]=\"nItem | cSidebarNavItemClass\"\n        [compact]=\"compact()\"\n      />\n    }\n    @case ('divider') {\n      <c-sidebar-nav-divider\n        [cHtmlAttr]=\"nItem.attributes ?? {}\"\n        [item]=\"nItem\"\n        [class]=\"nItem | cSidebarNavItemClass\"\n      />\n    }\n    @case ('title') {\n      <c-sidebar-nav-title\n        [cHtmlAttr]=\"nItem.attributes ?? {}\"\n        [item]=\"nItem\"\n        [class]=\"nItem | cSidebarNavItemClass\"\n      />\n    }\n    @case ('label') {\n      <c-sidebar-nav-label\n        [item]=\"nItem\"\n        [class]=\"nItem | cSidebarNavItemClass\"\n      />\n    }\n    @case ('empty') {\n      <ng-container />\n    }\n    @default {\n      <c-sidebar-nav-link\n        (linkClick)=\"hideMobile()\"\n        [item]=\"nItem\"\n        [class]=\"nItem | cSidebarNavItemClass\"\n      />\n    }\n  }\n}\n<ng-content />\n", styles: [":host .nav-item{display:block}\n"], dependencies: [{ kind: "directive", type: i0.forwardRef(() => HtmlAttributesDirective), selector: "[cHtmlAttr]", inputs: ["cHtmlAttr"], exportAs: ["cHtmlAttr"] }, { kind: "component", type: i0.forwardRef(() => SidebarNavLinkComponent), selector: "c-sidebar-nav-link", inputs: ["item"], outputs: ["linkClick"] }, { kind: "component", type: i0.forwardRef(() => SidebarNavLabelComponent), selector: "c-sidebar-nav-label", inputs: ["item"] }, { kind: "component", type: i0.forwardRef(() => SidebarNavTitleComponent), selector: "c-sidebar-nav-title", inputs: ["item"] }, { kind: "component", type: i0.forwardRef(() => SidebarNavDividerComponent), selector: "c-sidebar-nav-divider", inputs: ["item"] }, { kind: "component", type: i0.forwardRef(() => SidebarNavGroupComponent), selector: "c-sidebar-nav-group", inputs: ["item", "dropdownMode", "show", "compact"] }, { kind: "ngmodule", type: i0.forwardRef(() => RouterModule) }, { kind: "pipe", type: i0.forwardRef(() => SidebarNavItemClassPipe), name: "cSidebarNavItemClass" }] });
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "22.1.5", type: SidebarNavComponent, isStandalone: true, selector: "c-sidebar-nav", inputs: { navItems: { classPropertyName: "navItems", publicName: "navItems", isSignal: true, isRequired: false, transformFunction: null }, dropdownMode: { classPropertyName: "dropdownMode", publicName: "dropdownMode", isSignal: true, isRequired: false, transformFunction: null }, groupItems: { classPropertyName: "groupItems", publicName: "groupItems", isSignal: true, isRequired: false, transformFunction: null }, compact: { classPropertyName: "compact", publicName: "compact", isSignal: true, isRequired: false, transformFunction: null }, role: { classPropertyName: "role", publicName: "role", isSignal: true, isRequired: false, transformFunction: null }, variant: { classPropertyName: "variant", publicName: "variant", isSignal: true, isRequired: false, transformFunction: null } }, host: { properties: { "class": "hostClasses()", "attr.role": "role()" } }, providers: [NavGroupService, SidebarNavGroupService], usesOnChanges: true, ngImport: i0, template: "@for (nItem of navItemsArray(); track nItem) {\n  @switch (helper.itemType(nItem)) {\n    @case ('group') {\n      <c-sidebar-nav-group\n        [dropdownMode]=\"dropdownMode()\"\n        [item]=\"nItem\"\n        [class]=\"nItem | cSidebarNavItemClass\"\n        [compact]=\"compact()\"\n      />\n    }\n    @case ('divider') {\n      <c-sidebar-nav-divider\n        [cHtmlAttr]=\"nItem.attributes ?? {}\"\n        [item]=\"nItem\"\n        [class]=\"nItem | cSidebarNavItemClass\"\n      />\n    }\n    @case ('title') {\n      <c-sidebar-nav-title\n        [cHtmlAttr]=\"nItem.attributes ?? {}\"\n        [item]=\"nItem\"\n        [class]=\"nItem | cSidebarNavItemClass\"\n      />\n    }\n    @case ('label') {\n      <c-sidebar-nav-label\n        [item]=\"nItem\"\n        [class]=\"nItem | cSidebarNavItemClass\"\n      />\n    }\n    @case ('empty') {\n      <ng-container />\n    }\n    @default {\n      <c-sidebar-nav-link\n        (linkClick)=\"hideMobile()\"\n        [item]=\"nItem\"\n        [class]=\"nItem | cSidebarNavItemClass\"\n      />\n    }\n  }\n}\n<ng-content />\n", styles: [":host .nav-item{display:block}\n"], dependencies: [{ kind: "directive", type: i0.forwardRef(() => HtmlAttributesDirective), selector: "[cHtmlAttr]", inputs: ["cHtmlAttr"], exportAs: ["cHtmlAttr"] }, { kind: "component", type: i0.forwardRef(() => SidebarNavLinkComponent), selector: "c-sidebar-nav-link", inputs: ["item"], outputs: ["linkClick"] }, { kind: "component", type: i0.forwardRef(() => SidebarNavLabelComponent), selector: "c-sidebar-nav-label", inputs: ["item"] }, { kind: "component", type: i0.forwardRef(() => SidebarNavTitleComponent), selector: "c-sidebar-nav-title", inputs: ["item"] }, { kind: "component", type: i0.forwardRef(() => SidebarNavDividerComponent), selector: "c-sidebar-nav-divider", inputs: ["item"] }, { kind: "component", type: i0.forwardRef(() => SidebarNavGroupComponent), selector: "c-sidebar-nav-group", inputs: ["item", "dropdownMode", "show", "compact"] }, { kind: "ngmodule", type: i0.forwardRef(() => RouterModule) }, { kind: "pipe", type: i0.forwardRef(() => SidebarNavItemClassPipe), name: "cSidebarNavItemClass" }] });
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.5", ngImport: i0, type: SidebarNavComponent, decorators: [{
             type: Component,
@@ -8652,7 +8693,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.5", ngImpor
                         '[class]': 'hostClasses()',
                         '[attr.role]': 'role()'
                     }, providers: [NavGroupService, SidebarNavGroupService], template: "@for (nItem of navItemsArray(); track nItem) {\n  @switch (helper.itemType(nItem)) {\n    @case ('group') {\n      <c-sidebar-nav-group\n        [dropdownMode]=\"dropdownMode()\"\n        [item]=\"nItem\"\n        [class]=\"nItem | cSidebarNavItemClass\"\n        [compact]=\"compact()\"\n      />\n    }\n    @case ('divider') {\n      <c-sidebar-nav-divider\n        [cHtmlAttr]=\"nItem.attributes ?? {}\"\n        [item]=\"nItem\"\n        [class]=\"nItem | cSidebarNavItemClass\"\n      />\n    }\n    @case ('title') {\n      <c-sidebar-nav-title\n        [cHtmlAttr]=\"nItem.attributes ?? {}\"\n        [item]=\"nItem\"\n        [class]=\"nItem | cSidebarNavItemClass\"\n      />\n    }\n    @case ('label') {\n      <c-sidebar-nav-label\n        [item]=\"nItem\"\n        [class]=\"nItem | cSidebarNavItemClass\"\n      />\n    }\n    @case ('empty') {\n      <ng-container />\n    }\n    @default {\n      <c-sidebar-nav-link\n        (linkClick)=\"hideMobile()\"\n        [item]=\"nItem\"\n        [class]=\"nItem | cSidebarNavItemClass\"\n      />\n    }\n  }\n}\n<ng-content />\n", styles: [":host .nav-item{display:block}\n"] }]
-        }], propDecorators: { navItems: [{ type: i0.Input, args: [{ isSignal: true, alias: "navItems", required: false }] }], dropdownMode: [{ type: i0.Input, args: [{ isSignal: true, alias: "dropdownMode", required: false }] }], groupItems: [{ type: i0.Input, args: [{ isSignal: true, alias: "groupItems", required: false }] }], compact: [{ type: i0.Input, args: [{ isSignal: true, alias: "compact", required: false }] }], role: [{ type: i0.Input, args: [{ isSignal: true, alias: "role", required: false }] }] } });
+        }], propDecorators: { navItems: [{ type: i0.Input, args: [{ isSignal: true, alias: "navItems", required: false }] }], dropdownMode: [{ type: i0.Input, args: [{ isSignal: true, alias: "dropdownMode", required: false }] }], groupItems: [{ type: i0.Input, args: [{ isSignal: true, alias: "groupItems", required: false }] }], compact: [{ type: i0.Input, args: [{ isSignal: true, alias: "compact", required: false }] }], role: [{ type: i0.Input, args: [{ isSignal: true, alias: "role", required: false }] }], variant: [{ type: i0.Input, args: [{ isSignal: true, alias: "variant", required: false }] }] } });
 
 class SidebarModule {
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.1.5", ngImport: i0, type: SidebarModule, deps: [], target: i0.ɵɵFactoryTarget.NgModule });
@@ -8742,8 +8783,7 @@ class SpinnerComponent {
     ...(ngDevMode ? [{ debugName: "label" }] : /* istanbul ignore next */ []));
     /**
      * Size the component small.
-     * @returns string
-     * @values 'sm'
+     * @returns 'sm'
      */
     size = input(/* @ts-ignore */
     ...(ngDevMode ? [undefined, { debugName: "size" }] : /* istanbul ignore next */ []));
@@ -8803,7 +8843,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.5", ngImpor
 class TableColorDirective {
     /**
      * Use contextual color for tables, table rows or individual cells.
-     * @returns Colors
+     * @returns Colors | undefined
      */
     color = input(undefined, { ...(ngDevMode ? { debugName: "color" } : /* istanbul ignore next */ {}), alias: 'cTableColor' });
     hostClasses = computed(() => {
@@ -8858,8 +8898,7 @@ class TableDirective {
     #hostElement = inject(ElementRef);
     /**
      * Set the vertical alignment.
-     * @returns string
-     * @values 'bottom' | 'middle' | 'top'
+     * @returns 'bottom' | 'middle' | 'top'
      */
     align = input(/* @ts-ignore */
     ...(ngDevMode ? [undefined, { debugName: "align" }] : /* istanbul ignore next */ []));
@@ -8899,7 +8938,8 @@ class TableDirective {
     hover = input(false, { ...(ngDevMode ? { debugName: "hover" } : /* istanbul ignore next */ {}), transform: booleanAttribute });
     /**
      * 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'
      */
     responsive = input(/* @ts-ignore */
     ...(ngDevMode ? [undefined, { debugName: "responsive" }] : /* istanbul ignore next */ []));
@@ -9636,7 +9676,7 @@ class TabPanelComponent {
     #elementRef = inject(ElementRef);
     /**
      * aria-labelledby attribute
-     * @returns string
+     * @returns string | undefined
      * @default undefined
      */
     ariaLabelledBy = input(undefined, { ...(ngDevMode ? { debugName: "ariaLabelledBy" } : /* istanbul ignore next */ {}), alias: 'aria-labelledby' });
@@ -10089,7 +10129,7 @@ class ToasterComponent {
     }
     /**
      * Toaster position
-     * @returns (string | 'absolute' | 'fixed' | 'static')
+     * @returns string | 'absolute' | 'fixed' | 'static'
      */
     position = input('absolute', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "position" }] : /* istanbul ignore next */ []));
@@ -10229,7 +10269,7 @@ class TooltipComponent {
     renderer = inject(Renderer2);
     /**
      * Content of tooltip
-     * @returns {string | TemplateRef}
+     * @returns string | TemplateRef<any>
      */
     content = input('', /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "content" }] : /* istanbul ignore next */ []));
@@ -10315,7 +10355,7 @@ class TooltipDirective {
     #timerId2;
     /**
      * Content of tooltip
-     * @returns {string | TemplateRef}
+     * @returns string | TemplateRef<any> | undefined
      */
     content = input(undefined, { ...(ngDevMode ? { debugName: "content" } : /* istanbul ignore next */ {}), alias: 'cTooltip' });
     #contentEffect = effect(() => {
@@ -10343,21 +10383,22 @@ class TooltipDirective {
     ...(ngDevMode ? [{ debugName: "popperOptionsComputed" }] : /* istanbul ignore next */ []));
     /**
      * 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'
      */
     placement = input('top', { ...(ngDevMode ? { debugName: "placement" } : /* istanbul ignore next */ {}), alias: 'cTooltipPlacement' });
     /**
      * ElementRefDirective for positioning the tooltip on reference element
-     * @return: ElementRefDirective
-     * @default: undefined
+     * @returns ElementRefDirective | undefined
+     * @default undefined
+     * @since 5.1.0
      */
     reference = input(undefined, { ...(ngDevMode ? { debugName: "reference" } : /* istanbul ignore next */ {}), alias: 'cTooltipRef' });
     referenceRef = computed(() => this.reference()?.elementRef ?? this.#hostElement, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "referenceRef" }] : /* istanbul ignore next */ []));
     /**
      * 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[]
      */
     trigger = input('hover', { ...(ngDevMode ? { debugName: "trigger" } : /* istanbul ignore next */ {}), alias: 'cTooltipTrigger' });
     /**
@@ -10739,7 +10780,7 @@ class WidgetStatDComponent extends CardComponent {
     // override readonly color = input<Colors>();
     /**
      * Values and subtitles for your component.
-     * @returns WidgetStatDValue
+     * @returns WidgetStatDValue[]
      */
     values = input(/* @ts-ignore */
     ...(ngDevMode ? [undefined, { debugName: "values" }] : /* istanbul ignore next */ []));