@coreui/angular 5.7.20 → 5.7.23

package/package.json

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

package/types/coreui-angular.d.ts

@@ -33,6 +33,8 @@ type BackgroundColors = Colors | 'body' | 'white' | 'transparent';
 type Directions = 'down' | 'up' | 'start' | 'end' | '';
 type TextColors = Colors | 'primary-emphasis' | 'secondary-emphasis' | 'success-emphasis' | 'danger-emphasis' | 'warning-emphasis' | 'info-emphasis' | 'light-emphasis' | 'body' | 'body-emphasis' | 'body-secondary' | 'body-tertiary' | 'black' | 'black-50' | 'white' | 'white-50' | string;
 type Alignment = 'baseline' | 'top' | 'middle' | 'bottom' | 'text-top' | 'text-bottom';
+type DropdownDirection = 'start' | 'end';
+type DropdownAlignment = DropdownDirection | Partial<Record<BreakpointInfixStrings, DropdownDirection>>;
 type BadgePositions = 'top-start' | 'top-end' | 'bottom-end' | 'bottom-start' | string | undefined;
 type Placements = 'auto' | 'auto-start' | 'auto-end' | 'top-end' | 'top' | 'top-start' | 'bottom-end' | 'bottom' | 'bottom-start' | 'right-start' | 'right' | 'right-end' | 'left-start' | 'left' | 'left-end' | undefined;
 type Shapes = 'rounded' | 'rounded-top' | 'rounded-end' | 'rounded-bottom' | 'rounded-start' | 'rounded-circle' | 'rounded-pill' | 'rounded-0' | 'rounded-1' | 'rounded-2' | 'rounded-3' | string;
