@cute-widgets/base 20.0.1

package/core/index.d.ts

@@ -0,0 +1,1039 @@
+import * as i0 from '@angular/core';
+import { InjectionToken, QueryList, ElementRef, OnDestroy, Provider, PipeTransform } from '@angular/core';
+import * as i1 from '@angular/common';
+import { RichThemeColor as RichThemeColor$1 } from '@cute-widgets/base/core/theming';
+import * as rxjs from 'rxjs';
+import { Subject, Observable } from 'rxjs';
+import { DomSanitizer, SafeValue } from '@angular/platform-browser';
+
+/** Object used to configure the animation in Angular Material. */
+interface AnimationsConfig {
+    /** Whether all animations should be disabled. */
+    animationsDisabled?: boolean;
+}
+/** Injection token used to configure the animations in CuteWidgets. */
+declare const CUTE_WIDGETS_ANIMATIONS: InjectionToken<AnimationsConfig>;
+/**
+ * @deprecated No longer used, will be removed.
+ * @breaking-change 21.0.0
+ * @docs-private
+ */
+declare class AnimationCurves {
+    static STANDARD_CURVE: string;
+    static DECELERATION_CURVE: string;
+    static ACCELERATION_CURVE: string;
+    static SHARP_CURVE: string;
+}
+/**
+ * @deprecated No longer used, will be removed.
+ * @breaking-change 21.0.0
+ * @docs-private
+ */
+declare class AnimationDurations {
+    static COMPLEX: string;
+    static ENTERING: string;
+    static EXITING: string;
+}
+/**
+ * Gets the configured animations state.
+ * @docs-private
+ */
+declare function _getAnimationsState(): 'enabled' | 'di-disabled' | 'reduced-motion';
+/**
+ * Returns whether animations have been disabled by DI. Must be called in a DI context.
+ * @docs-private
+ */
+declare function _animationsDisabled(): boolean;
+
+/**
+ * @license Apache-2.0
+ *
+ * Copyright (c) 2025 CuteWidgets Team. All Rights Reserved.
+ *
+ * You may not use this file except in compliance with the License
+ * that can be found at http://www.apache.org/licenses/LICENSE-2.0
+ */
+/**
+ * Bootstrap media-queries, or `breakpoints`.
+ * PascalCase is being used as Breakpoints is used like an enum.
+ */
+declare const bsBreakpoints: {
+    SmallAndDown: string;
+    MediumAndDown: string;
+    LargeAndDown: string;
+    XLargeAndDown: string;
+    XXLargeAndDown: string;
+    XSmall: string;
+    Small: string;
+    Medium: string;
+    Large: string;
+    XLarge: string;
+    XXLarge: string;
+    readonly grid: {
+        xs: number;
+        sm: number;
+        md: number;
+        lg: number;
+        xl: number;
+        xxl: number;
+    };
+    readonly xs: string;
+    readonly sm: string;
+    readonly md: string;
+    readonly lg: string;
+    readonly xl: string;
+    readonly xxl: string;
+    /**
+     * Gets the object's property name of the media-query by its value
+     * @param query The media-query text
+     * @returns The property name of the media-query or _undefined_ if it was not found
+     */
+    getQueryName(query: string): string | undefined;
+    /**
+     * Gets the breakpoint label by Bootstrap's breakpoint abbreviation
+     * @param code Bootstrap's breakpoint abbreviation
+     * @returns More descriptive text of the abbreviation
+     */
+    getLabel(code: string): string;
+};
+
+/**
+ * @license Apache-2.0
+ *
+ * Copyright (c) 2025 CuteWidgets Team. All Rights Reserved.
+ *
+ * You may not use this file except in compliance with the License
+ * that can be found at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * This code is a modification of the `@angular/material` original
+ * code licensed under MIT-style License (https://angular.dev/license).
+ */
+
+/**
+ * Shared directive to count lines inside a text area, such as a list item.
+ * Line elements can be extracted with a @ContentChildren(CuteLine) query, then
+ * counted by checking the query list's length.
+ */
+declare class CuteLine {
+    static ɵfac: i0.ɵɵFactoryDeclaration<CuteLine, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<CuteLine, "[cute-line], [cuteLine]", never, {}, {}, never, never, true, never>;
+}
+/**
+ * Helper that takes a query list of lines and sets the correct class on the host.
+ */
+declare function setLines(lines: QueryList<unknown>, element: ElementRef<HTMLElement>, prefix?: string): void;
+
+declare class CuteLineModule {
+    static ɵfac: i0.ɵɵFactoryDeclaration<CuteLineModule, never>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<CuteLineModule, never, [typeof i1.CommonModule, typeof CuteLine], [typeof CuteLine]>;
+    static ɵinj: i0.ɵɵInjectorDeclaration<CuteLineModule>;
+}
+
+/**
+ * @license Apache-2.0
+ *
+ * Copyright (c) 2025 CuteWidgets Team. All Rights Reserved.
+ *
+ * You may not use this file except in compliance with the License
+ * that can be found at http://www.apache.org/licenses/LICENSE-2.0
+ */
+type RippleOptions = {
+    centered?: boolean;
+    color?: string | null;
+    duration?: string | number;
+};
+declare abstract class Ripple {
+    private _active;
+    private _disabled;
+    private readonly _target;
+    protected constructor(target: HTMLElement);
+    get disabled(): boolean;
+    set disabled(v: boolean);
+    isActive: i0.Signal<boolean>;
+    stop(): void;
+    launch(event: MouseEvent, options?: RippleOptions): void;
+}
+
+/**
+ * @license Apache-2.0
+ *
+ * Copyright (c) 2025 CuteWidgets Team. All Rights Reserved.
+ *
+ * You may not use this file except in compliance with the License
+ * that can be found at http://www.apache.org/licenses/LICENSE-2.0
+ */
+
+declare class RippleManager {
+    private static readonly _ripples;
+    static getInstance(target: HTMLElement): Ripple;
+    static createRipple(target: HTMLElement): Ripple;
+    static removeRipple(target: HTMLElement): void;
+}
+
+/**
+ * @license Apache-2.0
+ *
+ * Copyright (c) 2025 CuteWidgets Team. All Rights Reserved.
+ *
+ * You may not use this file except in compliance with the License
+ * that can be found at http://www.apache.org/licenses/LICENSE-2.0
+ */
+
+declare class CuteRipple/* extends ... */  implements OnDestroy {
+    private _elemRef;
+    private readonly _ripple;
+    rippleOptions: RippleOptions | undefined;
+    protected onMouseDown(event: MouseEvent): void;
+    constructor(_elemRef: ElementRef<HTMLElement>);
+    ngOnDestroy(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CuteRipple, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<CuteRipple, "[cuteRipple]", ["cuteRipple"], { "rippleOptions": { "alias": "cuteRipple"; "required": false; }; }, {}, never, never, true, never>;
+}
+
+interface Focusable {
+    focus(): void;
+}
+
+interface MenuAction {
+    type: "RouterLink" | "ExternalURL" | "AppEvent" | "DwScript";
+    text: string;
+    target?: "Main" | "Popup" | "Response";
+}
+
+/**
+ * @license Apache-2.0
+ *
+ * Copyright (c) 2025 CuteWidgets Team. All Rights Reserved.
+ *
+ * You may not use this file except in compliance with the License
+ * that can be found at http://www.apache.org/licenses/LICENSE-2.0
+ */
+
+/**
+ * A structure that populates the properties for individual items in a TreeView control.
+ */
+interface TreeNode<D = unknown> {
+    /** Unique identifier */
+    id?: string;
+    /** Identifies the string label associated with the item. */
+    label: string;
+    /** Specifies whether the item has children. */
+    hasChildren?: boolean;
+    /** Children items. */
+    children?: TreeNode<D>[];
+    /** Item short description */
+    microHelp?: string;
+    /** Indicates the level of the item in the TreeView control. */
+    level?: number;
+    /** Any user-defined data. */
+    data?: D;
+    /** Router link. */
+    routerLink?: string | string[];
+    /** Identifies the picture displayed to the left of the item label. */
+    icon?: string;
+    /** Icon color. */
+    iconColor?: string;
+    /** Icon CSS class(es). */
+    iconClass?: string | string[] | Record<string, boolean>;
+    /** Identifies the state picture associated with the item. */
+    stateIcon?: string;
+    /** The badge text associated with the item. */
+    badge?: string;
+    /** Badge theme color. */
+    badgeColor?: RichThemeColor$1;
+    /** Is node enabled? Default is _true_. */
+    enabled?: (() => boolean) | boolean;
+    /** Is node visible? Default is _true_. */
+    visible?: (() => boolean) | boolean;
+    status?: {
+        /** Specifies whether the node is expanded. */
+        expanded?: boolean;
+        /** Specifies whether the node has been populated with children. */
+        populated?: boolean;
+        /** Specifies whether the item has focus. */
+        hasFocus?: boolean;
+        /** Specifies whether the item is selected. */
+        selection?: 'checked' | 'indeterminate' | 'unchecked';
+    };
+}
+
+interface ToolbarItem {
+    /** Icon ligature */
+    icon?: string;
+    /** Icon color */
+    iconColor?: string;
+    /** Specifies the order of the item in the toolbar */
+    order?: number;
+    /** Specifies the amount of empty space before the item in the toolbar */
+    spaces?: number;
+    /** Specifies the text that displays in the toolbar item when the display text option is on for toolbars */
+    text?: string;
+    /** Specifies whether the toolbar item displays. Default is _false_ */
+    visible?: boolean;
+}
+
+/**
+ * @license Apache-2.0
+ *
+ * Copyright (c) 2025 CuteWidgets Team. All Rights Reserved.
+ *
+ * You may not use this file except in compliance with the License
+ * that can be found at http://www.apache.org/licenses/LICENSE-2.0
+ */
+
+/**
+ * Menu Item interface is used for items in a drop-down or cascading menu
+ */
+interface MenuItem<D = unknown> extends TreeNode<D> {
+    /** An array of the submenu items. */
+    children?: MenuItem<D>[];
+    /** Whether an item is the default item. */
+    default?: (() => boolean) | boolean;
+    /** Is item checked? Default is _false_. */
+    checked?: (() => boolean) | boolean;
+    /** Item is clicked (selected or unselected). */
+    clicked?: () => void;
+    /** Toolbar's item definition. */
+    toolBarItem?: ToolbarItem;
+}
+
+interface MenuOwner extends Focusable {
+    menuItemClicked: (mi: MenuItem) => void;
+}
+
+/** A permissive type for a class constructor */
+type Constructor<T = {}> = new (...args: any[]) => T;
+/** A permissive type for abstract class constructors  */
+type AbstractConstructor<T = {}> = abstract new (...args: any[]) => T;
+
+/** Alignment of flex items on the main axis of the flexbox container */
+type ContentAlignment = "start" | "end" | "center" | "between" | "around" | "evenly";
+
+type LayoutBreakpoint = "xs" | "sm" | "md" | "lg" | "xl" | "xxl";
+
+type LayoutDirection = "column" | "row";
+
+type LayoutOrientation = "horizontal" | "vertical";
+
+/**
+ * @license Apache-2.0
+ *
+ * Copyright (c) 2025 CuteWidgets Team. All Rights Reserved.
+ *
+ * You may not use this file except in compliance with the License
+ * that can be found at http://www.apache.org/licenses/LICENSE-2.0
+ */
+type MouseGeneralCursor = "auto" | "default" | "none";
+type MouseLinkAndStatusCursor = "context-menu" | "help" | "pointer" | "progress" | "wait";
+type MouseSelectionCursor = "cell" | "crosshair" | "text" | "vertical-text";
+type MouseDragAndDropCursor = "alias" | "copy" | "move" | "no-drop" | "not-allowed" | "grab" | "grabbing";
+type MouseResizeAndScrollCursor = "all-scroll" | "col-resize" | "row-resize" | "n-resize" | "e-resize" | "s-resize" | "w-resize" | "ne-resize" | "nw-resize" | "se-resize" | "sw-resize" | "ew-resize" | "ns-resize" | "nesw-resize" | "nwse-resize";
+type MouseZoomingCursor = "zoom-in" | "zoom-out";
+type MouseCursor = MouseGeneralCursor | MouseLinkAndStatusCursor | MouseSelectionCursor | MouseDragAndDropCursor | MouseResizeAndScrollCursor | MouseZoomingCursor;
+
+type MoveDirection = "up" | "down" | "left" | "right";
+
+/**
+ * @license Apache-2.0
+ *
+ * Copyright (c) 2025 CuteWidgets Team. All Rights Reserved.
+ *
+ * You may not use this file except in compliance with the License
+ * that can be found at http://www.apache.org/licenses/LICENSE-2.0
+ */
+type RelativeSize3 = "middle" | "large" | "small";
+type RelativeSize5 = RelativeSize3 | ("larger" | "smaller");
+type RelativeSize7 = RelativeSize5 | ("largest" | "smallest");
+type RelativeSize = RelativeSize3;
+
+type HorizontalEdge = 'left' | 'right' | 'start' | 'end';
+
+type VerticalEdge = 'top' | 'bottom';
+
+/** Edge of the viewport  */
+type ViewportEdge = VerticalEdge | HorizontalEdge;
+
+/**
+ * @license Apache-2.0
+ *
+ * Copyright (c) 2025 CuteWidgets Team. All Rights Reserved.
+ *
+ * You may not use this file except in compliance with the License
+ * that can be found at http://www.apache.org/licenses/LICENSE-2.0
+ */
+/**
+ * Gets transition duration total value
+ * @param element Source HTML element
+ * @returns Duration with delay time in milliseconds
+ */
+declare function getOverallTransitionDuration(element: HTMLElement): number;
+/**
+ * Gets transition duration value
+ * @param element Source HTML element
+ * @returns Duration time in milliseconds
+ */
+declare function getTransitionDuration(element: HTMLElement): number;
+/**
+ * Gets duration to wait before starting transition
+ * @param element Source HTML element
+ * @returns Delay time in milliseconds
+ */
+declare function getTransitionDelay(element: HTMLElement): number;
+
+/**
+ * @license Apache-2.0
+ *
+ * Copyright (c) 2025 CuteWidgets Team. All Rights Reserved.
+ *
+ * You may not use this file except in compliance with the License
+ * that can be found at http://www.apache.org/licenses/LICENSE-2.0
+ */
+
+declare function createValueToken<T>(value: T): InjectionToken<T>;
+declare function createFactoryToken<T>(factory: () => T): InjectionToken<T>;
+
+/**
+ * @license Apache-2.0
+ *
+ * Copyright (c) 2025 CuteWidgets Team. All Rights Reserved.
+ *
+ * You may not use this file except in compliance with the License
+ * that can be found at http://www.apache.org/licenses/LICENSE-2.0
+ */
+
+type ExportOptions = {
+    filename?: string;
+    delimiter?: string;
+    columns?: string[];
+};
+/**
+ * Forcibly starts the process of downloading and saving the file.
+ * @param blobData Data to save
+ * @param filename File name to save. Default is `download`.
+ */
+declare function saveAs(blobData: Blob, filename?: string): void;
+/**
+ * Exports data from HTML table to MS Excel format text
+ * @param tableIdOrElem HTML table's `id` value or `ElementRef` object
+ * @param options Export options
+ */
+declare function exportToExcel(tableIdOrElem: string | ElementRef, options?: ExportOptions): void;
+/**
+ * Exports data from HTML table to CSV format text
+ * @param tableIdOrElem HTML table's `id` value or `ElementRef` object
+ * @param options Export options
+ */
+declare function exportToCSV(tableIdOrElem: string | ElementRef, options?: ExportOptions): void;
+
+/** Service that generates unique IDs for DOM nodes. */
+declare class IdGenerator {
+    private _appId;
+    /**
+     * Generates a unique ID with a specific prefix.
+     * @param prefix Prefix to add to the ID.
+     */
+    getId(prefix: string): string;
+    /**
+     * Generates UUID (ver.4) string using simple algorithm based on random value only
+     */
+    getUUID(): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<IdGenerator, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<IdGenerator>;
+}
+
+/**
+ * @license Apache-2.0
+ *
+ * Copyright (c) 2025 CuteWidgets Team. All Rights Reserved.
+ *
+ * You may not use this file except in compliance with the License
+ * that can be found at http://www.apache.org/licenses/LICENSE-2.0
+ */
+type TaskPriority = "user-blocking" | "user-visible" | "background";
+/**
+ * A class with static methods specifically designed for scheduling tasks in the browser.
+ */
+declare class Scheduler {
+    /** Yielding to the main thread in the browser. */
+    static yield(): Promise<void>;
+    /**
+     * Resolves a promise after the delay time in milliseconds
+     * @param ms Number of milliseconds to wait
+     *
+     * @see {@link delay}
+     */
+    static wait(ms: number): Promise<void>;
+    /**
+     * Adding a task to be scheduled according to their priority.
+     * @param callback Function to run
+     * @param options Scheduler options
+     *
+     * @see {@link async.post}
+     */
+    static postTask(callback: Function, options?: {
+        priority?: TaskPriority;
+        signal?: any;
+        delay?: number;
+    }): Promise<void>;
+}
+
+/**
+ * @license Apache-2.0
+ *
+ * Copyright (c) 2025 CuteWidgets Team. All Rights Reserved.
+ *
+ * You may not use this file except in compliance with the License
+ * that can be found at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * This code is a modification of the `@angular/material` original
+ * code licensed under MIT-style License (https://angular.dev/license).
+ */
+
+/** InjectionToken for datepicker that can be used to override default locale code. */
+declare const CUTE_DATE_LOCALE: InjectionToken<{}>;
+/**
+ * @docs-private
+ * @deprecated No longer used, will be removed.
+ * @breaking-change 21.0.0
+ */
+declare function CUTE_DATE_LOCALE_FACTORY(): {};
+/** Adapts type `D` to be usable as a date by cdk-based components that work with dates. */
+declare abstract class DateAdapter<D, L = any> {
+    /** The locale to use for all dates. */
+    protected locale: L | undefined;
+    protected readonly _localeChanges: Subject<void>;
+    /** A stream that emits when the locale changes. */
+    readonly localeChanges: Observable<void>;
+    /**
+     * Gets the year component of the given date.
+     * @param date The date to extract the year from.
+     * @returns The year component.
+     */
+    abstract getYear(date: D): number;
+    /**
+     * Gets the month component of the given date.
+     * @param date The date to extract the month from.
+     * @returns The month component (0-indexed, 0 = January).
+     */
+    abstract getMonth(date: D): number;
+    /**
+     * Gets the date of the month component of the given date.
+     * @param date The date to extract the date of the month from.
+     * @returns The month component (1-indexed, 1 = first of month).
+     */
+    abstract getDate(date: D): number;
+    /**
+     * Gets the day of the week component of the given date.
+     * @param date The date to extract the day of the week from.
+     * @returns The month component (0-indexed, 0 = Sunday).
+     */
+    abstract getDayOfWeek(date: D): number;
+    /**
+     * Gets a list of names for the months.
+     * @param style The naming style (e.g. long = 'January', short = 'Jan', narrow = 'J').
+     * @returns An ordered list of all month names, starting with January.
+     */
+    abstract getMonthNames(style: 'long' | 'short' | 'narrow'): string[];
+    /**
+     * Gets a list of names for the dates of the month.
+     * @returns An ordered list of all date of the month names, starting with '1'.
+     */
+    abstract getDateNames(): string[];
+    /**
+     * Gets a list of names for the days of the week.
+     * @param style The naming style (e.g., long = 'Sunday', short = 'Sun', narrow = 'S').
+     * @returns An ordered list of all weekday names, starting with Sunday.
+     */
+    abstract getDayOfWeekNames(style: 'long' | 'short' | 'narrow'): string[];
+    /**
+     * Gets the name for the year of the given date.
+     * @param date The date to get the year name for.
+     * @returns The name of the given year (e.g. '2017').
+     */
+    abstract getYearName(date: D): string;
+    /**
+     * Gets the first day of the week.
+     * @returns The first day of the week (0-indexed, 0 = Sunday).
+     */
+    abstract getFirstDayOfWeek(): number;
+    /**
+     * Gets the number of days in the month of the given date.
+     * @param date The date whose month should be checked.
+     * @returns The number of days in the month of the given date.
+     */
+    abstract getNumDaysInMonth(date: D): number;
+    /**
+     * Clones the given date.
+     * @param date The date to clone
+     * @returns A new date equal to the given date.
+     */
+    abstract clone(date: D): D;
+    /**
+     * Creates a date with the given year, month, and date. Does not allow over/under-flow of the
+     * month and date.
+     * @param year The full year of the date. (e.g. 89 means the year 89, not the year 1989).
+     * @param month The month of the date (0-indexed, 0 = January). Must be an integer 0 - 11.
+     * @param date The date of month of the date. Must be an integer 1 - length of the given month.
+     * @returns The new date, or null if invalid.
+     */
+    abstract createDate(year: number, month: number, date: number): D;
+    /**
+     * Gets today's date.
+     * @returns Today's date.
+     */
+    abstract today(): D;
+    /**
+     * Parses a date from a user-provided value.
+     * @param value The value to parse.
+     * @param parseFormat The expected format of the value being parsed
+     *     (type is implementation-dependent).
+     * @returns The parsed date.
+     */
+    abstract parse(value: any, parseFormat: any): D | null;
+    /**
+     * Formats a date as a string according to the given format.
+     * @param date The value to format.
+     * @param displayFormat The format to use to display the date as a string.
+     * @returns The formatted date string.
+     */
+    abstract format(date: D, displayFormat: any): string;
+    /**
+     * Adds the given number of years to the date. Years are counted as if flipping 12 pages on the
+     * calendar for each year and then finding the closest date in the new month. For example when
+     * adding 1 year to Feb 29, 2016, the resulting date will be Feb 28, 2017.
+     * @param date The date to add years to.
+     * @param years The number of years to add (maybe negative).
+     * @returns A new date equal to the given one with the specified number of years added.
+     */
+    abstract addCalendarYears(date: D, years: number): D;
+    /**
+     * Adds the given number of months to the date. Months are counted as if flipping a page on the
+     * calendar for each month and then finding the closest date in the new month. For example when
+     * adding 1 month to Jan 31, 2017, the resulting date will be Feb 28, 2017.
+     * @param date The date to add months to.
+     * @param months The number of months to add (maybe negative).
+     * @returns A new date equal to the given one with the specified number of months added.
+     */
+    abstract addCalendarMonths(date: D, months: number): D;
+    /**
+     * Adds the given number of days to the date. Days are counted as if moving one cell on the
+     * calendar for each day.
+     * @param date The date to add days to.
+     * @param days The number of days to add (maybe negative).
+     * @returns A new date equal to the given one with the specified number of days added.
+     */
+    abstract addCalendarDays(date: D, days: number): D;
+    /**
+     * Gets the RFC 3339 compatible string (https://tools.ietf.org/html/rfc3339) for the given date.
+     * This method is used to generate date strings that are compatible with native HTML attributes
+     * such as the `min` or `max` attribute of an `<input>`.
+     * @param date The date to get the ISO date string for.
+     * @returns The ISO date string date string.
+     */
+    abstract toIso8601(date: D): string;
+    /**
+     * Checks whether the given object is considered a date instance by this DateAdapter.
+     * @param obj The object to check
+     * @returns Whether the object is a date instance.
+     */
+    abstract isDateInstance(obj: any): boolean;
+    /**
+     * Checks whether the given date is valid.
+     * @param date The date to check.
+     * @returns Whether the date is valid.
+     */
+    abstract isValid(date: D): boolean;
+    /**
+     * Gets date instance that is not valid.
+     * @returns An invalid date.
+     */
+    abstract invalid(): D;
+    /**
+     * Sets the time of one date to the time of another.
+     * @param target Date whose time will be set.
+     * @param hours New hours to set on the date object.
+     * @param minutes New minutes to set on the date object.
+     * @param seconds New seconds to set on the date object.
+     */
+    setTime(target: D, hours: number, minutes: number, seconds: number): D;
+    /**
+     * Gets the hours component of the given date.
+     * @param date The date to extract the hours from.
+     */
+    getHours(date: D): number;
+    /**
+     * Gets the minutes component of the given date.
+     * @param date The date to extract the minutes from.
+     */
+    getMinutes(date: D): number;
+    /**
+     * Gets the seconds component of the given date.
+     * @param date The date to extract the seconds from.
+     */
+    getSeconds(date: D): number;
+    /**
+     * Parses a date with a specific time from a user-provided value.
+     * @param value The value to parse.
+     * @param parseFormat The expected format of the value being parsed
+     *     (type is implementation-dependent).
+     */
+    parseTime(value: any, parseFormat: any): D | null;
+    /**
+     * Adds an amount of seconds to the specified date.
+     * @param date Date to which to add the seconds.
+     * @param amount Amount of seconds to add to the date.
+     */
+    addSeconds(date: D, amount: number): D;
+    /**
+     * Given a potential date object, returns that same date object if it is
+     * a valid date, or `null` if it's not a valid date.
+     * @param obj The object to check.
+     * @returns A date or `null`.
+     */
+    getValidDateOrNull(obj: unknown): D | null;
+    /**
+     * Attempts to deserialize a value to a valid date object. This is different from parsing in that
+     * deserialize should only accept non-ambiguous, locale-independent formats (e.g. a ISO 8601
+     * string). The default implementation does not allow any deserialization, it simply checks that
+     * the given value is already a valid date object or null. The `<mat-datepicker>` will call this
+     * method on all of its `@Input()` properties that accept dates. It is therefore possible to
+     * support passing values from your backend directly to these properties by overriding this method
+     * to also deserialize the format used by your backend.
+     * @param value The value to be deserialized into a date object.
+     * @returns The deserialized date object, either a valid date, null if the value can be
+     *     deserialized into a null date (e.g. the empty string), or an invalid date.
+     */
+    deserialize(value: any): D | null;
+    /**
+     * Sets the locale used for all dates.
+     * @param locale The new locale.
+     */
+    setLocale(locale: L): void;
+    /**
+     * Compares two dates.
+     * @param first The first date to compare.
+     * @param second The second date to compare.
+     * @returns 0 if the dates are equal, a number less than 0 if the first date is earlier,
+     *     a number greater than 0 if the first date is later.
+     */
+    compareDate(first: D, second: D): number;
+    /**
+     * Compares the time values of two dates.
+     * @param first First date to compare.
+     * @param second Second date to compare.
+     * @returns 0 if the times are equal, a number less than 0 if the first time is earlier,
+     *     a number greater than 0 if the first time is later.
+     */
+    compareTime(first: D, second: D): number;
+    /**
+     * Checks if two dates are equal.
+     * @param first The first date to check.
+     * @param second The second date to check.
+     * @returns Whether the two dates are equal.
+     *     Null dates are considered equal to other null dates.
+     */
+    sameDate(first: D | null, second: D | null): boolean;
+    /**
+     * Checks if the times of two dates are equal.
+     * @param first The first date to check.
+     * @param second The second date to check.
+     * @returns Whether the times of the two dates are equal.
+     *     Null dates are considered equal to other null dates.
+     */
+    sameTime(first: D | null, second: D | null): boolean;
+    /**
+     * Clamp the given date between min and max dates.
+     * @param date The date to clamp.
+     * @param min The minimum value to allow. If null or omitted, no min is enforced.
+     * @param max The maximum value to allow. If null or omitted, no max is enforced.
+     * @returns `min` if `date` is less than `min`, `max` if date is greater than `max`,
+     *     otherwise `date`.
+     */
+    clampDate(date: D, min?: D | null, max?: D | null): D;
+}
+
+/**
+ * @license Apache-2.0
+ *
+ * Copyright (c) 2025 CuteWidgets Team. All Rights Reserved.
+ *
+ * You may not use this file except in compliance with the License
+ * that can be found at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * This code is a modification of the `@angular/material` original
+ * code licensed under MIT-style License (https://angular.dev/license).
+ */
+
+type CuteDateFormats = {
+    parse: {
+        dateInput: any;
+        timeInput?: any;
+    };
+    display: {
+        dateInput: any;
+        monthLabel?: any;
+        monthYearLabel: any;
+        dateA11yLabel: any;
+        monthYearA11yLabel: any;
+        timeInput?: any;
+        timeOptionLabel?: any;
+    };
+};
+declare const CUTE_DATE_FORMATS: InjectionToken<CuteDateFormats>;
+
+/** Adapts the native JS Date for use with cdk-based components that work with dates. */
+declare class NativeDateAdapter extends DateAdapter<Date> {
+    /** The injected locale. */
+    private readonly _cuteDateLocale;
+    constructor(...args: unknown[]);
+    getYear(date: Date): number;
+    getMonth(date: Date): number;
+    getDate(date: Date): number;
+    getDayOfWeek(date: Date): number;
+    getMonthNames(style: 'long' | 'short' | 'narrow'): string[];
+    getDateNames(): string[];
+    getDayOfWeekNames(style: 'long' | 'short' | 'narrow'): string[];
+    getYearName(date: Date): string;
+    getFirstDayOfWeek(): number;
+    getNumDaysInMonth(date: Date): number;
+    clone(date: Date): Date;
+    createDate(year: number, month: number, date: number): Date;
+    today(): Date;
+    parse(value: any, parseFormat?: any): Date | null;
+    format(date: Date, displayFormat: Object): string;
+    addCalendarYears(date: Date, years: number): Date;
+    addCalendarMonths(date: Date, months: number): Date;
+    addCalendarDays(date: Date, days: number): Date;
+    toIso8601(date: Date): string;
+    /**
+     * Returns the given value if given a valid Date or null. Deserializes valid ISO 8601 strings
+     * (https://www.ietf.org/rfc/rfc3339.txt) into valid Dates and empty string into null. Returns an
+     * invalid date for all other values.
+     */
+    deserialize(value: any): Date | null;
+    isDateInstance(obj: any): obj is Date;
+    isValid(date: Date): boolean;
+    invalid(): Date;
+    setTime(target: Date, hours: number, minutes: number, seconds: number): Date;
+    getHours(date: Date): number;
+    getMinutes(date: Date): number;
+    getSeconds(date: Date): number;
+    parseTime(userValue: any, parseFormat?: any): Date | null;
+    addSeconds(date: Date, amount: number): Date;
+    /** Creates a date but allows the month and date to overflow. */
+    private _createDateWithOverflow;
+    /**
+     * Pads a number to make it two digits.
+     * @param n The number to pad.
+     * @returns The padded number.
+     */
+    private _2digit;
+    /**
+     * When converting a Date object to string, javascript built-in functions may return wrong
+     * results because it applies its internal DST rules. The DST rules around the world change
+     * very frequently, and the current valid rule is not always valid in previous years though.
+     * We work around this problem building a new Date object which has its internal UTC
+     * representation with the local date and time.
+     * @param dtf Intl.DateTimeFormat object, containing the desired string format. It must have
+     *    timeZone set to 'utc' to work fine.
+     * @param date Date from which we want to get the string representation according to dtf
+     * @returns A Date object with its UTC representation based on the passed in date info
+     */
+    private _format;
+    /**
+     * Attempts to parse a time string into a date object. Returns null if it cannot be parsed.
+     * @param value Time string to parse.
+     */
+    private _parseTimeString;
+    static ɵfac: i0.ɵɵFactoryDeclaration<NativeDateAdapter, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<NativeDateAdapter>;
+}
+
+/**
+ * @license Apache-2.0
+ *
+ * Copyright (c) 2025 CuteWidgets Team. All Rights Reserved.
+ *
+ * You may not use this file except in compliance with the License
+ * that can be found at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * This code is a modification of the `@angular/material` original
+ * code licensed under MIT-style License (https://angular.dev/license).
+ */
+
+declare const CUTE_NATIVE_DATE_FORMATS: CuteDateFormats;
+
+declare class NativeDateModule {
+    static ɵfac: i0.ɵɵFactoryDeclaration<NativeDateModule, never>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<NativeDateModule, never, never, never>;
+    static ɵinj: i0.ɵɵInjectorDeclaration<NativeDateModule>;
+}
+declare class CuteNativeDateModule {
+    static ɵfac: i0.ɵɵFactoryDeclaration<CuteNativeDateModule, never>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<CuteNativeDateModule, never, never, never>;
+    static ɵinj: i0.ɵɵInjectorDeclaration<CuteNativeDateModule>;
+}
+declare function provideNativeDateAdapter(formats?: CuteDateFormats): Provider[];
+
+/**
+ * @license Apache-2.0
+ *
+ * Copyright (c) 2025 CuteWidgets Team. All Rights Reserved.
+ *
+ * You may not use this file except in compliance with the License
+ * that can be found at http://www.apache.org/licenses/LICENSE-2.0
+ */
+
+/**
+ * Bypass security and trust the given value to be a safe resource.
+ * > WARNING: calling this method with untrusted user data exposes your application to XSS security risks!
+ * @example
+ * ```html
+ * <img [src]="item.source | safe:'url'" alt="Item image"/>
+ * ```
+ */
+declare class CuteSafePipe implements PipeTransform {
+    protected sanitizer: DomSanitizer;
+    transform(value: any, type?: 'html' | 'style' | 'script' | 'url' | 'resourceUrl'): SafeValue;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CuteSafePipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<CuteSafePipe, "safe", true>;
+}
+
+/**
+ * @license Apache-2.0
+ *
+ * Copyright (c) 2025 CuteWidgets Team. All Rights Reserved.
+ *
+ * You may not use this file except in compliance with the License
+ * that can be found at http://www.apache.org/licenses/LICENSE-2.0
+ */
+
+/**
+ * Gets a safe value from either a known safe value or a value with unknown safety.
+ *
+ * @example
+ * ```html
+ * <div [innerHTML]="item.htmlContent | sanitize:'html'"></div>
+ * ```
+ */
+declare class CuteSanitizePipe implements PipeTransform {
+    protected sanitizer: DomSanitizer;
+    transform(value: any, context?: 'html' | 'style' | 'script' | 'url' | 'resourceUrl' | 'none'): SafeValue | null;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CuteSanitizePipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<CuteSanitizePipe, "sanitize", true>;
+}
+
+/**
+ * @license Apache-2.0
+ *
+ * Copyright (c) 2025 CuteWidgets Team. All Rights Reserved.
+ *
+ * You may not use this file except in compliance with the License
+ * that can be found at http://www.apache.org/licenses/LICENSE-2.0
+ */
+/**
+ * `CuteWidgets` supports standard Bootstrap 5 theme colors - `ThemeColor` type. But to account
+ * miscellaneous use cases of usage this colors in components CuteWidgets add extended definition of
+ * latter - `RichThemeColor`. Rich color is the standard color name plus "-emphasis" or "-contrast" suffix at the end.
+ * Depending on the context of applying color, the result CSS-class can be `.text-*`, `.text-bg-*` or ended with
+ * `-emphasis` or `-subtle` suffixes.
+ */
+
+/** Bootstrap theme colors */
+declare const Palette: readonly ["primary", "secondary", "success", "danger", "warning", "info", "light", "dark", "link", "tertiary"];
+/** Bootstrap’s base color palette. */
+type ThemeColor = typeof Palette[number];
+/** Rich color palette is based on the standard Bootstrap palette but has additional shades. */
+type RichThemeColor = ThemeColor | `${ThemeColor}-emphasis` | `${ThemeColor}-contrast`;
+/** Alias for `ThemeColor` type. */
+type ThemePalette = ThemeColor;
+/** Alias for `ThemeColor` type. */
+type RichThemePalette = RichThemeColor;
+/**
+ * Whether a string is a valid theme color name
+ * @param str Text case-sensitive value
+ * @returns _true_ if `str` is a valid color name, otherwise _false_
+ */
+declare function isThemeColor(str: string | undefined | null): str is ThemeColor;
+/**
+ * Whether a string is a valid rich or base theme color name.
+ * @param str Case-sensitive text value of the color name.
+ * @returns _true_ if `str` is a valid rich color name, otherwise _false_.
+ */
+declare function isRichThemeColor(str: string | undefined | null): str is RichThemeColor;
+/**
+ * Transforms a string to `ThemeColor` type.
+ * @param color Color value to transform
+ * @returns _ThemeColor_'s value or _undefined_, if the `color` has an invalid value.
+ */
+declare function toThemeColor(color: string | undefined | null): ThemeColor | undefined;
+/**
+ * To `_RichThemeColor_` transformer function.
+ * @param color Color value to transform into rich color type.
+ * @returns _RichThemeColor_ value or _undefined_ if `color` is invalid.
+ */
+declare function toRichThemeColor(color: string | undefined | null): RichThemeColor | undefined;
+/**
+ * Returns a valid Bootstrap's `.text-*` CSS class.
+ * @param color Color palette to transform into CSS-class.
+ */
+declare function toTextCssClass(color: string | undefined | null): string;
+/**
+ * Returns a valid Bootstrap's `.bg-*` or `.text-bg-*` CSS class name.
+ * @param color Value to transform into CSS-class.
+ */
+declare function toBgCssClass(color: string | undefined | null): string;
+/**
+ * Set a background color with contrasting foreground color.
+ * @param color Color palette to transform into CSS-class.
+ * @returns A valid Bootstrap's `.text-bg-*` CSS-class
+ */
+declare function toTextBgCssClass(color: string | undefined | null): string;
+/**
+ * Returns a valid Bootstrap's `.text-*` or `.text-bg-*` CSS class.
+ * @param color Color value to transform into CSS-class.
+ */
+declare function toColorCssClass(color: string | undefined | null): string;
+declare const CUTE_THEME_COLOR: InjectionToken<CuteThemeColor>;
+declare class CuteThemeColor {
+    color: RichThemeColor | undefined;
+    colorClass(): string;
+    bgClass(): string;
+    textBgClass(): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CuteThemeColor, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<CuteThemeColor, "[cuteThemeColor]", ["cuteThemeColor"], { "color": { "alias": "cuteThemeColor"; "required": false; }; }, {}, never, never, true, never>;
+}
+
+type CuteTheme = "light" | "dark" | "auto";
+declare class CuteThemeService implements OnDestroy {
+    private _document;
+    private _mediaQueryList;
+    private _mediaChange;
+    /** Observable that can be used to receive `MediaMatcher`'s _change_ event. */
+    readonly change: rxjs.Observable<MediaQueryListEvent>;
+    constructor();
+    private getStoredTheme;
+    private setStoredTheme;
+    /** Returns the user's preferred color mode. */
+    getPreferredTheme(): CuteTheme;
+    /** Returns the browser's color theme. */
+    getCurrentTheme(): CuteTheme;
+    /** Whether is the dark theme currently selected. */
+    isDarkTheme(): boolean;
+    /** Whether is the light theme currently selected. */
+    isLightTheme(): boolean;
+    /** Returns the Bootstrap's color theme. */
+    getTheme(): Omit<CuteTheme, "auto">;
+    /**
+     * Changes the default color mode (theme) of all pages in the website with the opportunity of auto-detection.
+     * @param theme Desired color theme.
+     * @param emitEvent Emulate event emitting. Default is _true_.
+     */
+    setTheme(theme: CuteTheme, emitEvent?: boolean): void;
+    ngOnDestroy(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CuteThemeService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<CuteThemeService>;
+}
+
+export { AnimationCurves, AnimationDurations, CUTE_DATE_FORMATS, CUTE_DATE_LOCALE, CUTE_DATE_LOCALE_FACTORY, CUTE_NATIVE_DATE_FORMATS, CUTE_THEME_COLOR, CUTE_WIDGETS_ANIMATIONS, CuteLine, CuteLineModule, CuteNativeDateModule, CuteRipple, CuteSafePipe, CuteSanitizePipe, CuteThemeColor, CuteThemeService, DateAdapter, IdGenerator, NativeDateAdapter, NativeDateModule, Ripple, RippleManager, Scheduler, _animationsDisabled, _getAnimationsState, bsBreakpoints, createFactoryToken, createValueToken, exportToCSV, exportToExcel, getOverallTransitionDuration, getTransitionDelay, getTransitionDuration, isRichThemeColor, isThemeColor, provideNativeDateAdapter, saveAs, setLines, toBgCssClass, toColorCssClass, toRichThemeColor, toTextBgCssClass, toTextCssClass, toThemeColor };
+export type { AbstractConstructor, AnimationsConfig, Constructor, ContentAlignment, CuteDateFormats, CuteTheme, ExportOptions, Focusable, HorizontalEdge, LayoutBreakpoint, LayoutDirection, LayoutOrientation, MenuAction, MenuItem, MenuOwner, MouseCursor, MouseDragAndDropCursor, MouseGeneralCursor, MouseLinkAndStatusCursor, MouseResizeAndScrollCursor, MouseSelectionCursor, MouseZoomingCursor, MoveDirection, RelativeSize, RelativeSize3, RelativeSize5, RelativeSize7, RichThemeColor, RichThemePalette, RippleOptions, TaskPriority, ThemeColor, ThemePalette, ToolbarItem, TreeNode, VerticalEdge, ViewportEdge };