@coreui/angular-pro 5.7.21 → 5.7.22

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coreui/angular-pro",
-  "version": "5.7.21",
+  "version": "5.7.22",
   "description": "CoreUI Pro Components Library for Angular",
   "copyright": "Copyright 2026 creativeLabs Łukasz Holeczek",
   "license": "SEE LICENSE IN LICENSE",

package/types/coreui-angular-pro.d.ts

@@ -36,6 +36,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;
@@ -407,7 +409,7 @@ declare class AutocompleteDirective implements OnInit, ControlValueAccessor {
      * - `'lg'`: Large size variant
      * - `undefined`: Default/medium size
      */
-    readonly sizing: _angular_core.InputSignal<string | undefined>;
+    readonly sizing: _angular_core.InputSignal<"" | "sm" | "lg" | undefined>;
     /**
      * Set form input validation state to valid.
      * @default undefined
@@ -710,7 +712,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>;
     /**
@@ -804,7 +806,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).
      */
@@ -852,9 +854,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
@@ -1302,6 +1304,10 @@ declare class CalendarComponent implements OnInit, AfterViewInit {
      * @returns string
      */
     readonly ariaPrevYearLabel: _angular_core.InputSignal<string>;
+    /**
+     * Event emitted on calendar cell hover.
+     * @returns Date | null
+     */
     readonly calendarCellHover: _angular_core.OutputEmitterRef<Date | null>;
     readonly hoverDate: _angular_core.WritableSignal<Date | null>;
     readonly hoverDateEffect: _angular_core.EffectRef;
@@ -1468,7 +1474,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>>;
@@ -1539,7 +1545,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[]>;
     /**
@@ -1878,7 +1884,7 @@ declare class DateRangePickerComponent implements OnInit, OnDestroy, ControlValu
      * @returns 'sm' | 'lg' | undefined
      * @default undefined
      */
-    readonly size: _angular_core.InputSignal<string | undefined>;
+    readonly size: _angular_core.InputSignal<"" | "sm" | "lg" | undefined>;
     /**
      * Keep track of the time with the date value.
      * @returns boolean
@@ -2150,9 +2156,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
@@ -2179,6 +2185,7 @@ interface IDropdownState {
 declare class DropdownService {
     #private;
     readonly dropdownState$: rxjs.Observable<any>;
+    readonly alignment: _angular_core.WritableSignal<DropdownAlignment | undefined>;
     toggle(state: IDropdownState): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DropdownService, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<DropdownService>;
@@ -2228,18 +2235,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>;
     /**
@@ -2256,8 +2266,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>);
@@ -2486,7 +2498,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
@@ -2505,7 +2517,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
@@ -2588,7 +2600,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>;
@@ -2625,7 +2637,7 @@ declare class FormPasswordDirective implements OnDestroy, 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
@@ -2651,7 +2663,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
@@ -2671,7 +2683,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>;
@@ -3018,7 +3030,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>;
     /**
@@ -3418,7 +3430,7 @@ declare class MultiSelectComponent<TValue extends string | number> implements IM
      * Size the component small or large.
      * @returns 'sm' | 'lg' | undefined
      */
-    readonly size: _angular_core.InputSignal<string | undefined>;
+    readonly size: _angular_core.InputSignal<"" | "sm" | "lg" | undefined>;
     /**
      * Initial value of multi-select
      * @returns (TValue | TValue[])
@@ -3690,8 +3702,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>;
     /**
@@ -4151,7 +4162,7 @@ declare class OneTimePasswordComponent implements ControlValueAccessor {
      * Sets the visual size of the Angular one-time password (OTP) input. Use 'sm' for small or 'lg' for large input fields.
      * @default: undefined
      */
-    readonly sizing: _angular_core.InputSignal<string | undefined>;
+    readonly sizing: _angular_core.InputSignal<"" | "sm" | "lg" | undefined>;
     /**
      * Input validation type: 'number' for digits only, or 'text' for free text.
      * @default: 'number'
@@ -4244,9 +4255,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
@@ -4602,7 +4613,7 @@ declare class RatingComponent implements ControlValueAccessor {
      * @returns: 'sm' | 'lg' | 'custom' | undefined
      * @default: undefined
      */
-    readonly size: _angular_core.InputSignal<string | undefined>;
+    readonly size: _angular_core.InputSignal<"" | "sm" | "lg" | "custom" | undefined>;
     /**
      * Enable tooltips with default values or set specific labels for each icon.
      * @returns: boolean | string[] | undefined
@@ -4637,7 +4648,7 @@ declare class RatingComponent implements ControlValueAccessor {
     readonly ratingItems: _angular_core.Signal<number[][]>;
     readonly ratingItemLabels: _angular_core.Signal<readonly RatingItemLabelComponent[]>;
     readonly hostClasses: _angular_core.Signal<{
-        [x: string]: string | boolean | undefined;
+        [x: string]: boolean | "" | "sm" | "lg" | "custom" | undefined;
         rating: boolean;
         disabled: boolean;
         readonly: boolean;
@@ -5498,7 +5509,7 @@ declare class SmartPaginationComponent {
      * Size the component small or large.
      * @values 'sm', 'lg'
      */
-    readonly size: _angular_core.InputSignal<string | undefined>;
+    readonly size: _angular_core.InputSignal<"" | "sm" | "lg" | undefined>;
     /**
      * Default role for pagination.
      * @returns string
@@ -6551,6 +6562,11 @@ declare class TabPaneComponent implements OnDestroy {
         show: boolean;
         active: boolean;
     };
+    /**
+     * Element role.
+     * @returns string
+     * @default 'tabpanel'
+     */
     role: string;
     ngOnDestroy(): void;
     subscribeTabService(subscribe?: boolean): void;
@@ -6636,7 +6652,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>;
     /**
@@ -6892,7 +6908,7 @@ declare class TimePickerComponent implements OnChanges, OnInit, AfterViewInit, C
      * @returns 'sm' | 'lg' | undefined
      * @default undefined
      */
-    readonly size: _angular_core.InputSignal<string | undefined>;
+    readonly size: _angular_core.InputSignal<"" | "sm" | "lg" | undefined>;
     /**
      * Initially selected time.
      * @returns Date | string | null | number
@@ -7547,7 +7563,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[]>;
@@ -7567,4 +7583,4 @@ declare class WidgetModule {
 }
 
 export { AccordionButtonDirective, AccordionComponent, AccordionItemComponent, AccordionModule, AlertComponent, AlertHeadingDirective, AlertLinkDirective, AlertModule, AlignDirective, AutocompleteDirective, AutocompleteModule, AvatarComponent, AvatarModule, BackdropService, BadgeComponent, BadgeModule, BgColorDirective, BorderDirective, BreadcrumbComponent, BreadcrumbItemComponent, BreadcrumbModule, BreadcrumbRouterComponent, BreadcrumbRouterService, BreakpointInfix, ButtonCloseDirective, ButtonDirective, ButtonGroupComponent, ButtonGroupModule, ButtonModule, ButtonToolbarComponent, CalendarComponent, CalendarModule, CalendarMonthComponent, CalendarNavigationComponent, 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, DatePickerComponent, DatePickerModule, DateRangePickerComponent, DateRangePickerModule, DropdownCloseDirective, DropdownComponent, DropdownDividerDirective, DropdownHeaderDirective, DropdownItemDirective, DropdownItemPlainDirective, DropdownMenuDirective, DropdownModule, DropdownService, DropdownToggleDirective, ElementCoverComponent, ElementCoverModule, ElementRefDirective, FooterComponent, FooterModule, FormCheckComponent, FormCheckInputDirective, FormCheckLabelDirective, FormControlDirective, FormDirective, FormFeedbackComponent, FormFloatingDirective, FormLabelDirective, FormModule, FormPasswordDirective, FormSelectDirective, FormTextDirective, GridModule, GutterDirective, HeaderBrandComponent, HeaderComponent, HeaderDividerComponent, HeaderModule, HeaderNavComponent, HeaderTextComponent, HeaderTogglerDirective, HtmlAttributesDirective, ImgDirective, ImgModule, InMemoryStorageService, InputGroupComponent, InputGroupTextDirective, IntersectionService, ListGroupDirective, ListGroupItemDirective, ListGroupModule, ListenersService, LoadingButtonComponent, LoadingButtonModule, LocalStorageService, ModalBodyComponent, ModalComponent, ModalContentComponent, ModalDialogComponent, ModalFooterComponent, ModalHeaderComponent, ModalModule, ModalService, ModalTitleDirective, ModalToggleDirective, MultiSelectComponent, MultiSelectModule, MultiSelectOptgroupComponent, MultiSelectOptgroupLabelComponent, MultiSelectOptionComponent, NavComponent, NavItemComponent, NavLinkDirective, NavModule, NavbarBrandDirective, NavbarComponent, NavbarModule, NavbarNavComponent, NavbarTextComponent, NavbarTogglerDirective, OffcanvasBodyComponent, OffcanvasComponent, OffcanvasHeaderComponent, OffcanvasModule, OffcanvasService, OffcanvasTitleDirective, OffcanvasToggleDirective, OneTimePasswordComponent, OneTimePasswordModule, OtpDirective, PageItemComponent, PageItemDirective, PageLinkDirective, PaginationComponent, PaginationModule, PlaceholderAnimationDirective, PlaceholderDirective, PlaceholderModule, PopoverComponent, PopoverDirective, PopoverModule, ProgressBarComponent, ProgressBarDirective, ProgressComponent, ProgressModule, ProgressStackedComponent, RangeSliderComponent, RangeSliderModule, RatingComponent, RatingModule, RoundedDirective, RowComponent, RowDirective, RtlService, SearchButtonComponent, SearchButtonModule, ShadowOnScrollDirective, SharedModule, SidebarBrandComponent, SidebarComponent, SidebarFooterComponent, SidebarHeaderComponent, SidebarModule, SidebarNavComponent, SidebarNavHelper, SidebarService, SidebarToggleDirective, SidebarTogglerDirective, SmartPaginationComponent, SmartPaginationModule, SmartTableComponent, SmartTableFilterComponent, SmartTableModule, SpinnerComponent, SpinnerModule, StepButtonDirective, StepperComponent, StepperModule, StepperStepComponent, TabContentComponent, TabContentRefDirective, TabDirective, TabPaneComponent, TabPanelComponent, TabService, TableActiveDirective, TableColorDirective, TableDirective, TableModule, Tabs2Module, TabsComponent, TabsContentComponent, TabsListComponent, TabsModule, TabsService, TemplateIdDirective, TextBgColorDirective, TextColorDirective, ThemeDirective, TimePickerComponent, TimePickerModule, 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, AutocompleteOption, BackgroundColors, BadgePositions, BooleanInput, BreakpointInfixStrings, Breakpoints, ButtonType, ColorMode, Colors, Directions, IAutocompleteOption, IAutocompleteOptionBase, IAutocompleteOptionNorm, IBreadcrumbItem, ICalendarRanges, IColumn, IColumnFilter, IColumnFilterValue, IGroup, IIntersectionObserverInit, IItem, IItemInternal, IListenersConfig, INavAttributes$1 as INavAttributes, INavData, INavLinkProps$1 as INavLinkProps, IOption, IProgress, IProgressBar, IProgressBarStacked, ISmartTable, ISorter, ISorterValue, ITableCellProps, ITableFilter, ITableHeaderCellProps, ITableSectionProps, InputType, ItemsPerPageSelect, Label, NgCssClass, NumberInput, Placements, Positions, Search, SearchButtonShortcut, SearchFn, Shapes, Sizes, SortOrder, StepperRef, StepperStepData, StepperStepValidationResult, TToasterPlacement, TextColors, ThumbSize, Triggers, ValueOrigin };
+export type { Alignment, AutocompleteOption, BackgroundColors, BadgePositions, BooleanInput, BreakpointInfixStrings, Breakpoints, ButtonType, ColorMode, Colors, Directions, DropdownAlignment, DropdownDirection, IAutocompleteOption, IAutocompleteOptionBase, IAutocompleteOptionNorm, IBreadcrumbItem, ICalendarRanges, IColumn, IColumnFilter, IColumnFilterValue, IGroup, IIntersectionObserverInit, IItem, IItemInternal, IListenersConfig, INavAttributes$1 as INavAttributes, INavData, INavLinkProps$1 as INavLinkProps, IOption, IProgress, IProgressBar, IProgressBarStacked, ISmartTable, ISorter, ISorterValue, ITableCellProps, ITableFilter, ITableHeaderCellProps, ITableSectionProps, InputType, ItemsPerPageSelect, Label, NgCssClass, NumberInput, Placements, Positions, Search, SearchButtonShortcut, SearchFn, Shapes, Sizes, SortOrder, StepperRef, StepperStepData, StepperStepValidationResult, TToasterPlacement, TextColors, ThumbSize, Triggers, ValueOrigin };