@@ -75,6 +77,7 @@ declare class HtmlAttributesDirective {
      * @returns Record<string, any>
      */
     readonly cHtmlAttr: _angular_core.InputSignal<Record<string, any> | undefined>;
+    constructor();
     private setStyle;
     private addClass;
     private setAttrib;
@@ -408,7 +411,7 @@ declare class BreadcrumbItemComponent {
     readonly active: _angular_core.InputSignalWithTransform<boolean | undefined, unknown>;
     /**
      * The `url` prop for the inner `[routerLink]` directive
-     * @returns string
+     * @returns string | any[]
      */
     readonly url: _angular_core.InputSignal<string | any[] | undefined>;
     /**
@@ -502,7 +505,7 @@ declare class ButtonDirective {
      * Size the component small or large.
      * @returns 'sm' | 'lg' | ''
      */
-    readonly size: InputSignal<string>;
+    readonly size: InputSignal<"" | "sm" | "lg">;
     /**
      * The tabindex attribute specifies the tab order of an element (when the "tab" button is used for navigating).
      */
@@ -550,9 +553,9 @@ declare class ButtonModule {
 declare class ButtonGroupComponent {
     /**
      * Size the component small or large.
-     * @returns '' | 'sm' | 'lg' | string
+     * @returns '' | 'sm' | 'lg'
      */
-    readonly size: _angular_core.InputSignal<string | undefined>;
+    readonly size: _angular_core.InputSignal<"" | "sm" | "lg" | undefined>;
     /**
      * Create a set of buttons that appear vertically stacked rather than horizontally. Split button dropdowns are not supported here.
      * @returns boolean
@@ -655,7 +658,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'}
+     * @returns 'top' | 'bottom' | 'start' | 'end'
      */
     readonly orientation: _angular_core.InputSignal<"start" | "end" | "top" | "bottom" | undefined>;
     readonly hostClasses: _angular_core.Signal<Record<string, boolean>>;
@@ -726,7 +729,7 @@ declare class CarouselComponent implements OnInit, OnDestroy, AfterContentInit {
     readonly interval: _angular_core.WritableSignal<number>;
     /**
      * Sets which event handlers you’d like provided to your pause prop. You can specify one trigger or an array of them.
-     * @returns 'hover' | 'focus' | 'click'
+     * @returns Triggers | Triggers[] | false
      */
     readonly pause: _angular_core.InputSignal<false | Triggers | Triggers[]>;
     /**
@@ -961,9 +964,9 @@ declare class DropdownMenuDirective implements OnInit, AfterContentInit {
     readonly elementRef: ElementRef;
     /**
      * Set alignment of dropdown menu.
-     * @returns 'start' | 'end'
+     * @returns DropdownAlignment
      */
-    readonly alignment: _angular_core.InputSignal<string | undefined>;
+    readonly alignment: _angular_core.InputSignal<DropdownAlignment | undefined>;
     /**
      * Toggle the visibility of dropdown menu component.
      * @returns boolean
@@ -972,6 +975,7 @@ declare class DropdownMenuDirective implements OnInit, AfterContentInit {
     readonly visible: _angular_core.WritableSignal<boolean>;
     readonly hostClasses: _angular_core.Signal<Record<string, boolean>>;
     readonly hostStyles: _angular_core.Signal<Record<string, any>>;
+    readonly dataPopper: _angular_core.Signal<"static" | null>;
     onKeyDown($event: KeyboardEvent): void;
     onKeyUp($event: KeyboardEvent): void;
     readonly dropdownItemsContent: _angular_core.Signal<readonly DropdownItemDirective[]>;
@@ -990,6 +994,8 @@ interface IDropdownState {
 declare class DropdownService {
     #private;
     readonly dropdownState$: rxjs.Observable<any>;
+    readonly alignment: _angular_core.WritableSignal<DropdownAlignment | undefined>;
+    readonly popper: _angular_core.WritableSignal<boolean>;
     toggle(state: IDropdownState): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DropdownService, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<DropdownService>;
@@ -1039,18 +1045,21 @@ declare class DropdownComponent implements OnDestroy, OnInit {
     constructor();
     /**
      * Set alignment of dropdown menu.
-     * @returns {'start' | 'end' | { xs: 'start' | 'end' } | { sm: 'start' | 'end' } | { md: 'start' | 'end' } | { lg: 'start' | 'end' } | { xl: 'start' | 'end'} | { xxl: 'start' | 'end'}}
+     * @returns DropdownAlignment
      */
-    readonly alignment: _angular_core.InputSignal<string | undefined>;
+    readonly alignment: _angular_core.InputSignal<DropdownAlignment | undefined>;
     /**
-     * Automatically close dropdown when clicking outside the dropdown menu.
+     * Configure the auto close behavior: `true` closes the dropdown on a click inside or
+     * outside the menu, `false` only on the toggle button or an explicit hide/toggle call
+     * and not on the Esc key, `inside` only on a click inside the menu, `outside` only on
+     * a click outside it.
      * @returns boolean | 'inside' | 'outside'
      * @default true
      */
     readonly autoClose: _angular_core.InputSignal<boolean | "inside" | "outside">;
     /**
      * Sets a specified  direction and location of the dropdown menu.
-     * @returns 'dropup' | 'dropend' | 'dropstart'
+     * @returns 'center' | 'dropup' | 'dropup-center' | 'dropend' | 'dropstart'
      */
     readonly direction: _angular_core.InputSignal<"center" | "dropup" | "dropup-center" | "dropend" | "dropstart" | undefined>;
     /**
@@ -1067,8 +1076,10 @@ declare class DropdownComponent implements OnDestroy, OnInit {
      */
     readonly popper: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /**
-     * Optional popper Options object, `placement` prop takes precedence over
+     * Optional Popper.js options object; the `placement` prop takes precedence over the
+     * placement set here. See https://popper.js.org/docs/v2/constructors/#options
      * @returns Partial<Options>
+     * @default {}
      */
     readonly popperOptionsInput: _angular_core.InputSignal<Partial<Options>>;
     set popperOptions(value: Partial<Options>);
@@ -1266,7 +1277,7 @@ declare class FormCheckComponent {
      * Size the component large or extra large. Works only with `[switch]="true"`
      * @default undefined
      */
-    readonly sizing: _angular_core.InputSignal<string | undefined>;
+    readonly sizing: _angular_core.InputSignal<"" | "lg" | "xl" | undefined>;
     /**
      * Render a toggle switch on for checkbox.
      * @returns boolean
@@ -1285,7 +1296,7 @@ declare class FormControlDirective implements OnInit {
      * Size the component small or large.
      * @default undefined
      */
-    readonly sizing: _angular_core.InputSignal<string | undefined>;
+    readonly sizing: _angular_core.InputSignal<"" | "sm" | "lg" | undefined>;
     /**
      * Set component validation state to valid.
      * @default undefined
@@ -1368,7 +1379,7 @@ declare class FormLabelDirective {
      * Size the label small or large.
      * @default ''
      */
-    readonly sizing: _angular_core.InputSignal<string | undefined>;
+    readonly sizing: _angular_core.InputSignal<"" | "sm" | "lg" | undefined>;
     readonly hostClasses: _angular_core.Signal<Record<string, boolean>>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<FormLabelDirective, never>;
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<FormLabelDirective, "[cLabel]", never, { "col": { "alias": "cLabel"; "required": false; "isSignal": true; }; "sizing": { "alias": "sizing"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
@@ -1379,7 +1390,7 @@ declare class FormSelectDirective {
      * Size the component small or large.
      * @default undefined
      */
-    readonly sizing: _angular_core.InputSignal<string | undefined>;
+    readonly sizing: _angular_core.InputSignal<"" | "sm" | "lg" | undefined>;
     /**
      * Set component validation state to valid.
      * @default undefined
@@ -1399,7 +1410,7 @@ declare class InputGroupComponent {
     /**
      * Size the component small or large.
      */
-    readonly sizing: _angular_core.InputSignal<string | undefined>;
+    readonly sizing: _angular_core.InputSignal<"" | "sm" | "lg" | undefined>;
     readonly hostClasses: _angular_core.Signal<Record<string, boolean>>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<InputGroupComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<InputGroupComponent, "c-input-group", never, { "sizing": { "alias": "sizing"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
@@ -1746,7 +1757,7 @@ declare class ListGroupItemDirective {
     readonly active: InputSignalWithTransform<boolean, unknown>;
     /**
      * Sets the color context of the component to one of CoreUI’s themed colors.
-     * @returns InputSignal<Colors | undefined>
+     * @returns Colors
      */
     readonly color: InputSignal<string | undefined>;
     /**
@@ -1903,8 +1914,7 @@ declare class NavbarTogglerDirective {
     constructor();
     /**
      * Reference to navbar collapse element (via # template variable)
-     * @returns string
-     * @default 'button'
+     * @returns CollapseDirective
      */
     readonly collapseRef: _angular_core.InputSignal<CollapseDirective | undefined>;
     /**
@@ -2142,6 +2152,13 @@ declare class OffcanvasComponent implements OnInit, OnDestroy {
      * @default true
      */
     readonly backdrop: _angular_core.InputSignal<boolean | "static">;
+    /**
+     * Appends the offcanvas to a specific element. You can pass an HTML element or function that returns a single element. By default, `document.body`.
+     * @since 5.7.21
+     * @returns Element | (() => Element | null) | null
+     * @default document.body
+     */
+    readonly container: _angular_core.InputSignal<Element | (() => Element | null) | null>;
     /**
      * Closes the offcanvas when the escape key is pressed
      * @returns boolean
@@ -2154,6 +2171,13 @@ declare class OffcanvasComponent implements OnInit, OnDestroy {
      * @default 'start'
      */
     readonly placement: _angular_core.InputSignal<string>;
+    /**
+     * Generates offcanvas using a portal
+     * @since 5.7.21
+     * @returns boolean
+     * @default false
+     */
+    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';
@@ -2191,6 +2215,9 @@ declare class OffcanvasComponent implements OnInit, OnDestroy {
      */
     readonly visibleInput: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly visible: _angular_core.WritableSignal<boolean>;
+    protected readonly domPortal: DomPortal<any>;
+    protected domPortalOutlet: DomPortalOutlet;
+    protected domPortalCleanup: () => void;
     readonly visibleEffect: _angular_core.EffectRef;
     /**
      * Event triggered on visible change.
@@ -2213,7 +2240,7 @@ declare class OffcanvasComponent implements OnInit, OnDestroy {
     protected setBackdrop(setBackdrop: boolean | 'static'): void;
     private layoutChangeSubscribe;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<OffcanvasComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<OffcanvasComponent, "c-offcanvas", ["cOffcanvas"], { "backdrop": { "alias": "backdrop"; "required": false; "isSignal": true; }; "keyboard": { "alias": "keyboard"; "required": false; "isSignal": true; }; "placement": { "alias": "placement"; "required": false; "isSignal": true; }; "responsive": { "alias": "responsive"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "role": { "alias": "role"; "required": false; "isSignal": true; }; "ariaModal": { "alias": "ariaModal"; "required": false; "isSignal": true; }; "scroll": { "alias": "scroll"; "required": false; "isSignal": true; }; "visibleInput": { "alias": "visible"; "required": false; "isSignal": true; }; }, { "visibleChange": "visibleChange"; }, never, ["*"], true, [{ directive: typeof ThemeDirective; inputs: { "dark": "dark"; }; outputs: {}; }]>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<OffcanvasComponent, "c-offcanvas", ["cOffcanvas"], { "backdrop": { "alias": "backdrop"; "required": false; "isSignal": true; }; "container": { "alias": "container"; "required": false; "isSignal": true; }; "keyboard": { "alias": "keyboard"; "required": false; "isSignal": true; }; "placement": { "alias": "placement"; "required": false; "isSignal": true; }; "portal": { "alias": "portal"; "required": false; "isSignal": true; }; "responsive": { "alias": "responsive"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "role": { "alias": "role"; "required": false; "isSignal": true; }; "ariaModal": { "alias": "ariaModal"; "required": false; "isSignal": true; }; "scroll": { "alias": "scroll"; "required": false; "isSignal": true; }; "visibleInput": { "alias": "visible"; "required": false; "isSignal": true; }; }, { "visibleChange": "visibleChange"; }, never, ["*"], true, [{ directive: typeof ThemeDirective; inputs: { "dark": "dark"; }; outputs: {}; }]>;
 }
 
 declare class OffcanvasBodyComponent {
@@ -2308,9 +2335,9 @@ declare class PaginationComponent {
     readonly align: _angular_core.InputSignal<"" | "start" | "end" | "center">;
     /**
      * Size the component small or large.
-     * @returns '' | 'sm' | 'lg' | string
+     * @returns '' | 'sm' | 'lg'
      */
-    readonly size: _angular_core.InputSignal<string | undefined>;
+    readonly size: _angular_core.InputSignal<"" | "sm" | "lg" | undefined>;
     /**
      * Default role for pagination
      * @returns string
@@ -3357,6 +3384,11 @@ declare class TabPaneComponent implements OnDestroy {
         show: boolean;
         active: boolean;
     };
+    /**
+     * Element role.
+     * @returns string
+     * @default 'tabpanel'
+     */
     role: string;
     ngOnDestroy(): void;
     subscribeTabService(subscribe?: boolean): void;
@@ -3442,7 +3474,7 @@ declare class TabsComponent {
     readonly tabsService: TabsService;
     /**
      * The active item key.
-     * @returns <string | number | undefined>
+     * @returns number | string
      */
     readonly activeItemKey: _angular_core.ModelSignal<string | number | undefined>;
     /**
@@ -4143,7 +4175,7 @@ declare class WidgetStatFComponent extends CardComponent {
     readonly title: _angular_core.InputSignal<string | undefined>;
     /**
      * Value for your widget to display
-     * @returns string
+     * @returns string | number
      */
     readonly value: _angular_core.InputSignal<string | number | undefined>;
     readonly contentTemplates: _angular_core.Signal<readonly TemplateIdDirective[]>;
@@ -4163,4 +4195,4 @@ declare class WidgetModule {
 }
 
 export { AccordionButtonDirective, AccordionComponent, AccordionItemComponent, AccordionModule, AlertComponent, AlertHeadingDirective, AlertLinkDirective, AlertModule, AlignDirective, AvatarComponent, AvatarModule, BackdropService, BadgeComponent, BadgeModule, BgColorDirective, BorderDirective, BreadcrumbComponent, BreadcrumbItemComponent, BreadcrumbModule, BreadcrumbRouterComponent, BreadcrumbRouterService, BreakpointInfix, ButtonCloseDirective, ButtonDirective, ButtonGroupComponent, ButtonGroupModule, ButtonModule, ButtonToolbarComponent, CalloutComponent, CalloutModule, CardBodyComponent, CardComponent, CardFooterComponent, CardGroupComponent, CardHeaderActionsComponent, CardHeaderComponent, CardImgDirective, CardImgOverlayComponent, CardLinkDirective, CardModule, CardSubtitleDirective, CardTextDirective, CardTitleDirective, CarouselCaptionComponent, CarouselComponent, CarouselConfig, CarouselControlComponent, CarouselIndicatorsComponent, CarouselInnerComponent, CarouselItemComponent, CarouselModule, ClassToggleService, ColComponent, ColDirective, CollapseDirective, CollapseModule, ColorModeService, ContainerComponent, DropdownCloseDirective, DropdownComponent, DropdownDividerDirective, DropdownHeaderDirective, DropdownItemDirective, DropdownItemPlainDirective, DropdownMenuDirective, DropdownModule, DropdownService, DropdownToggleDirective, ElementRefDirective, FooterComponent, FooterModule, FormCheckComponent, FormCheckInputDirective, FormCheckLabelDirective, FormControlDirective, FormDirective, FormFeedbackComponent, FormFloatingDirective, FormLabelDirective, FormModule, FormSelectDirective, FormTextDirective, GridModule, GutterDirective, HeaderBrandComponent, HeaderComponent, HeaderDividerComponent, HeaderModule, HeaderNavComponent, HeaderTextComponent, HeaderTogglerDirective, HtmlAttributesDirective, ImgDirective, ImgModule, InMemoryStorageService, InputGroupComponent, InputGroupTextDirective, IntersectionService, ListGroupDirective, ListGroupItemDirective, ListGroupModule, ListenersService, LocalStorageService, ModalBodyComponent, ModalComponent, ModalContentComponent, ModalDialogComponent, ModalFooterComponent, ModalHeaderComponent, ModalModule, ModalService, ModalTitleDirective, ModalToggleDirective, NavComponent, NavItemComponent, NavLinkDirective, NavModule, NavbarBrandDirective, NavbarComponent, NavbarModule, NavbarNavComponent, NavbarTextComponent, NavbarTogglerDirective, OffcanvasBodyComponent, OffcanvasComponent, OffcanvasHeaderComponent, OffcanvasModule, OffcanvasService, OffcanvasTitleDirective, OffcanvasToggleDirective, PageItemComponent, PageItemDirective, PageLinkDirective, PaginationComponent, PaginationModule, PlaceholderAnimationDirective, PlaceholderDirective, PlaceholderModule, PopoverComponent, PopoverDirective, PopoverModule, ProgressBarComponent, ProgressBarDirective, ProgressComponent, ProgressModule, ProgressStackedComponent, RoundedDirective, RowComponent, RowDirective, RtlService, SearchButtonComponent, SearchButtonModule, ShadowOnScrollDirective, SharedModule, SidebarBrandComponent, SidebarComponent, SidebarFooterComponent, SidebarHeaderComponent, SidebarModule, SidebarNavComponent, SidebarNavHelper, SidebarService, SidebarToggleDirective, SidebarTogglerDirective, SpinnerComponent, SpinnerModule, TabContentComponent, TabContentRefDirective, TabDirective, TabPaneComponent, TabPanelComponent, TabService, TableActiveDirective, TableColorDirective, TableDirective, TableModule, Tabs2Module, TabsComponent, TabsContentComponent, TabsListComponent, TabsModule, TabsService, TemplateIdDirective, TextBgColorDirective, TextColorDirective, ThemeDirective, ToastBodyComponent, ToastCloseDirective, ToastComponent, ToastContentComponent, ToastHeaderComponent, ToastModule, ToasterComponent, ToasterHostDirective, ToasterPlacement, ToasterService, TooltipComponent, TooltipDirective, TooltipModule, UIDService, UtilitiesModule, WidgetModule, WidgetStatAComponent, WidgetStatBComponent, WidgetStatCComponent, WidgetStatDComponent, WidgetStatEComponent, WidgetStatFComponent };
-export type { Alignment, BackgroundColors, BadgePositions, BooleanInput, BreakpointInfixStrings, Breakpoints, ButtonType, ColorMode, Colors, Directions, IBreadcrumbItem, IIntersectionObserverInit, IListenersConfig, INavAttributes$1 as INavAttributes, INavData, INavLinkProps$1 as INavLinkProps, IProgress, IProgressBar, IProgressBarStacked, InputType, NgCssClass, NumberInput, Placements, Positions, SearchButtonShortcut, Shapes, Sizes, TToasterPlacement, TextColors, Triggers };
+export type { Alignment, BackgroundColors, BadgePositions, BooleanInput, BreakpointInfixStrings, Breakpoints, ButtonType, ColorMode, Colors, Directions, DropdownAlignment, DropdownDirection, IBreadcrumbItem, IIntersectionObserverInit, IListenersConfig, INavAttributes$1 as INavAttributes, INavData, INavLinkProps$1 as INavLinkProps, IProgress, IProgressBar, IProgressBarStacked, InputType, NgCssClass, NumberInput, Placements, Positions, SearchButtonShortcut, Shapes, Sizes, TToasterPlacement, TextColors, Triggers };