@coreui/angular 5.7.37 → 5.7.40

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coreui/angular",
-  "version": "5.7.37",
+  "version": "5.7.40",
   "description": "CoreUI Components Library for Angular",
   "copyright": "Copyright 2026 creativeLabs Łukasz Holeczek",
   "license": "MIT",
@@ -28,8 +28,8 @@
     "@angular/common": "^22.2.0",
     "@angular/core": "^22.2.0",
     "@angular/router": "^22.2.0",
-    "@coreui/coreui": "^5.9.0",
-    "@coreui/icons-angular": "~5.7.37",
+    "@coreui/coreui": "^5.9.1",
+    "@coreui/icons-angular": "~5.7.40",
     "rxjs": "^7.8.2"
   },
   "repository": {

package/types/coreui-angular.d.ts

@@ -1,6 +1,6 @@
 import { IsActiveMatchOptions, NavigationEnd, Router, UrlTree } from "@angular/router";
 import * as i0 from "@angular/core";
-import { AfterContentChecked, AfterContentInit, AfterViewInit, AnimationCallbackEvent, ChangeDetectorRef, ComponentRef, DestroyRef, ElementRef, Injector, InputSignal, InputSignalWithTransform, ModuleWithProviders, NgModuleRef, OnChanges, OnDestroy, OnInit, PipeTransform, QueryList, Renderer2, SimpleChanges, TemplateRef, ViewContainerRef, WritableSignal } from "@angular/core";
+import { AfterContentChecked, AfterContentInit, AfterViewChecked, AfterViewInit, AnimationCallbackEvent, ChangeDetectorRef, ComponentRef, DestroyRef, ElementRef, Injector, InputSignal, InputSignalWithTransform, ModuleWithProviders, NgModuleRef, OnChanges, OnDestroy, OnInit, PipeTransform, QueryList, Renderer2, SimpleChanges, TemplateRef, ViewContainerRef, WritableSignal } from "@angular/core";
 import { Observable, Subscription } from "rxjs";
 import { CdkTrapFocus, FocusOrigin, FocusableOption } from "@angular/cdk/a11y";
 import { Options, Placement } from "@popperjs/core";
@@ -102,12 +102,12 @@ export declare class TemplateIdDirective {
 export declare class ThemeDirective {
   #private;
   /**
-   * Sets the `data-coreui-theme` attribute on the host element. Overridden by `dark`.
+   * Sets the `data-coreui-theme` attribute on the host element.
    * @returns 'dark' | 'light'
    */
   readonly colorScheme: import("@angular/core").InputSignal<"dark" | "light" | undefined>;
   /**
-   * Applies the dark color scheme, regardless of `colorScheme`.
+   * Applies the dark color scheme. On `cTheme` it takes precedence over `colorScheme`.
    * @returns boolean
    * @default false
    */
@@ -536,9 +536,46 @@ export declare class BackdropService {
   readonly backdropClick$: import("rxjs").Observable<boolean>;
   activeBackdrop: any;
   scrollbarWidth: string;
-  setBackdrop(type?: string): HTMLDivElement;
+  /**
+   * Returns the backdrop element of a type, shared by everyone who sets it; a fading backdrop of the type comes back.
+   * Pair every call with `clearBackdrop()`.
+   * @param type the backdrop type, rendered as the `<type>-backdrop` class
+   * @param fade fade the backdrop in and out, as the latest call asks; without it the backdrop shows at once and goes once released (since 5.7.38)
+   * @returns the backdrop element
+   */
+  setBackdrop(type?: string, fade?: boolean): HTMLDivElement;
+  /**
+   * Releases one use of a backdrop; the last release fades it out and removes it once its transition ends.
+   * A backdrop set again before its fade starts (a microtask after the last release) comes back without fading.
+   * Does nothing for an element the service does not hold in use.
+   * @param backdropElement the element `setBackdrop()` returned
+   * @returns `undefined`, to clear the caller's reference
+   */
   clearBackdrop(backdropElement: HTMLElement): any;
+  /**
+   * Locks page scrolling for an owner: hides the body overflow and pads the body by the scrollbar width.
+   * The lock stays while any owner holds it; locking twice for the same owner counts once.
+   * @since 5.7.38
+   * @param owner the component or object holding the lock
+   */
+  lockScroll(owner: object): void;
+  /**
+   * Releases the scroll lock of an owner; once the last owner releases it, the overflow and the padding property the lock set
+   * are removed (a page's own inline padding on that side, overwritten by the lock, is not restored).
+   * Does nothing for an owner that holds no lock.
+   * @since 5.7.38
+   * @param owner the component or object that locked scrolling
+   */
+  unlockScroll(owner: object): void;
+  /**
+   * Locks page scrolling on behalf of the service itself.
+   * @deprecated 5.7.38. Use `lockScroll(owner)` instead.
+   */
   hideScrollbar(): void;
+  /**
+   * Releases the lock taken by `hideScrollbar()`; locks of other owners stay.
+   * @deprecated 5.7.38. Use `unlockScroll(owner)` instead.
+   */
   resetScrollbar(): void;
   onClickHandler(): void;
   static ɵfac: i0.ɵɵFactoryDeclaration<BackdropService, never>;
@@ -2258,6 +2295,9 @@ export declare class DropdownComponent implements OnDestroy, OnInit {
    * - `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.
+   *
+   * A click on a form field or inside a form in the menu does not close it; `cDropdownClose` and
+   * `cDropdownItem` close it from there, but not on a click on a field that takes typing or a choice inside the item.
    * @returns boolean | 'inside' | 'outside'
    * @default true
    */
@@ -2323,8 +2363,6 @@ export declare class DropdownComponent implements OnDestroy, OnInit {
   } | {
     display?: undefined;
   }>;
-  private clickedTarget;
-  onHostClick($event: MouseEvent): void;
   dropdownStateSubscribe(): void;
   toggleDropdown(): void;
   onClick(event: any): void;
@@ -2398,7 +2436,8 @@ export declare class DropdownItemDirective implements FocusableOption {
    */
   readonly active: import("@angular/core").InputSignal<boolean | undefined>;
   /**
-   * Configure dropdown-item close dropdown behavior.
+   * Configure dropdown-item close dropdown behavior. The item does not close the dropdown on a click on a field inside
+   * it that takes typing or a choice (input other than a button, select, textarea, contenteditable).
    * @returns boolean
    * @default true
    */
@@ -2623,7 +2662,9 @@ export declare class FormControlDirective implements OnInit {
    */
   readonly sizing: import("@angular/core").InputSignal<"" | "sm" | "lg" | undefined>;
   /**
-   * Set component validation state to valid.
+   * Validation state: `true` valid, `false` invalid, which also sets `aria-invalid="true"`
+   * (not on button-like, `color` and `hidden` inputs, where `aria-invalid` is left to the page), `undefined` none.
+   * Do not bind `aria-invalid` on the same element as well.
    * @default undefined
    */
   readonly valid: import("@angular/core").InputSignal<boolean | undefined>;
@@ -2677,7 +2718,8 @@ export declare class FormCheckInputDirective {
   readonly indeterminateInput: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
   get indeterminate(): boolean;
   /**
-   * Set component validation state to valid.
+   * Validation state: `true` valid, `false` invalid, which also sets `aria-invalid="true"`, `undefined` none.
+   * Do not bind `aria-invalid` on the same element as well.
    * @default undefined
    */
   readonly valid: import("@angular/core").InputSignal<boolean | undefined>;
@@ -2772,13 +2814,15 @@ export declare class FormLabelDirective {
   }, {}, never, never, true, never>;
 }
 export declare class FormSelectDirective {
+  #private;
   /**
    * Size the component small or large.
    * @default undefined
    */
   readonly sizing: import("@angular/core").InputSignal<"" | "sm" | "lg" | undefined>;
   /**
-   * Set component validation state to valid.
+   * Validation state: `true` valid, `false` invalid, which also sets `aria-invalid="true"`, `undefined` none.
+   * Do not bind `aria-invalid` on the same element as well.
    * @default undefined
    */
   readonly valid: import("@angular/core").InputSignal<boolean | undefined>;
@@ -2855,15 +2899,6 @@ export declare class ContainerComponent {
   }, {}, never, ["*"], true, never>;
 }
 type ColOrder = (number | 'first' | 'last');
-type ColBreakpoint = (BooleanInput$1 | NumberInput$1);
-interface ICol {
-  xs?: (BooleanInput$1 | NumberInput$1);
-  sm?: (BooleanInput$1 | NumberInput$1);
-  md?: (BooleanInput$1 | NumberInput$1);
-  lg?: (BooleanInput$1 | NumberInput$1);
-  xl?: (BooleanInput$1 | NumberInput$1);
-  xxl?: (BooleanInput$1 | NumberInput$1);
-}
 type ColOffsetType = number | {
   xs?: number;
   sm?: number;
@@ -2990,14 +3025,6 @@ export declare class ColComponent extends ColDirective {
   static ɵcmp: i0.ɵɵComponentDeclaration<ColComponent, "c-col", never, {}, {}, never, ["*"], true, never>;
 }
 type NumberOfColumns = number | 'auto';
-interface IRow {
-  xs?: NumberOfColumns;
-  sm?: NumberOfColumns;
-  md?: NumberOfColumns;
-  lg?: NumberOfColumns;
-  xl?: NumberOfColumns;
-  xxl?: NumberOfColumns;
-}
 export declare class RowDirective {
   /**
    * The number of columns/offset/order on extra small devices (<576px).
@@ -3872,11 +3899,11 @@ export declare class ModalComponent implements OnInit, OnDestroy, AfterViewInit
    */
   readonly keyboard: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
   /**
-   * HTML id attribute, required for programmatic visibility change.
+   * HTML id attribute, used to toggle the modal by id. Without it, the `id` property holds a generated id that is not rendered.
    * @returns string
    */
   readonly attrId: import("@angular/core").InputSignal<string | undefined>;
-  get id(): string | undefined;
+  get id(): string;
   /**
    * Generates modal using a portal
    * @since 5.7.20
@@ -4028,7 +4055,26 @@ interface IModalAction {
 export declare class ModalService {
   #private;
   readonly modalState$: import("rxjs").Observable<any>;
+  /** Emits once a modal has opened through `toggle()`; the other visible modals close on it. */
+  readonly opened$: import("rxjs").Observable<{
+    modal: ModalComponent;
+    focusFallback: (HTMLElement | null)[];
+  }>;
   toggle(action: IModalAction): void;
+  announceOpened(modal: ModalComponent, focusFallback: (HTMLElement | null)[]): void;
+  /**
+   * Adds the `modal-open` class to the body on behalf of a modal; the class stays while any modal holds it.
+   * @since 5.7.38
+   * @param modal the open modal
+   */
+  addOpenClass(modal: ModalComponent): void;
+  /**
+   * Releases the `modal-open` class held by a modal; the body loses it once no modal holds it.
+   * Does nothing for a modal that holds no class.
+   * @since 5.7.38
+   * @param modal the modal that added the class
+   */
+  removeOpenClass(modal: ModalComponent): void;
   static ɵfac: i0.ɵɵFactoryDeclaration<ModalService, never>;
   static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
@@ -4096,7 +4142,7 @@ export declare class OffcanvasComponent implements OnInit, OnDestroy {
    */
   readonly ariaModal: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
   /**
-   * Allow body scrolling while offcanvas is visible.
+   * Allow body scrolling while the offcanvas is open. Changes apply while it is open.
    * @returns boolean
    * @default false
    */
@@ -4119,6 +4165,7 @@ export declare class OffcanvasComponent implements OnInit, OnDestroy {
   readonly visibleChange: import("@angular/core").OutputEmitterRef<boolean>;
   readonly hostClasses: import("@angular/core").Signal<Record<string, boolean>>;
   readonly ariaHidden: import("@angular/core").Signal<true | null>;
+  protected readonly hostInert: import("@angular/core").Signal<true | null>;
   get tabIndex(): string | null;
   get show(): boolean;
   set show(value: boolean);
@@ -4443,7 +4490,7 @@ export declare class PopoverComponent implements OnDestroy {
     };
   }, {}, never, never, true, never>;
 }
-export declare class PopoverDirective implements OnDestroy, OnInit, AfterViewInit {
+export declare class PopoverDirective implements OnDestroy, OnInit, AfterViewChecked, AfterViewInit {
   #private;
   /**
    * Content of popover
@@ -4487,17 +4534,16 @@ export declare class PopoverDirective implements OnDestroy, OnInit, AfterViewIni
   readonly visible: import("@angular/core").ModelSignal<boolean>;
   get ariaDescribedBy(): string | null;
   private tooltip;
-  private tooltipId;
   private tooltipRef;
-  private popperInstance;
+  private popperInstance?;
   private _popperOptions;
+  ngAfterViewChecked(): void;
   ngAfterViewInit(): void;
   ngOnDestroy(): void;
   ngOnInit(): void;
   private setListeners;
   private clearListeners;
   private intersectionServiceSubscribe;
-  private getUID;
   private createTooltipElement;
   private destroyTooltipElement;
   private addTooltipElement;
@@ -4815,16 +4861,6 @@ type SearchButtonShortcut = {
   };
   shortcut: string;
 };
-declare const normalizeKey: (key: string) => string;
-declare const parseShortcut: (shortcut: string) => SearchButtonShortcut[];
-declare const isMacOS: () => boolean;
-declare const getPreferredShortcut: (shortcuts: SearchButtonShortcut[]) => SearchButtonShortcut;
-declare const getKeyLabel: (key: string) => string;
-declare const formatShortcutTokens: (shortcut: string) => string[];
-declare const getPressedKeys: (event: KeyboardEvent) => Set<string>;
-declare const isEditableTarget: (target: EventTarget | null) => boolean;
-declare const shouldIgnoreShortcut: (event: KeyboardEvent) => boolean;
-declare const matchesShortcut: (shortcut: SearchButtonShortcut, event: KeyboardEvent) => boolean;
 interface IIntersectionObserverInit {
   root?: Element | null;
   rootMargin?: string;
@@ -4910,6 +4946,12 @@ export declare class ColorModeService {
 }
 export declare class UIDService {
   #private;
+  /**
+   * Returns an id no other call on this service instance returns, skipping ids already in the document.
+   * The random infix, drawn once per instance, keeps it apart from other instances, applications and page ids.
+   * @param prefix id prefix
+   * @returns `${prefix}-${infix}-${count}`
+   */
   getUID(prefix?: string): string;
   static ɵfac: i0.ɵɵFactoryDeclaration<UIDService, never>;
   static ɵprov: i0.ɵɵInjectableDeclaration<any>;
@@ -5219,14 +5261,6 @@ interface INavData {
   wrapper?: INavWrapper;
   linkProps?: INavLinkProps$1;
 }
-declare abstract class SidebarNavService {
-  /**
-   * Returns a sidebar-nav items config NavData
-   */
-  abstract getSidebarNavItemsConfig(): INavData[];
-  static ɵfac: i0.ɵɵFactoryDeclaration<SidebarNavService, never>;
-  static ɵprov: i0.ɵɵInjectableDeclaration<any>;
-}
 export declare class SidebarNavHelper {
   itemType(item: INavData): string;
   isActive(router: any, item: INavData): boolean;
@@ -6435,7 +6469,7 @@ export declare class TooltipComponent implements OnDestroy {
     };
   }, {}, never, never, true, never>;
 }
-export declare class TooltipDirective implements OnDestroy, OnInit, AfterViewInit {
+export declare class TooltipDirective implements OnDestroy, OnInit, AfterViewChecked, AfterViewInit {
   #private;
   /**
    * Content of tooltip
@@ -6479,17 +6513,16 @@ export declare class TooltipDirective implements OnDestroy, OnInit, AfterViewIni
   readonly visible: import("@angular/core").ModelSignal<boolean>;
   get ariaDescribedBy(): string | null;
   private tooltip;
-  private tooltipId;
   private tooltipRef;
-  private popperInstance;
+  private popperInstance?;
   private _popperOptions;
+  ngAfterViewChecked(): void;
   ngAfterViewInit(): void;
   ngOnDestroy(): void;
   ngOnInit(): void;
   private setListeners;
   private clearListeners;
   private intersectionServiceSubscribe;
-  private getUID;
   private createTooltipElement;
   private destroyTooltipElement;
   private addTooltipElement;
@@ -6800,7 +6833,7 @@ export declare class WidgetStatCComponent extends CardComponent {
       "required": false;
       "isSignal": true;
     };
-  }, {}, ["contentTemplates"], ["*"], true, never>;
+  }, {}, ["contentTemplates"], never, true, never>;
 }
 type WidgetStatDValue = {
   title?: string;
@@ -6894,7 +6927,7 @@ export declare class WidgetStatFComponent extends CardComponent {
   readonly titleClasses: import("@angular/core").Signal<Record<string, boolean>>;
   readonly valueClasses: import("@angular/core").Signal<Record<string, boolean>>;
   static ɵfac: i0.ɵɵFactoryDeclaration<WidgetStatFComponent, never>;
-  static ɵcmp: i0.ɵɵComponentDeclaration<WidgetStatFComponent, "c-widget-stat-f", ["cWidgetStatB"], {
+  static ɵcmp: i0.ɵɵComponentDeclaration<WidgetStatFComponent, "c-widget-stat-f", ["cWidgetStatF", "cWidgetStatB"], {
     "footer": {
       "alias": "footer";
       "required": false;