@cute-widgets/base 20.0.1

package/datepicker/index.d.ts

@@ -0,0 +1,1817 @@
+import * as i0 from '@angular/core';
+import { OnChanges, OnDestroy, AfterViewChecked, EventEmitter, SimpleChanges, FactoryProvider, AfterContentInit, ChangeDetectorRef, AfterViewInit, ElementRef, InjectionToken, OnInit, DoCheck, TemplateRef } from '@angular/core';
+import * as i1 from '@angular/common';
+import * as i2 from '@cute-widgets/base/button';
+import { CuteButton } from '@cute-widgets/base/button';
+import * as i3 from '@angular/cdk/overlay';
+import { ScrollStrategy } from '@angular/cdk/overlay';
+import * as i4 from '@angular/cdk/a11y';
+import { FocusOrigin } from '@angular/cdk/a11y';
+import * as i5 from '@angular/cdk/portal';
+import { ComponentType, Portal, TemplatePortal } from '@angular/cdk/portal';
+import { Observable, Subject } from 'rxjs';
+import { DateAdapter, ThemeColor } from '@cute-widgets/base/core';
+import { ControlValueAccessor, Validator, ValidatorFn, AbstractControl, ValidationErrors, NgForm, FormGroupDirective, NgControl } from '@angular/forms';
+import { Expandable } from '@cute-widgets/base/abstract';
+import { CuteFormFieldControl } from '@cute-widgets/base/form-field';
+import { ErrorStateMatcher } from '@cute-widgets/base/core/error';
+import { Directionality } from '@angular/cdk/bidi';
+import * as i19 from '@angular/cdk/scrolling';
+
+/** Extra CSS classes that can be associated with a calendar cell. */
+type CuteCalendarCellCssClasses = string | string[] | Set<string> | {
+    [key: string]: any;
+};
+/** Function that can generate the extra classes that should be added to a calendar cell. */
+type CuteCalendarCellClassFunction<D> = (date: D, view: 'month' | 'year' | 'multi-year') => CuteCalendarCellCssClasses;
+/**
+ * An internal class that represents the data corresponding to a single calendar cell.
+ * @docs-private
+ */
+declare class CuteCalendarCell<D = any> {
+    value: number;
+    displayValue: string;
+    ariaLabel: string;
+    enabled: boolean;
+    cssClasses: CuteCalendarCellCssClasses;
+    compareValue: number;
+    rawValue?: D | undefined;
+    readonly id: number;
+    constructor(value: number, displayValue: string, ariaLabel: string, enabled: boolean, cssClasses?: CuteCalendarCellCssClasses, compareValue?: number, rawValue?: D | undefined);
+}
+/** Event emitted when a date inside the calendar is triggered as a result of a user action. */
+interface CuteCalendarUserEvent<D> {
+    value: D;
+    event: Event;
+}
+/**
+ * An internal component used to display calendar data in a table.
+ */
+declare class CuteCalendarBody<D = any> implements OnChanges, OnDestroy, AfterViewChecked {
+    private _elementRef;
+    private _ngZone;
+    private _platform;
+    private _intl;
+    /**
+     * Used to skip the next focus event when rendering the preview range.
+     * We need a flag like this, because some browsers fire focus events asynchronously.
+     */
+    private _skipNextFocus;
+    /**
+     * Used to focus the active cell after change detection has run.
+     */
+    private _focusActiveCellAfterViewChecked;
+    /** The label for the table. (e.g. "Jan 2017"). */
+    label: string | undefined;
+    /** The cells to display in the table. */
+    rows: CuteCalendarCell[][];
+    /** The value in the table that corresponds to today. */
+    todayValue: number | undefined;
+    /** Start value of the selected date range. */
+    startValue: number;
+    /** End value of the selected date range. */
+    endValue: number;
+    /** The minimum number of free cells needed to fit the label in the first row. */
+    labelMinRequiredCells: number;
+    /** The number of columns in the table. */
+    numCols: number;
+    /** The cell number of the active cell in the table. */
+    activeCell: number;
+    ngAfterViewChecked(): void;
+    /** Whether a range is being selected. */
+    isRange: boolean;
+    /**
+     * The aspect ratio (width / height) to use for the cells in the table. This aspect ratio will be
+     * maintained even as the table resizes.
+     */
+    cellAspectRatio: number;
+    /** Start of the comparison range. */
+    comparisonStart: number | null;
+    /** End of the comparison range. */
+    comparisonEnd: number | null;
+    /** Start of the preview range. */
+    previewStart: number | null;
+    /** End of the preview range. */
+    previewEnd: number | null;
+    /** ARIA-Accessible name of the `<input matStartDate/>` */
+    startDateAccessibleName: string | null;
+    /** ARIA Accessible name of the `<input matEndDate/>` */
+    endDateAccessibleName: string | null;
+    /** Emits when a new value is selected. */
+    readonly selectedValueChange: EventEmitter<CuteCalendarUserEvent<number>>;
+    /** Emits when the preview has changed as a result of a user action. */
+    readonly previewChange: EventEmitter<CuteCalendarUserEvent<CuteCalendarCell<any> | null>>;
+    readonly activeDateChange: EventEmitter<CuteCalendarUserEvent<number>>;
+    /** Emits the date at the possible start of a drag event. */
+    readonly dragStarted: EventEmitter<CuteCalendarUserEvent<D>>;
+    /** Emits the date at the conclusion of a drag, or null if mouse was not released on a date. */
+    readonly dragEnded: EventEmitter<CuteCalendarUserEvent<D | null>>;
+    /** The number of blank cells to put at the beginning for the first row. */
+    protected _firstRowOffset: number;
+    /** Padding for the individual date cells. */
+    protected _cellPadding: string | undefined;
+    /** Width of an individual cell. */
+    protected _cellWidth: string | undefined;
+    /** ID for the start date label. */
+    protected _startDateLabelId: string | null;
+    /** ID for the end date label. */
+    protected _endDateLabelId: string | null;
+    /** ID for the comparison start date label. */
+    protected _comparisonStartDateLabelId: string | null;
+    /** ID for the comparison end date label. */
+    protected _comparisonEndDateLabelId: string | null;
+    private _didDragSinceMouseDown;
+    private _injector;
+    comparisonDateAccessibleName: string;
+    /**
+     * Tracking function for rows based on their identity. Ideally we would use some sort of
+     * key on the row, but that would require a breaking change for the `rows` input. We don't
+     * use the built-in identity tracking, because it logs warnings.
+     */
+    protected _trackRow: (row: CuteCalendarCell[]) => CuteCalendarCell<any>[];
+    constructor(...args: unknown[]);
+    /** Called when a cell is clicked. */
+    _cellClicked(cell: CuteCalendarCell, event: MouseEvent): void;
+    _emitActiveDateChange(cell: CuteCalendarCell, event: FocusEvent): void;
+    /** Returns whether a cell should be marked as selected. */
+    protected _isSelected(value: number): boolean;
+    ngOnChanges(changes: SimpleChanges): void;
+    ngOnDestroy(): void;
+    /** Returns whether a cell is active. */
+    protected _isActiveCell(rowIndex: number, colIndex: number): boolean;
+    /**
+     * Focuses the active cell after the microtask queue is empty.
+     *
+     * Adding a 0ms setTimeout seems to fix Voiceover losing focus when pressing PageUp/PageDown
+     * (issue #24330).
+     *
+     * Determined a 0ms by gradually increasing duration from 0 and testing two use cases with screen
+     * reader enabled:
+     *
+     * 1. Pressing PageUp/PageDown repeatedly with pausing between each key press.
+     * 2. Pressing and holding the PageDown key with repeated keys enabled.
+     *
+     * Test 1 worked roughly 95-99% of the time with 0ms and got a little bit better as the duration
+     * increased. Test 2 got slightly better until the duration was long enough to interfere with
+     * repeated keys. If the repeated key speed was faster than the timeout duration, then pressing
+     * and holding pagedown caused the entire page to scroll.
+     *
+     * Since repeated key speed can verify across machines, determined that any duration could
+     * potentially interfere with repeated keys. 0ms would be best because it almost entirely
+     * eliminates the focus being lost in Voiceover (#24330) without causing unintended side effects.
+     * Adding delay also complicates writing tests.
+     */
+    _focusActiveCell(movePreview?: boolean): void;
+    /** Focuses the active cell after change detection has run and the microtask queue is empty. */
+    _scheduleFocusActiveCellAfterViewChecked(): void;
+    /** Gets whether a value is the start of the main range. */
+    protected _isRangeStart(value: number): boolean;
+    /** Gets whether a value is the end of the main range. */
+    protected _isRangeEnd(value: number): boolean;
+    /** Gets whether a value is within the currently selected range. */
+    protected _isInRange(value: number): boolean;
+    /** Gets whether a value is the start of the comparison range. */
+    protected _isComparisonStart(value: number): boolean;
+    /** Whether the cell is a start bridge cell between the main and comparison ranges. */
+    protected _isComparisonBridgeStart(value: number, rowIndex: number, colIndex: number): boolean;
+    /** Whether the cell is an end bridge cell between the main and comparison ranges. */
+    protected _isComparisonBridgeEnd(value: number, rowIndex: number, colIndex: number): boolean;
+    /** Gets whether a value is the end of the comparison range. */
+    protected _isComparisonEnd(value: number): boolean;
+    /** Gets whether a value is within the current comparison range. */
+    protected _isInComparisonRange(value: number): boolean;
+    /**
+     * Gets whether a value is the same as the start and end of the comparison range.
+     * For context, the functions that we use to determine whether something is the start/end of
+     * a range don't allow for the start and end to be on the same day, because we'd have to use
+     * much more specific CSS selectors to style them correctly in all scenarios. This is fine for
+     * the regular range, because when it happens, the selected styles take over and still show where
+     * the range would've been, however, we don't have these selected styles for a comparison range.
+     * This function is used to apply a class that serves the same purpose as the one for selected
+     * dates, but it only applies in the context of a comparison range.
+     */
+    protected _isComparisonIdentical(value: number): boolean;
+    /** Gets whether a value is the start of the preview range. */
+    protected _isPreviewStart(value: number): boolean;
+    /** Gets whether a value is the end of the preview range. */
+    protected _isPreviewEnd(value: number): boolean;
+    /** Gets whether a value is inside the preview range. */
+    protected _isInPreview(value: number): boolean;
+    /** Gets ids of aria descriptions for the start and end of a date range. */
+    protected _getDescribedby(value: number): string | null;
+    /**
+     * Event handler for when the user enters an element
+     * inside the calendar body (e.g., by hovering in or focus).
+     */
+    private _enterHandler;
+    private _touchmoveHandler;
+    /**
+     * Event handler for when the user's pointer leaves an element
+     * inside the calendar body (e.g., by hovering out or blurring).
+     */
+    private _leaveHandler;
+    /**
+     * Triggered on mousedown or touchstart on a date cell.
+     * Responsible for starting a drag sequence.
+     */
+    private _mousedownHandler;
+    /** Triggered on mouseup anywhere. Responsible for ending a drag sequence. */
+    private _mouseupHandler;
+    /** Triggered on touchend anywhere. Responsible for ending a drag sequence. */
+    private _touchendHandler;
+    /** Finds the CuteCalendarCell that corresponds to a DOM node. */
+    private _getCellFromElement;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CuteCalendarBody<any>, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<CuteCalendarBody<any>, "[cute-calendar-body]", ["cuteCalendarBody"], { "label": { "alias": "label"; "required": false; }; "rows": { "alias": "rows"; "required": false; }; "todayValue": { "alias": "todayValue"; "required": false; }; "startValue": { "alias": "startValue"; "required": false; }; "endValue": { "alias": "endValue"; "required": false; }; "labelMinRequiredCells": { "alias": "labelMinRequiredCells"; "required": false; }; "numCols": { "alias": "numCols"; "required": false; }; "activeCell": { "alias": "activeCell"; "required": false; }; "isRange": { "alias": "isRange"; "required": false; }; "cellAspectRatio": { "alias": "cellAspectRatio"; "required": false; }; "comparisonStart": { "alias": "comparisonStart"; "required": false; }; "comparisonEnd": { "alias": "comparisonEnd"; "required": false; }; "previewStart": { "alias": "previewStart"; "required": false; }; "previewEnd": { "alias": "previewEnd"; "required": false; }; "startDateAccessibleName": { "alias": "startDateAccessibleName"; "required": false; }; "endDateAccessibleName": { "alias": "endDateAccessibleName"; "required": false; }; }, { "selectedValueChange": "selectedValueChange"; "previewChange": "previewChange"; "activeDateChange": "activeDateChange"; "dragStarted": "dragStarted"; "dragEnded": "dragEnded"; }, never, never, true, never>;
+}
+
+/**
+ * @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).
+ */
+
+/** A class representing a range of dates. */
+declare class DateRange<D> {
+    /** The start date of the range. */
+    readonly start: D | null;
+    /** The end date of the range. */
+    readonly end: D | null;
+    /**
+     * Ensures that objects with a `start` and `end` property can't be assigned to a variable that
+     * expects a `DateRange`
+     */
+    private _disableStructuralEquivalency;
+    constructor(
+    /** The start date of the range. */
+    start: D | null, 
+    /** The end date of the range. */
+    end: D | null);
+}
+/**
+ * Conditionally picks the date type if a DateRange is passed in.
+ * @docs-private
+ */
+type ExtractDateTypeFromSelection<T> = T extends DateRange<infer D> ? D : NonNullable<T>;
+/**
+ * Event emitted by the date selection model when its selection changes.
+ * @docs-private
+ */
+interface DateSelectionModelChange<S> {
+    /** New value for the selection. */
+    selection: S;
+    /** Object that triggered the change. */
+    source: unknown;
+    /** Previous value */
+    oldValue?: S;
+}
+/**
+ * A selection model containing a date selection.
+ * @docs-private
+ */
+declare abstract class CuteDateSelectionModel<S, D = ExtractDateTypeFromSelection<S>> implements OnDestroy {
+    /** The current selection. */
+    readonly selection: S;
+    protected _adapter: DateAdapter<D>;
+    private readonly _selectionChanged;
+    /** Emits when the selection has changed. */
+    selectionChanged: Observable<DateSelectionModelChange<S>>;
+    protected constructor(
+    /** The current selection. */
+    selection: S, _adapter: DateAdapter<D>);
+    /**
+     * Updates the current selection in the model.
+     * @param value New selection that should be assigned.
+     * @param source Object that triggered the selection change.
+     */
+    updateSelection(value: S, source: unknown): void;
+    ngOnDestroy(): void;
+    protected _isValidDateInstance(date: D): boolean;
+    /** Adds a date to the current selection. */
+    abstract add(date: D | null): void;
+    /** Checks whether the current selection is valid. */
+    abstract isValid(): boolean;
+    /** Checks whether the current selection is complete. */
+    abstract isComplete(): boolean;
+    /** Clones the selection model. */
+    abstract clone(): CuteDateSelectionModel<S, D>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CuteDateSelectionModel<any, any>, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<CuteDateSelectionModel<any, any>>;
+}
+/**
+ * A selection model that contains a single date.
+ * @docs-private
+ */
+declare class CuteSingleDateSelectionModel<D> extends CuteDateSelectionModel<D | null, D> {
+    constructor(adapter: DateAdapter<D>);
+    /**
+     * Adds a date to the current selection. In the case of a single date selection, the added date
+     * simply overwrites the previous selection
+     */
+    add(date: D | null): void;
+    /** Checks whether the current selection is valid. */
+    isValid(): boolean;
+    /**
+     * Checks whether the current selection is complete. In the case of a single date selection, this
+     * is true if the current selection is not null.
+     */
+    isComplete(): boolean;
+    /** Clones the selection model. */
+    clone(): CuteSingleDateSelectionModel<D>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CuteSingleDateSelectionModel<any>, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<CuteSingleDateSelectionModel<any>>;
+}
+/**
+ * A selection model that contains a date range.
+ * @docs-private
+ */
+declare class CuteRangeDateSelectionModel<D> extends CuteDateSelectionModel<DateRange<D>, D> {
+    constructor(adapter: DateAdapter<D>);
+    /**
+     * Adds a date to the current selection. In the case of a date range selection, the added date
+     * fills in the next `null` value in the range. If both the start and the end already have a date,
+     * the selection is reset so that the given date is the new `start` and the `end` is null.
+     */
+    add(date: D | null): void;
+    /** Checks whether the current selection is valid. */
+    isValid(): boolean;
+    /**
+     * Checks whether the current selection is complete. In the case of a date range selection, this
+     * is true if the current selection has a non-null `start` and `end`.
+     */
+    isComplete(): boolean;
+    /** Clones the selection model. */
+    clone(): CuteRangeDateSelectionModel<D>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CuteRangeDateSelectionModel<any>, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<CuteRangeDateSelectionModel<any>>;
+}
+/**
+ * Used to provide a single selection model to a component.
+ * @docs-private
+ */
+declare const CUTE_SINGLE_DATE_SELECTION_MODEL_PROVIDER: FactoryProvider;
+/**
+ * Used to provide a range selection model to a component.
+ * @docs-private
+ */
+declare const CUTE_RANGE_DATE_SELECTION_MODEL_PROVIDER: FactoryProvider;
+
+/**
+ * An internal component used to display a single month in the datepicker.
+ * @docs-private
+ */
+declare class CuteMonthView<D> implements AfterContentInit, OnChanges, OnDestroy {
+    readonly _changeDetectorRef: ChangeDetectorRef;
+    private _dateFormats;
+    _dateAdapter: DateAdapter<D, any>;
+    private _dir;
+    private _rangeStrategy;
+    private _rerenderSubscription;
+    /** Flag used to filter out space/enter keyup events that originated outside the view. */
+    private _selectionKeyPressed;
+    /**
+     * The date to display in this month view (everything other than the month and year is ignored).
+     */
+    get activeDate(): D;
+    set activeDate(value: D);
+    private _activeDate;
+    /** The currently selected date. */
+    get selected(): DateRange<D> | D | null;
+    set selected(value: DateRange<D> | D | null);
+    private _selected;
+    /** The minimum selectable date. */
+    get minDate(): D | null;
+    set minDate(value: D | null);
+    private _minDate;
+    /** The maximum selectable date. */
+    get maxDate(): D | null;
+    set maxDate(value: D | null);
+    private _maxDate;
+    /** Function used to filter which dates are selectable. */
+    dateFilter: ((date: D) => boolean) | null | undefined;
+    /** Function that can be used to add custom CSS classes to dates. */
+    dateClass: CuteCalendarCellClassFunction<D> | undefined;
+    /** Start of the comparison range. */
+    comparisonStart: D | null;
+    /** End of the comparison range. */
+    comparisonEnd: D | null;
+    /** ARIA-Accessible name of the `<input cuteStartDate/>` */
+    startDateAccessibleName: string | null;
+    /** ARIA-Accessible name of the `<input cuteEndDate/>` */
+    endDateAccessibleName: string | null;
+    /** Origin of active drag, or null when dragging is not active. */
+    activeDrag: CuteCalendarUserEvent<D> | null;
+    /** Emits when a new date is selected. */
+    readonly selectedChange: EventEmitter<D | null>;
+    /** Emits when any date is selected. */
+    readonly _userSelection: EventEmitter<CuteCalendarUserEvent<D | null>>;
+    /** Emits when the user initiates a date range drag via mouse or touch. */
+    readonly dragStarted: EventEmitter<CuteCalendarUserEvent<D>>;
+    /**
+     * Emits when the user completes or cancels a date range drag.
+     * Emits null when the drag was canceled or the newly selected date range if completed.
+     */
+    readonly dragEnded: EventEmitter<CuteCalendarUserEvent<DateRange<D> | null>>;
+    /** Emits when any date is activated. */
+    readonly activeDateChange: EventEmitter<D>;
+    /** The body of calendar table */
+    _cuteCalendarBody: CuteCalendarBody | undefined;
+    /** The label for this month (e.g. "January 2017"). */
+    _monthLabel: string | undefined;
+    /** Grid of calendar cells representing the dates of the month. */
+    _weeks: CuteCalendarCell[][];
+    /** The number of blank cells in the first row before the 1st of the month. */
+    _firstWeekOffset: number | null;
+    /** Start value of the currently shown date range. */
+    _rangeStart: number | null;
+    /** End value of the currently shown date range. */
+    _rangeEnd: number | null;
+    /** Start value of the currently shown comparison date range. */
+    _comparisonRangeStart: number | null;
+    /** End value of the currently shown comparison date range. */
+    _comparisonRangeEnd: number | null;
+    /** Start of the preview range. */
+    _previewStart: number | null;
+    /** End of the preview range. */
+    _previewEnd: number | null;
+    /** Whether the user is currently selecting a range of dates. */
+    _isRange: boolean;
+    /** The date of the month that today falls on. Null if today is in another month. */
+    _todayDate: number | null;
+    /** The names of the weekdays. */
+    _weekdays: {
+        long: string;
+        narrow: string;
+        id: number;
+    }[];
+    constructor(...args: unknown[]);
+    ngAfterContentInit(): void;
+    ngOnChanges(changes: SimpleChanges): void;
+    ngOnDestroy(): void;
+    /** Handles when a new date is selected. */
+    _dateSelected(event: CuteCalendarUserEvent<number>): void;
+    /**
+     * Takes the index of a calendar body cell wrapped in an event as argument. For the date that
+     * corresponds to the given cell, set `activeDate` to that date and fire `activeDateChange` with
+     * that date.
+     *
+     * This function is used to match each component's model of the active date with the calendar
+     * body cell that was focused. It updates its value of `activeDate` synchronously and updates the
+     * parent's value asynchronously via the `activeDateChange` event. The child component receives an
+     * updated value asynchronously via the `activeCell` Input.
+     */
+    _updateActiveDate(event: CuteCalendarUserEvent<number>): void;
+    /** Handles keydown events on the calendar body when calendar is in month view. */
+    _handleCalendarBodyKeydown(event: KeyboardEvent): void;
+    /** Handles keyup events on the calendar body when calendar is in month view. */
+    _handleCalendarBodyKeyup(event: KeyboardEvent): void;
+    /** Initializes this month view. */
+    _init(): void;
+    /** Focuses the active cell after the microtask queue is empty. */
+    _focusActiveCell(movePreview?: boolean): void;
+    /** Focuses the active cell after change detection has run and the microtask queue is empty. */
+    _focusActiveCellAfterViewChecked(): void;
+    /** Called when the user has activated a new cell and the preview needs to be updated. */
+    _previewChanged({ event, value: cell }: CuteCalendarUserEvent<CuteCalendarCell<D> | null>): void;
+    /**
+     * Called when the user has ended a drag. If the drag/drop was successful,
+     * computes and emits the new range selection.
+     */
+    protected _dragEnded(event: CuteCalendarUserEvent<D | null>): void;
+    /**
+     * Takes a day of the month and returns a new date in the same month and year as the currently
+     *  active date. The returned date will have the same day of the month as the argument date.
+     */
+    private _getDateFromDayOfMonth;
+    /** Initializes the weekdays. */
+    private _initWeekdays;
+    /** Creates MatCalendarCells for the dates in this month. */
+    private _createWeekCells;
+    /** Date filter for the month */
+    private _shouldEnableDate;
+    /**
+     * Gets the date in this month that the given Date falls on.
+     * Returns null if the given Date is in another month.
+     */
+    private _getDateInCurrentMonth;
+    /** Checks whether the 2 dates are non-null and fall within the same month of the same year. */
+    private _hasSameMonthAndYear;
+    /** Gets the value that will be used to one cell to another. */
+    private _getCellCompareValue;
+    /** Determines whether the user has the RTL layout direction. */
+    private _isRtl;
+    /** Sets the current range based on a model value. */
+    private _setRanges;
+    /** Gets whether a date can be selected in the month view. */
+    private _canSelect;
+    /** Clears out preview state. */
+    private _clearPreview;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CuteMonthView<any>, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<CuteMonthView<any>, "cute-month-view", ["cuteMonthView"], { "activeDate": { "alias": "activeDate"; "required": false; }; "selected": { "alias": "selected"; "required": false; }; "minDate": { "alias": "minDate"; "required": false; }; "maxDate": { "alias": "maxDate"; "required": false; }; "dateFilter": { "alias": "dateFilter"; "required": false; }; "dateClass": { "alias": "dateClass"; "required": false; }; "comparisonStart": { "alias": "comparisonStart"; "required": false; }; "comparisonEnd": { "alias": "comparisonEnd"; "required": false; }; "startDateAccessibleName": { "alias": "startDateAccessibleName"; "required": false; }; "endDateAccessibleName": { "alias": "endDateAccessibleName"; "required": false; }; "activeDrag": { "alias": "activeDrag"; "required": false; }; }, { "selectedChange": "selectedChange"; "_userSelection": "_userSelection"; "dragStarted": "dragStarted"; "dragEnded": "dragEnded"; "activeDateChange": "activeDateChange"; }, never, never, true, never>;
+}
+
+declare const yearsPerPage = 24;
+declare const yearsPerRow = 4;
+/**
+ * An internal component used to display a year selector in the datepicker.
+ * @docs-private
+ */
+declare class CuteMultiYearView<D> implements AfterContentInit, OnDestroy {
+    private _changeDetectorRef;
+    _dateAdapter: DateAdapter<D, any>;
+    private _dir;
+    private _rerenderSubscription;
+    /** Flag used to filter out space/enter keyup events that originated outside of the view. */
+    private _selectionKeyPressed;
+    /** The date to display in this multi-year view (everything other than the year is ignored). */
+    get activeDate(): D;
+    set activeDate(value: D);
+    private _activeDate;
+    /** The currently selected date. */
+    get selected(): DateRange<D> | D | null;
+    set selected(value: DateRange<D> | D | null);
+    private _selected;
+    /** The minimum selectable date. */
+    get minDate(): D | null;
+    set minDate(value: D | null);
+    private _minDate;
+    /** The maximum selectable date. */
+    get maxDate(): D | null;
+    set maxDate(value: D | null);
+    private _maxDate;
+    /** A function used to filter which dates are selectable. */
+    dateFilter: ((date: D) => boolean) | null | undefined;
+    /** Function that can be used to add custom CSS classes to date cells. */
+    dateClass: CuteCalendarCellClassFunction<D> | undefined;
+    /** Emits when a new year is selected. */
+    readonly selectedChange: EventEmitter<D>;
+    /** Emits the selected year. This doesn't imply a change on the selected date */
+    readonly yearSelected: EventEmitter<D>;
+    /** Emits when any date is activated. */
+    readonly activeDateChange: EventEmitter<D>;
+    /** The body of calendar table */
+    _cuteCalendarBody: CuteCalendarBody | undefined;
+    /** Grid of calendar cells representing the currently displayed years. */
+    _years: CuteCalendarCell[][];
+    /** The year that today falls on. */
+    _todayYear: number;
+    /** The year of the selected date. Null if the selected date is null. */
+    _selectedYear: number | null;
+    constructor(...args: unknown[]);
+    ngAfterContentInit(): void;
+    ngOnDestroy(): void;
+    /** Initializes this multi-year view. */
+    _init(): void;
+    /** Handles when a new year is selected. */
+    _yearSelected(event: CuteCalendarUserEvent<number>): void;
+    /**
+     * Takes the index of a calendar body cell wrapped in an event as argument. For the date that
+     * corresponds to the given cell, set `activeDate` to that date and fire `activeDateChange` with
+     * that date.
+     *
+     * This function is used to match each component's model of the active date with the calendar
+     * body cell that was focused. It updates its value of `activeDate` synchronously and updates the
+     * parent's value asynchronously via the `activeDateChange` event. The child component receives an
+     * updated value asynchronously via the `activeCell` Input.
+     */
+    _updateActiveDate(event: CuteCalendarUserEvent<number>): void;
+    /** Handles keydown events on the calendar body when calendar is in multi-year view. */
+    _handleCalendarBodyKeydown(event: KeyboardEvent): void;
+    /** Handles keyup events on the calendar body when calendar is in multi-year view. */
+    _handleCalendarBodyKeyup(event: KeyboardEvent): void;
+    _getActiveCell(): number;
+    /** Focuses the active cell after the microtask queue is empty. */
+    _focusActiveCell(): void;
+    /** Focuses the active cell after change detection has run and the microtask queue is empty. */
+    _focusActiveCellAfterViewChecked(): void;
+    /**
+     * Takes a year and returns a new date on the same day and month as the currently active date
+     *  The returned date will have the same year as the argument date.
+     */
+    private _getDateFromYear;
+    /** Creates a CuteCalendarCell for the given year. */
+    private _createCellForYear;
+    /** Whether the given year is enabled. */
+    private _shouldEnableYear;
+    /** Determines whether the user has the RTL layout direction. */
+    private _isRtl;
+    /** Sets the currently highlighted year based on a model value. */
+    private _setSelectedYear;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CuteMultiYearView<any>, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<CuteMultiYearView<any>, "cute-multi-year-view", ["cuteMultiYearView"], { "activeDate": { "alias": "activeDate"; "required": false; }; "selected": { "alias": "selected"; "required": false; }; "minDate": { "alias": "minDate"; "required": false; }; "maxDate": { "alias": "maxDate"; "required": false; }; "dateFilter": { "alias": "dateFilter"; "required": false; }; "dateClass": { "alias": "dateClass"; "required": false; }; }, { "selectedChange": "selectedChange"; "yearSelected": "yearSelected"; "activeDateChange": "activeDateChange"; }, never, never, true, never>;
+}
+
+/**
+ * An internal component used to display a single year in the datepicker.
+ * @docs-private
+ */
+declare class CuteYearView<D> implements AfterContentInit, OnDestroy {
+    readonly _changeDetectorRef: ChangeDetectorRef;
+    private _dateFormats;
+    _dateAdapter: DateAdapter<D, any>;
+    private _dir;
+    private _rerenderSubscription;
+    /** Flag used to filter out space/enter keyup events that originated outside of the view. */
+    private _selectionKeyPressed;
+    /** The date to display in this year view (everything other than the year is ignored). */
+    get activeDate(): D;
+    set activeDate(value: D);
+    private _activeDate;
+    /** The currently selected date. */
+    get selected(): DateRange<D> | D | null;
+    set selected(value: DateRange<D> | D | null);
+    private _selected;
+    /** The minimum selectable date. */
+    get minDate(): D | null;
+    set minDate(value: D | null);
+    private _minDate;
+    /** The maximum selectable date. */
+    get maxDate(): D | null;
+    set maxDate(value: D | null);
+    private _maxDate;
+    /** A function used to filter which dates are selectable. */
+    dateFilter: ((date: D) => boolean) | null | undefined;
+    /** Function that can be used to add custom CSS classes to date cells. */
+    dateClass: CuteCalendarCellClassFunction<D> | undefined;
+    /** Emits when a new month is selected. */
+    readonly selectedChange: EventEmitter<D>;
+    /** Emits the selected month. This doesn't imply a change on the selected date */
+    readonly monthSelected: EventEmitter<D>;
+    /** Emits when any date is activated. */
+    readonly activeDateChange: EventEmitter<D>;
+    /** The body of calendar table */
+    _cuteCalendarBody: CuteCalendarBody | undefined;
+    /** Grid of calendar cells representing the months of the year. */
+    _months: CuteCalendarCell[][];
+    /** The label for this year (e.g. "2017"). */
+    _yearLabel: string | undefined;
+    /** The month in this year that today falls on. Null if today is in a different year. */
+    _todayMonth: number | null;
+    /**
+     * The month in this year that the selected Date falls on.
+     * Null if the selected Date is in a different year.
+     */
+    _selectedMonth: number | null;
+    constructor(...args: unknown[]);
+    ngAfterContentInit(): void;
+    ngOnDestroy(): void;
+    /** Handles when a new month is selected. */
+    _monthSelected(event: CuteCalendarUserEvent<number>): void;
+    /**
+     * Takes the index of a calendar body cell wrapped in an event as argument. For the date that
+     * corresponds to the given cell, set `activeDate` to that date and fire `activeDateChange` with
+     * that date.
+     *
+     * This function is used to match each component's model of the active date with the calendar
+     * body cell that was focused. It updates its value of `activeDate` synchronously and updates the
+     * parent's value asynchronously via the `activeDateChange` event. The child component receives an
+     * updated value asynchronously via the `activeCell` Input.
+     */
+    _updateActiveDate(event: CuteCalendarUserEvent<number>): void;
+    /** Handles keydown events on the calendar body when calendar is in year view. */
+    _handleCalendarBodyKeydown(event: KeyboardEvent): void;
+    /** Handles keyup events on the calendar body when calendar is in year view. */
+    _handleCalendarBodyKeyup(event: KeyboardEvent): void;
+    /** Initializes this year view. */
+    _init(): void;
+    /** Focuses the active cell after the microtask queue is empty. */
+    _focusActiveCell(): void;
+    /** Schedules the matCalendarBody to focus the active cell after change detection has run */
+    _focusActiveCellAfterViewChecked(): void;
+    /**
+     * Gets the month in this year that the given Date falls on.
+     * Returns null if the given Date is in another year.
+     */
+    private _getMonthInCurrentYear;
+    /**
+     * Takes a month and returns a new date in the same day and year as the currently active date.
+     *  The returned date will have the same month as the argument date.
+     */
+    private _getDateFromMonth;
+    /** Creates a CuteCalendarCell for the given month. */
+    private _createCellForMonth;
+    /** Whether the given month is enabled. */
+    private _shouldEnableMonth;
+    /**
+     * Tests whether the combination month/year is after this.maxDate, considering
+     * just the month and year of this.maxDate
+     */
+    private _isYearAndMonthAfterMaxDate;
+    /**
+     * Tests whether the combination month/year is before this.minDate, considering
+     * just the month and year of this.minDate
+     */
+    private _isYearAndMonthBeforeMinDate;
+    /** Determines whether the user has the RTL layout direction. */
+    private _isRtl;
+    /** Sets the currently selected month based on a model value. */
+    private _setSelectedMonth;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CuteYearView<any>, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<CuteYearView<any>, "cute-year-view", ["cuteYearView"], { "activeDate": { "alias": "activeDate"; "required": false; }; "selected": { "alias": "selected"; "required": false; }; "minDate": { "alias": "minDate"; "required": false; }; "maxDate": { "alias": "maxDate"; "required": false; }; "dateFilter": { "alias": "dateFilter"; "required": false; }; "dateClass": { "alias": "dateClass"; "required": false; }; }, { "selectedChange": "selectedChange"; "monthSelected": "monthSelected"; "activeDateChange": "activeDateChange"; }, never, never, true, never>;
+}
+
+/**
+ * @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).
+ */
+
+/**
+ * Possible views for the calendar.
+ * @docs-private
+ */
+type CuteCalendarView = 'month' | 'year' | 'multi-year';
+/** Default header for CuteCalendar */
+declare class CuteCalendarHeader<D> {
+    private _intl;
+    calendar: CuteCalendar<D>;
+    private _dateAdapter;
+    private _dateFormats;
+    constructor(...args: unknown[]);
+    /** The display text for the current calendar view. */
+    get periodButtonText(): string;
+    /** The aria description for the current calendar view. */
+    get periodButtonDescription(): string;
+    /** The `aria-label` for changing the calendar view. */
+    get periodButtonLabel(): string;
+    /** The label for the previous button. */
+    get prevButtonLabel(): string;
+    /** The label for the next button. */
+    get nextButtonLabel(): string;
+    /** Handles user clicks on the period label. */
+    currentPeriodClicked(): void;
+    /** Handles user clicks on the previous button. */
+    previousClicked(): void;
+    /** Handles user clicks on the next button. */
+    nextClicked(): void;
+    /** Whether the previous period button is enabled. */
+    previousEnabled(): boolean;
+    /** Whether the next period button is enabled. */
+    nextEnabled(): boolean;
+    /** Whether the two dates represent the same view in the current view mode (month or year). */
+    private _isSameView;
+    /**
+     * Format two individual labels for the minimum year and maximum year available in the multi-year
+     * calendar view. Returns an array of two strings where the first string is the formatted label
+     * for the minimum year, and the second string is the formatted label for the maximum year.
+     */
+    private _formatMinAndMaxYearLabels;
+    private _id;
+    _periodButtonLabelId: string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CuteCalendarHeader<any>, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<CuteCalendarHeader<any>, "cute-calendar-header", ["cuteCalendarHeader"], {}, {}, never, ["*"], true, never>;
+}
+/** A calendar that is used as part of the datepicker. */
+declare class CuteCalendar<D> implements AfterContentInit, AfterViewChecked, OnDestroy, OnChanges {
+    private _dateAdapter;
+    private _dateFormats;
+    private _changeDetectorRef;
+    /** An input indicating the type of the header component, if set. */
+    headerComponent: ComponentType<any> | undefined;
+    /** A portal containing the header component type for this calendar. */
+    _calendarHeaderPortal: Portal<any> | undefined;
+    private _intlChanges;
+    /**
+     * Used for scheduling that focus should be moved to the active cell on the next tick.
+     * We need to schedule it, rather than do it immediately, because we have to wait
+     * for Angular to re-evaluate the view children.
+     */
+    private _moveFocusOnNextTick;
+    /** A date representing the period (month or year) to start the calendar in. */
+    get startAt(): D | null;
+    set startAt(value: D | null);
+    private _startAt;
+    /** Whether the calendar should be started in month or year view. */
+    startView: CuteCalendarView;
+    /** The currently selected date. */
+    get selected(): DateRange<D> | D | null;
+    set selected(value: DateRange<D> | D | null);
+    private _selected;
+    /** The minimum selectable date. */
+    get minDate(): D | null;
+    set minDate(value: D | null);
+    private _minDate;
+    /** The maximum selectable date. */
+    get maxDate(): D | null;
+    set maxDate(value: D | null);
+    private _maxDate;
+    /** Function used to filter which dates are selectable. */
+    dateFilter?: ((date: D) => boolean) | null;
+    /** Function that can be used to add custom CSS classes to dates. */
+    dateClass: CuteCalendarCellClassFunction<D> | undefined;
+    /** Start of the comparison range. */
+    comparisonStart: D | null;
+    /** End of the comparison range. */
+    comparisonEnd: D | null;
+    /** ARIA-Accessible name of the `<input cuteStartDate/>` */
+    startDateAccessibleName: string | null;
+    /** ARIA-Accessible name of the `<input cuteEndDate/>` */
+    endDateAccessibleName: string | null;
+    /** Emits when the currently selected date changes. */
+    readonly selectedChange: EventEmitter<D | null>;
+    /**
+     * Emits the year chosen in multiyear view.
+     * This doesn't imply a change on the selected date.
+     */
+    readonly yearSelected: EventEmitter<D>;
+    /**
+     * Emits the month chosen in year view.
+     * This doesn't imply a change on the selected date.
+     */
+    readonly monthSelected: EventEmitter<D>;
+    /**
+     * Emits when the current view changes.
+     */
+    readonly viewChanged: EventEmitter<CuteCalendarView>;
+    /** Emits when any date is selected. */
+    readonly _userSelection: EventEmitter<CuteCalendarUserEvent<D | null>>;
+    /** Emits a new date range value when the user completes a drag drop operation. */
+    readonly _userDragDrop: EventEmitter<CuteCalendarUserEvent<DateRange<D>>>;
+    /** Reference to the current month view component. */
+    monthView: CuteMonthView<D> | undefined;
+    /** Reference to the current year view component. */
+    yearView: CuteYearView<D> | undefined;
+    /** Reference to the current multi-year view component. */
+    multiYearView: CuteMultiYearView<D> | undefined;
+    /**
+     * The current active date. This determines which time period is shown and which date is
+     * highlighted when using keyboard navigation.
+     */
+    get activeDate(): D;
+    set activeDate(value: D);
+    private _clampedActiveDate;
+    /** Whether the calendar is in month view. */
+    get currentView(): CuteCalendarView;
+    set currentView(value: CuteCalendarView);
+    private _currentView;
+    /** Origin of active drag, or null when dragging is not active. */
+    protected _activeDrag: CuteCalendarUserEvent<D> | null;
+    /**
+     * Emits whenever there is a state change that the header may need to respond to.
+     */
+    readonly stateChanges: Subject<void>;
+    constructor(...args: unknown[]);
+    ngAfterContentInit(): void;
+    ngAfterViewChecked(): void;
+    ngOnDestroy(): void;
+    ngOnChanges(changes: SimpleChanges): void;
+    /** Focuses the active date. */
+    focusActiveCell(): void;
+    /** Updates today's date after an update of the active date */
+    updateTodaysDate(): void;
+    /** Handles date selection in the month view. */
+    protected _dateSelected(event: CuteCalendarUserEvent<D | null>): void;
+    /** Handles year selection in the multiyear view. */
+    protected _yearSelectedInMultiYearView(normalizedYear: D): void;
+    /** Handles month selection in the year view. */
+    protected _monthSelectedInYearView(normalizedMonth: D): void;
+    /** Handles year/month selection in the multi-year/year views. */
+    protected _goToDateInView(date: D, view: 'month' | 'year' | 'multi-year'): void;
+    /** Called when the user starts dragging to change a date range. */
+    protected _dragStarted(event: CuteCalendarUserEvent<D>): void;
+    /**
+     * Called when a drag completes. It may end in cancellation or in the selection
+     * of a new range.
+     */
+    protected _dragEnded(event: CuteCalendarUserEvent<DateRange<D> | null>): void;
+    /** Returns the component instance that corresponds to the current calendar view. */
+    private _getCurrentViewComponent;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CuteCalendar<any>, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<CuteCalendar<any>, "cute-calendar", ["cuteCalendar"], { "headerComponent": { "alias": "headerComponent"; "required": false; }; "startAt": { "alias": "startAt"; "required": false; }; "startView": { "alias": "startView"; "required": false; }; "selected": { "alias": "selected"; "required": false; }; "minDate": { "alias": "minDate"; "required": false; }; "maxDate": { "alias": "maxDate"; "required": false; }; "dateFilter": { "alias": "dateFilter"; "required": false; }; "dateClass": { "alias": "dateClass"; "required": false; }; "comparisonStart": { "alias": "comparisonStart"; "required": false; }; "comparisonEnd": { "alias": "comparisonEnd"; "required": false; }; "startDateAccessibleName": { "alias": "startDateAccessibleName"; "required": false; }; "endDateAccessibleName": { "alias": "endDateAccessibleName"; "required": false; }; }, { "selectedChange": "selectedChange"; "yearSelected": "yearSelected"; "monthSelected": "monthSelected"; "viewChanged": "viewChanged"; "_userSelection": "_userSelection"; "_userDragDrop": "_userDragDrop"; }, never, never, true, never>;
+}
+
+/**
+ * An event used for datepicker input and change events. We don't always have access to a native
+ * input or change event because the event may have been triggered by the user clicking on the
+ * calendar popup. For consistency, we always use CuteDatepickerInputEvent instead.
+ */
+declare class CuteDatepickerInputEvent<D, S = unknown> {
+    /** Reference to the datepicker input component that emitted the event. */
+    target: CuteDatepickerInputBase<S, D>;
+    /** Reference to the native input element associated with the datepicker input. */
+    targetElement: HTMLElement;
+    /** The new value for the target datepicker input. */
+    value: D | null;
+    constructor(
+    /** Reference to the datepicker input component that emitted the event. */
+    target: CuteDatepickerInputBase<S, D>, 
+    /** Reference to the native input element associated with the datepicker input. */
+    targetElement: HTMLElement);
+}
+/** Function that can be used to filter out dates from a calendar. */
+type DateFilterFn<D> = (date: D | null) => boolean;
+/** Base class for datepicker inputs. */
+declare abstract class CuteDatepickerInputBase<S, D = ExtractDateTypeFromSelection<S>> implements ControlValueAccessor, AfterViewInit, OnChanges, OnDestroy, Validator {
+    protected _elementRef: ElementRef<HTMLInputElement>;
+    _dateAdapter: DateAdapter<D, any>;
+    private _dateFormats;
+    /** Whether the component has been initialized. */
+    private _isInitialized;
+    /** The value of the input. */
+    get value(): D | null;
+    set value(value: any);
+    protected _model: CuteDateSelectionModel<S, D> | undefined;
+    /** Whether the datepicker-input is disabled. */
+    get disabled(): boolean;
+    set disabled(value: boolean);
+    private _disabled;
+    /** Emits when a `change` event is fired on this `<input>`. */
+    readonly dateChange: EventEmitter<CuteDatepickerInputEvent<D, S>>;
+    /** Emits when an `input` event is fired on this `<input>`. */
+    readonly dateInput: EventEmitter<CuteDatepickerInputEvent<D, S>>;
+    /** Emits when the internal state has changed */
+    readonly stateChanges: Subject<void>;
+    _onTouched: () => void;
+    _validatorOnChange: () => void;
+    private _cvaOnChange;
+    private _valueChangesSubscription;
+    private _localeSubscription;
+    /**
+     * Since the value is kept on the model which is assigned in an Input,
+     * we might get a value before we have a model. This property keeps track
+     * of the value until we have somewhere to assign it.
+     */
+    private _pendingValue;
+    /** The form control validator for whether the input parses. */
+    private _parseValidator;
+    /** The form control validator for the date filter. */
+    private _filterValidator;
+    /** The form control validator for the min date. */
+    private _minValidator;
+    /** The form control validator for the max date. */
+    private _maxValidator;
+    /** Gets the base validator functions. */
+    protected _getValidators(): ValidatorFn[];
+    /** Gets the minimum date for the input. Used for validation. */
+    abstract _getMinDate(): D | null;
+    /** Gets the maximum date for the input. Used for validation. */
+    abstract _getMaxDate(): D | null;
+    /** Gets the date filter function. Used for validation. */
+    protected abstract _getDateFilter(): DateFilterFn<D> | undefined;
+    /** Registers a date selection model with the input. */
+    _registerModel(model: CuteDateSelectionModel<S, D>): void;
+    /** Opens the popup associated with the input. */
+    protected abstract _openPopup(): void;
+    /** Assigns a value to the input's model. */
+    protected abstract _assignValueToModel(model: D | null): void;
+    /** Converts a value from the model into a native value for the input. */
+    protected abstract _getValueFromModel(modelValue: S): D | null;
+    /** Combined form control validator for this input. */
+    protected abstract _validator: ValidatorFn | null;
+    /** Predicate that determines whether the input should handle a particular change event. */
+    protected abstract _shouldHandleChangeEvent(event: DateSelectionModelChange<S>): boolean;
+    /** Whether the last value set on the input was valid. */
+    protected _lastValueValid: boolean;
+    protected constructor(...args: unknown[]);
+    ngAfterViewInit(): void;
+    ngOnChanges(changes: SimpleChanges): void;
+    ngOnDestroy(): void;
+    /** @docs-private */
+    registerOnValidatorChange(fn: () => void): void;
+    /** @docs-private */
+    validate(c: AbstractControl): ValidationErrors | null;
+    writeValue(value: D): void;
+    registerOnChange(fn: (value: any) => void): void;
+    registerOnTouched(fn: () => void): void;
+    setDisabledState(isDisabled: boolean): void;
+    _onKeydown(event: KeyboardEvent): void;
+    _onInput(value: string): void;
+    _onChange(): void;
+    /** Handles blur events on the input. */
+    _onBlur(): void;
+    /** Formats a value and sets it on the input element. */
+    protected _formatValue(value: D | null): void;
+    /** Assigns a value to the model. */
+    private _assignValue;
+    /** Whether a value is considered valid. */
+    private _isValidValue;
+    /**
+     * Checks whether a parent control is disabled. This is in place so that it can be overridden
+     * by inputs extending this one which can be placed inside of a group that can be disabled.
+     */
+    protected _parentDisabled(): boolean;
+    /** Programmatically assigns a value to the input. */
+    protected _assignValueProgrammatically(value: D | null, reformat: boolean): void;
+    /** Gets whether a value matches the current date filter. */
+    _matchesFilter(value: D | null): boolean;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CuteDatepickerInputBase<any, any>, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<CuteDatepickerInputBase<any, any>, never, never, { "value": { "alias": "value"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; }, { "dateChange": "dateChange"; "dateInput": "dateInput"; }, never, never, true, never>;
+    static ngAcceptInputType_disabled: unknown;
+}
+
+/** Injection token that determines the scroll handling while the calendar is open. */
+declare const CUTE_DATEPICKER_SCROLL_STRATEGY: InjectionToken<() => ScrollStrategy>;
+/** Possible positions for the datepicker dropdown along the X axis. */
+type DatepickerDropdownPositionX = 'start' | 'end';
+/** Possible positions for the datepicker dropdown along the Y axis. */
+type DatepickerDropdownPositionY = 'above' | 'below';
+/**
+ * Component used as the content for the datepicker overlay. We use this instead of using
+ * CuteCalendar directly as the content, so we can control the initial focus. This also gives us a
+ * place to put additional features of the overlay that are not part of the calendar itself in the
+ * future. (e.g., confirmation buttons).
+ */
+declare class CuteDatepickerContent<S, D = ExtractDateTypeFromSelection<S>> implements AfterViewInit, OnDestroy {
+    protected _elementRef: ElementRef<any>;
+    protected _animationsDisabled: boolean;
+    private _changeDetectorRef;
+    private _globalModel;
+    private _dateAdapter;
+    private _ngZone;
+    private _rangeSelectionStrategy;
+    private _stateChanges;
+    private _model;
+    private _eventCleanups;
+    private _animationFallback;
+    /** Reference to the internal calendar component. */
+    _calendar: CuteCalendar<D> | undefined;
+    /** Palette color of the internal calendar. */
+    color: ThemeColor | undefined;
+    /** Reference to the datepicker that created the overlay. */
+    datepicker: CuteDatepickerBase<any, S, D>;
+    /** Start of the comparison range. */
+    comparisonStart: D | null;
+    /** End of the comparison range. */
+    comparisonEnd: D | null;
+    /** ARIA-Accessible name of the `<input cuteStartDate/>` */
+    startDateAccessibleName: string | null;
+    /** ARIA-Accessible name of the `<input cuteEndDate/>` */
+    endDateAccessibleName: string | null;
+    /** Whether the datepicker is above or below the input. */
+    _isAbove: boolean;
+    /** Emits when an animation has finished. */
+    readonly _animationDone: Subject<void>;
+    /** Whether there is an in-progress animation. */
+    _isAnimating: boolean;
+    /** Text for the close button. */
+    _closeButtonText: string;
+    /** Whether the close button currently has focus. */
+    _closeButtonFocused: boolean;
+    /** Portal with projected action buttons. */
+    _actionsPortal: TemplatePortal | null;
+    /** Id of the label for the `role="dialog"` element. */
+    _dialogLabelId: string | null;
+    constructor(...args: unknown[]);
+    ngAfterViewInit(): void;
+    ngOnDestroy(): void;
+    _handleUserSelection(event: CuteCalendarUserEvent<D | null>): void;
+    _handleUserDragDrop(event: CuteCalendarUserEvent<DateRange<D>>): void;
+    _startExitAnimation(): void;
+    private _handleAnimationEvent;
+    _getSelected(): D | DateRange<D> | null;
+    /** Applies the current pending selection to the global model. */
+    _applyPendingSelection(): void;
+    /**
+     * Assigns a new portal containing the datepicker actions.
+     * @param portal Portal with the actions to be assigned.
+     * @param forceRerender Whether a re-render of the portal should be triggered. This isn't
+     * necessary if the portal is assigned during initialization, but it may be required if it's
+     * added at a later point.
+     */
+    _assignActions(portal: TemplatePortal<any> | null, forceRerender: boolean): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CuteDatepickerContent<any, any>, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<CuteDatepickerContent<any, any>, "cute-datepicker-content", ["cuteDatepickerContent"], { "color": { "alias": "color"; "required": false; }; }, {}, never, never, true, never>;
+}
+/** Form control that can be associated with a datepicker. */
+interface CuteDatepickerControl<D> {
+    getStartValue(): D | null;
+    getThemeColor(): ThemeColor | undefined;
+    min: D | null;
+    max: D | null;
+    disabled: boolean;
+    dateFilter: DateFilterFn<D> | null | undefined;
+    getConnectedOverlayOrigin(): ElementRef;
+    getOverlayLabelId(): string | null;
+    stateChanges: Observable<void>;
+}
+/** A datepicker that can be attached to a {@link CuteDatepickerControl}. */
+interface CuteDatepickerPanel<C extends CuteDatepickerControl<D>, S, D = ExtractDateTypeFromSelection<S>> {
+    /** Stream that emits whenever the date picker is closed. */
+    closedStream: EventEmitter<void>;
+    /** Color palette to use on the datepicker's calendar. */
+    color?: ThemeColor;
+    /** The input element the datepicker is associated with. */
+    datepickerInput: C;
+    /** Whether the datepicker pop-up should be disabled. */
+    disabled: boolean;
+    /** The id for the datepicker's calendar. */
+    id: string;
+    /** Whether the datepicker is open. */
+    opened: boolean;
+    /** Stream that emits whenever the date picker is opened. */
+    openedStream: EventEmitter<void>;
+    /** Emits when the datepicker's state changes. */
+    stateChanges: Subject<void>;
+    /** Opens the datepicker. */
+    open(): void;
+    /** Register an input with the datepicker. */
+    registerInput(input: C): CuteDateSelectionModel<S, D>;
+}
+/** Base class for a datepicker. */
+declare abstract class CuteDatepickerBase<C extends CuteDatepickerControl<D>, S, D = ExtractDateTypeFromSelection<S>> implements CuteDatepickerPanel<C, S, D>, OnDestroy, OnChanges, Expandable {
+    private _injector;
+    private _viewContainerRef;
+    private _dateAdapter;
+    private _dir;
+    private _model;
+    private _animationsDisabled;
+    private _scrollStrategy;
+    private _inputStateChanges;
+    private _document;
+    /** An input indicating the type of the custom header component for the calendar, if set. */
+    calendarHeaderComponent: ComponentType<any>;
+    /** The date to open the calendar to initially. */
+    get startAt(): D | null;
+    set startAt(value: D | null);
+    private _startAt;
+    /** The view that the calendar should start in. */
+    startView: 'month' | 'year' | 'multi-year';
+    /** Color palette to use on the datepicker's calendar. */
+    get color(): ThemeColor | undefined;
+    set color(value: ThemeColor | undefined);
+    _color: ThemeColor | undefined;
+    /**
+     * Whether the calendar UI is in touch mode. In touch mode, the calendar opens in a dialog rather
+     * than a dropdown, and elements have more padding to allow for bigger touch targets.
+     */
+    touchUi: boolean;
+    /** Whether the datepicker pop-up should be disabled. */
+    get disabled(): boolean;
+    set disabled(value: boolean);
+    private _disabled;
+    /** Preferred position of the datepicker in the X axis. */
+    xPosition: DatepickerDropdownPositionX;
+    /** Preferred position of the datepicker in the Y axis. */
+    yPosition: DatepickerDropdownPositionY;
+    /**
+     * Whether to restore focus to the previously focused element when the calendar is closed.
+     * Note that automatic focus restoration is an accessibility feature, and it is recommended that
+     * you provide your own equivalent if you decide to turn it off.
+     */
+    restoreFocus: boolean;
+    /**
+     * Emits selected year in multiyear view.
+     * This doesn't imply a change on the selected date.
+     */
+    readonly yearSelected: EventEmitter<D>;
+    /**
+     * Emits selected month in year view.
+     * This doesn't imply a change on the selected date.
+     */
+    readonly monthSelected: EventEmitter<D>;
+    /**
+     * Emits when the current view changes.
+     */
+    readonly viewChanged: EventEmitter<CuteCalendarView>;
+    /** Function that can be used to add custom CSS classes to dates. */
+    dateClass: CuteCalendarCellClassFunction<D> | undefined;
+    /** Emits when the datepicker has been opened. */
+    readonly openedStream: EventEmitter<void>;
+    /** Emits when the datepicker has been closed. */
+    readonly closedStream: EventEmitter<void>;
+    /** Classes to be passed to the date picker panel. */
+    get panelClass(): string | string[];
+    set panelClass(value: string | string[]);
+    private _panelClass;
+    /** Whether the calendar is open. */
+    get opened(): boolean;
+    set opened(value: boolean);
+    private _opened;
+    /** `Expandable` interface implementation */
+    get expanded(): boolean;
+    /** The id for the datepicker calendar. */
+    id: string;
+    /** The minimum selectable date. */
+    _getMinDate(): D | null;
+    /** The maximum selectable date. */
+    _getMaxDate(): D | null;
+    _getDateFilter(): DateFilterFn<D> | null | undefined;
+    /** A reference to the overlay into which we've rendered the calendar. */
+    private _overlayRef;
+    /** Reference to the component instance rendered in the overlay. */
+    private _componentRef;
+    /** The element that was focused before the datepicker was opened. */
+    private _focusedElementBeforeOpen;
+    /** Unique class that will be added to the backdrop so that the test harnesses can look it up. */
+    private _backdropHarnessClass;
+    /** Currently-registered actions portal. */
+    private _actionsPortal;
+    /** The input element this datepicker is associated with. */
+    datepickerInput: C;
+    /** Emits when the datepicker's state changes. */
+    readonly stateChanges: Subject<void>;
+    private readonly _changeDetectorRef;
+    constructor(...args: unknown[]);
+    ngOnChanges(changes: SimpleChanges): void;
+    ngOnDestroy(): void;
+    /** Selects the given date */
+    select(date: D): void;
+    /** Emits the selected year in multiyear view */
+    _selectYear(normalizedYear: D): void;
+    /** Emits selected month in year view */
+    _selectMonth(normalizedMonth: D): void;
+    /** Emits changed view */
+    _viewChanged(view: CuteCalendarView): void;
+    /**
+     * Register an input with this datepicker.
+     * @param input The datepicker input to register with this datepicker.
+     * @returns Selection model that the input should hook itself up to.
+     */
+    registerInput(input: C): CuteDateSelectionModel<S, D>;
+    /**
+     * Registers a portal containing action buttons with the datepicker.
+     * @param portal Portal to be registered.
+     */
+    registerActions(portal: TemplatePortal): void;
+    /**
+     * Removes a portal containing action buttons from the datepicker.
+     * @param portal Portal to be removed.
+     */
+    removeActions(portal: TemplatePortal): void;
+    /** Open the calendar. */
+    open(): void;
+    /** Close the calendar. */
+    close(): void;
+    /** `Expandable` interface implementation */
+    toggle(): void;
+    /** Applies the current pending selection on the overlay to the model. */
+    _applyPendingSelection(): void;
+    /** Forwards relevant values from the datepicker to the datepicker content inside the overlay. */
+    protected _forwardContentValues(instance: CuteDatepickerContent<S, D>): void;
+    /** Opens the overlay with the calendar. */
+    private _openOverlay;
+    /** Destroys the current overlay. */
+    private _destroyOverlay;
+    /** Gets a position strategy that will open the calendar as a dropdown. */
+    private _getDialogStrategy;
+    /** Gets a position strategy that will open the calendar as a dropdown. */
+    private _getDropdownStrategy;
+    /** Sets the positions of the datepicker in dropdown mode based on the current configuration. */
+    private _setConnectedPositions;
+    /** Gets an observable that will emit when the overlay is supposed to be closed. */
+    private _getCloseStream;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CuteDatepickerBase<any, any, any>, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<CuteDatepickerBase<any, any, any>, never, never, { "calendarHeaderComponent": { "alias": "calendarHeaderComponent"; "required": false; }; "startAt": { "alias": "startAt"; "required": false; }; "startView": { "alias": "startView"; "required": false; }; "color": { "alias": "color"; "required": false; }; "touchUi": { "alias": "touchUi"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "xPosition": { "alias": "xPosition"; "required": false; }; "yPosition": { "alias": "yPosition"; "required": false; }; "restoreFocus": { "alias": "restoreFocus"; "required": false; }; "dateClass": { "alias": "dateClass"; "required": false; }; "panelClass": { "alias": "panelClass"; "required": false; }; "opened": { "alias": "opened"; "required": false; }; }, { "yearSelected": "yearSelected"; "monthSelected": "monthSelected"; "viewChanged": "viewChanged"; "openedStream": "opened"; "closedStream": "closed"; }, never, never, true, never>;
+    static ngAcceptInputType_touchUi: unknown;
+    static ngAcceptInputType_disabled: unknown;
+    static ngAcceptInputType_restoreFocus: unknown;
+    static ngAcceptInputType_opened: unknown;
+}
+
+/** Component responsible for managing the datepicker popup/dialog. */
+declare class CuteDatepicker<D> extends CuteDatepickerBase<CuteDatepickerControl<D>, D | null, D> {
+    static ɵfac: i0.ɵɵFactoryDeclaration<CuteDatepicker<any>, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<CuteDatepicker<any>, "cute-datepicker", ["cuteDatepicker"], {}, {}, never, never, true, never>;
+}
+
+/** @docs-private */
+declare const CUTE_DATEPICKER_VALUE_ACCESSOR: any;
+/** @docs-private */
+declare const CUTE_DATEPICKER_VALIDATORS: any;
+/** Directive used to connect an input to a CuteDatepicker. */
+declare class CuteDatepickerInput<D> extends CuteDatepickerInputBase<D | null, D> implements CuteDatepickerControl<D | null>, OnDestroy {
+    private _formField;
+    private _closedSubscription;
+    private _openedSubscription;
+    /** The datepicker that this input is associated with. */
+    set cuteDatepicker(datepicker: CuteDatepickerPanel<CuteDatepickerControl<D>, D | null, D>);
+    _datepicker: CuteDatepickerPanel<CuteDatepickerControl<D>, D | null, D> | undefined;
+    /** The id of the panel owned by this input. */
+    protected _ariaOwns: i0.WritableSignal<string | null>;
+    /** The minimum valid date. */
+    get min(): D | null;
+    set min(value: D | null);
+    private _min;
+    /** The maximum valid date. */
+    get max(): D | null;
+    set max(value: D | null);
+    private _max;
+    /** Function that can be used to filter out dates within the datepicker. */
+    get dateFilter(): DateFilterFn<D | null> | undefined;
+    set dateFilter(value: DateFilterFn<D | null>);
+    private _dateFilter;
+    /** The combined form control validator for this input. */
+    protected _validator: ValidatorFn | null;
+    constructor(...args: unknown[]);
+    /**
+     * Gets the element that the datepicker popup should be connected to.
+     * @return The element to connect the popup to.
+     */
+    getConnectedOverlayOrigin(): ElementRef;
+    /** Gets the ID of an element that should be used a description for the calendar overlay. */
+    getOverlayLabelId(): string | null;
+    /** Returns the palette used by the input's form field, if any. */
+    getThemeColor(): ThemeColor | undefined;
+    /** Gets the value at which the calendar should start. */
+    getStartValue(): D | null;
+    ngOnDestroy(): void;
+    /** Opens the associated datepicker. */
+    protected _openPopup(): void;
+    protected _getValueFromModel(modelValue: D | null): D | null;
+    protected _assignValueToModel(value: D | null): void;
+    /** Gets the input's minimum date. */
+    _getMinDate(): D | null;
+    /** Gets the input's maximum date. */
+    _getMaxDate(): D | null;
+    /** Gets the input's date filtering function. */
+    protected _getDateFilter(): DateFilterFn<D | null> | undefined;
+    protected _shouldHandleChangeEvent(event: DateSelectionModelChange<D>): boolean;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CuteDatepickerInput<any>, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<CuteDatepickerInput<any>, "input[cuteDatepicker]", ["cuteDatepickerInput"], { "cuteDatepicker": { "alias": "cuteDatepicker"; "required": false; }; "min": { "alias": "min"; "required": false; }; "max": { "alias": "max"; "required": false; }; "dateFilter": { "alias": "cuteDatepickerFilter"; "required": false; }; }, {}, never, never, true, never>;
+}
+
+/** Datepicker data that requires internationalization. */
+declare class CuteDatepickerIntl {
+    /**
+     * Stream that emits whenever the labels here are changed. Use this to notify
+     * components if the labels have changed after initialization.
+     */
+    readonly changes: Subject<void>;
+    /** A label for the calendar popup (used by screen readers). */
+    calendarLabel: string;
+    /** A label for the button used to open the calendar popup (used by screen readers). */
+    openCalendarLabel: string;
+    /** Label for the button used to close the calendar popup. */
+    closeCalendarLabel: string;
+    /** A label for the previous month button (used by screen readers). */
+    prevMonthLabel: string;
+    /** A label for the next month button (used by screen readers). */
+    nextMonthLabel: string;
+    /** A label for the previous year button (used by screen readers). */
+    prevYearLabel: string;
+    /** A label for the next year button (used by screen readers). */
+    nextYearLabel: string;
+    /** A label for the previous multi-year button (used by screen readers). */
+    prevMultiYearLabel: string;
+    /** A label for the next multi-year button (used by screen readers). */
+    nextMultiYearLabel: string;
+    /** A label for the 'switch to month view' button (used by screen readers). */
+    switchToMonthViewLabel: string;
+    /** A label for the 'switch to year view' button (used by screen readers). */
+    switchToMultiYearViewLabel: string;
+    /**
+     * A label for the first date of a range of dates (used by screen readers).
+     * @deprecated Provide your own internationalization string.
+     * @breaking-change 17.0.0
+     */
+    startDateLabel: string;
+    /**
+     * A label for the last date of a range of dates (used by screen readers).
+     * @deprecated Provide your own internationalization string.
+     * @breaking-change 17.0.0
+     */
+    endDateLabel: string;
+    /**
+     * A label for the Comparison date of a range of dates (used by screen readers).
+     */
+    comparisonDateLabel: string;
+    /** Formats a range of years (used for visuals). */
+    formatYearRange(start: string, end: string): string;
+    /** Formats a label for a range of years (used by screen readers). */
+    formatYearRangeLabel(start: string, end: string): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CuteDatepickerIntl, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<CuteDatepickerIntl>;
+}
+
+/**
+ * @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).
+ */
+
+/** Can be used to override the icon of a `cuteDatepickerToggle`. */
+declare class CuteDatepickerToggleIcon {
+    static ɵfac: i0.ɵɵFactoryDeclaration<CuteDatepickerToggleIcon, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<CuteDatepickerToggleIcon, "[cuteDatepickerToggleIcon]", never, {}, {}, never, never, true, never>;
+}
+declare class CuteDatepickerToggle<D> implements AfterContentInit, OnChanges, OnDestroy {
+    _intl: CuteDatepickerIntl;
+    private _changeDetectorRef;
+    private _stateChanges;
+    /** Datepicker instance that the button will toggle. */
+    datepicker: CuteDatepickerPanel<CuteDatepickerControl<any>, D> | undefined;
+    /** Tabindex for the toggle. */
+    tabIndex: number | null;
+    /** Screen-reader label for the button. */
+    ariaLabel: string | undefined;
+    /** Whether the toggle button is disabled. */
+    get disabled(): boolean;
+    set disabled(value: boolean);
+    private _disabled;
+    /** Whether ripples on the toggle should be disabled. */
+    disableRipple: boolean;
+    /** Custom icon set by the consumer. */
+    _customIcon: CuteDatepickerToggleIcon | undefined;
+    /** Underlying button element. */
+    _button: CuteButton | undefined;
+    constructor(...args: unknown[]);
+    ngOnChanges(changes: SimpleChanges): void;
+    ngOnDestroy(): void;
+    ngAfterContentInit(): void;
+    _open(event: Event): void;
+    private _watchStateChanges;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CuteDatepickerToggle<any>, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<CuteDatepickerToggle<any>, "cute-datepicker-toggle", ["cuteDatepickerToggle"], { "datepicker": { "alias": "for"; "required": false; }; "tabIndex": { "alias": "tabIndex"; "required": false; }; "ariaLabel": { "alias": "aria-label"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "disableRipple": { "alias": "disableRipple"; "required": false; }; }, {}, ["_customIcon"], ["[cuteDatepickerToggleIcon]"], true, never>;
+    static ngAcceptInputType_disabled: unknown;
+}
+
+/**
+ * @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).
+ */
+
+/** Parent component that should be wrapped around `CuteStartDate` and `CuteEndDate`. */
+interface CuteDateRangeInputParent<D> {
+    id: string;
+    min: D | null;
+    max: D | null;
+    dateFilter: DateFilterFn<D> | undefined;
+    rangePicker: {
+        opened: boolean;
+        id: string;
+    };
+    _startInput: CuteDateRangeInputPartBase<D> | undefined;
+    _endInput: CuteDateRangeInputPartBase<D> | undefined;
+    _groupDisabled: boolean;
+    _handleChildValueChange(): void;
+    _openDatepicker(): void;
+}
+/**
+ * Base class for the individual inputs that can be projected inside a `cute-date-range-input`.
+ */
+declare abstract class CuteDateRangeInputPartBase<D> extends CuteDatepickerInputBase<DateRange<D>> implements OnInit, DoCheck {
+    _rangeInput: CuteDateRangeInputParent<D>;
+    _elementRef: ElementRef<HTMLInputElement>;
+    _defaultErrorStateMatcher: ErrorStateMatcher;
+    private _injector;
+    private _rawValue;
+    _parentForm: NgForm | null;
+    _parentFormGroup: FormGroupDirective | null;
+    /**
+     * Form control bound to this input part.
+     * @docs-private
+     */
+    ngControl: NgControl;
+    protected abstract _validator: ValidatorFn | null;
+    protected abstract _assignValueToModel(value: D | null): void;
+    protected abstract _getValueFromModel(modelValue: DateRange<D>): D | null;
+    protected readonly _dir: Directionality | null;
+    private _errorStateTracker;
+    /** Object used to control when error messages are shown. */
+    get errorStateMatcher(): ErrorStateMatcher;
+    set errorStateMatcher(value: ErrorStateMatcher);
+    /** Whether the input is in an error state. */
+    get errorState(): boolean;
+    set errorState(value: boolean);
+    protected constructor(...args: unknown[]);
+    ngOnInit(): void;
+    ngDoCheck(): void;
+    /** Gets whether the input is empty. */
+    isEmpty(): boolean;
+    /** Gets the placeholder of the input. */
+    _getPlaceholder(): string;
+    /** Focuses the input. */
+    focus(): void;
+    /** Gets the value that should be used when mirroring the input's size. */
+    getMirrorValue(): string;
+    /** Refreshes the error state of the input. */
+    updateErrorState(): void;
+    /** Handles `input` events on the input element. */
+    _onInput(value: string): void;
+    /** Opens the datepicker associated with the input. */
+    protected _openPopup(): void;
+    /** Gets the minimum date from the range input. */
+    _getMinDate(): D | null;
+    /** Gets the maximum date from the range input. */
+    _getMaxDate(): D | null;
+    /** Gets the date filter function from the range input. */
+    protected _getDateFilter(): DateFilterFn<D> | undefined;
+    protected _parentDisabled(): boolean;
+    protected _shouldHandleChangeEvent({ source }: DateSelectionModelChange<DateRange<D>>): boolean;
+    protected _assignValueProgrammatically(value: D | null, reformat: boolean): void;
+    /** return the ARIA accessible name of the input element */
+    _getAccessibleName(): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CuteDateRangeInputPartBase<any>, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<CuteDateRangeInputPartBase<any>, never, never, { "errorStateMatcher": { "alias": "errorStateMatcher"; "required": false; }; }, {}, never, never, true, never>;
+}
+/** Input for entering the start date in a `cute-date-range-input`. */
+declare class CuteStartDate<D> extends CuteDateRangeInputPartBase<D> {
+    /** Validator that checks that the start date isn't after the end date. */
+    private _startValidator;
+    protected _validator: ValidatorFn | null;
+    protected _getValueFromModel(modelValue: DateRange<D>): D | null;
+    protected _shouldHandleChangeEvent(change: DateSelectionModelChange<DateRange<D>>): boolean;
+    protected _assignValueToModel(value: D | null): void;
+    protected _formatValue(value: D | null): void;
+    _onKeydown(event: KeyboardEvent): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CuteStartDate<any>, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<CuteStartDate<any>, "input[cuteStartDate]", never, {}, { "dateChange": "dateChange"; "dateInput": "dateInput"; }, never, never, true, never>;
+}
+/** Input for entering the end date in a `cute-date-range-input`. */
+declare class CuteEndDate<D> extends CuteDateRangeInputPartBase<D> {
+    /** Validator that checks that the end date isn't before the start date. */
+    private _endValidator;
+    protected _validator: ValidatorFn | null;
+    protected _getValueFromModel(modelValue: DateRange<D>): D | null;
+    protected _shouldHandleChangeEvent(change: DateSelectionModelChange<DateRange<D>>): boolean;
+    protected _assignValueToModel(value: D | null): void;
+    private _moveCaretToEndOfStartInput;
+    _onKeydown(event: KeyboardEvent): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CuteEndDate<any>, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<CuteEndDate<any>, "input[cuteEndDate]", never, {}, { "dateChange": "dateChange"; "dateInput": "dateInput"; }, never, never, true, never>;
+}
+
+/**
+ * Input that can be associated with a date range picker.
+ * @docs-private
+ */
+interface CuteDateRangePickerInput<D> extends CuteDatepickerControl<D> {
+    _getEndDateAccessibleName(): string | null;
+    _getStartDateAccessibleName(): string | null;
+    comparisonStart: D | null;
+    comparisonEnd: D | null;
+}
+/** Component responsible for managing the date range picker popup/dialog. */
+declare class CuteDateRangePicker<D> extends CuteDatepickerBase<CuteDateRangePickerInput<D>, DateRange<D>, D> {
+    protected _forwardContentValues(instance: CuteDatepickerContent<DateRange<D>, D>): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CuteDateRangePicker<any>, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<CuteDateRangePicker<any>, "cute-date-range-picker", ["cuteDateRangePicker"], {}, {}, never, never, true, never>;
+}
+
+declare class CuteDateRangeInput<D> implements CuteFormFieldControl<DateRange<D>>, CuteDatepickerControl<D>, CuteDateRangeInputParent<D>, CuteDateRangePickerInput<D>, AfterContentInit, OnChanges, OnDestroy {
+    private _changeDetectorRef;
+    private _elementRef;
+    private _dateAdapter;
+    private _formField;
+    private _closedSubscription;
+    private _openedSubscription;
+    /** Current value of the range input. */
+    get value(): DateRange<D> | null;
+    /** Unique ID for the group. */
+    id: string;
+    /** Whether the control is focused. */
+    focused: boolean;
+    /** Whether the control's label should float. */
+    get shouldLabelFloat(): boolean;
+    /** Name of the form control. */
+    controlType: string;
+    /**
+     * Implemented as a part of `CuteFormFieldControl`.
+     * Set the placeholder attribute on `cuteStartDate` and `cuteEndDate`.
+     */
+    get placeholder(): string;
+    /** The range picker that this input is associated with. */
+    get rangePicker(): CuteDatepickerPanel<CuteDatepickerControl<D>, DateRange<D>, D>;
+    set rangePicker(rangePicker: CuteDatepickerPanel<CuteDatepickerControl<D>, DateRange<D>, D>);
+    private _rangePicker;
+    /** The id of the panel owned by this input. */
+    _ariaOwns: i0.WritableSignal<string | null>;
+    /** Whether the input is required. */
+    get required(): boolean;
+    set required(value: boolean);
+    private _required;
+    /** Function that can be used to filter out dates within the date range picker. */
+    get dateFilter(): DateFilterFn<D> | undefined;
+    set dateFilter(value: DateFilterFn<D> | null | undefined);
+    private _dateFilter;
+    /** The minimum valid date. */
+    get min(): D | null;
+    set min(value: D | null);
+    private _min;
+    /** The maximum valid date. */
+    get max(): D | null;
+    set max(value: D | null);
+    private _max;
+    /** Whether the input is disabled. */
+    get disabled(): boolean;
+    set disabled(value: boolean);
+    _groupDisabled: boolean;
+    setDisabledState(value: boolean): void;
+    /** Whether the input is in an error state. */
+    get errorState(): boolean;
+    /** Whether the datepicker input is empty. */
+    get empty(): boolean;
+    /** Value for the `aria-describedby` attribute of the inputs. */
+    _ariaDescribedBy: string | null;
+    /** Date selection model currently registered with the input. */
+    private _model;
+    /** Separator text to be shown between the inputs. */
+    separator: string;
+    /** Start of the comparison range that should be shown in the calendar. */
+    comparisonStart: D | null;
+    /** End of the comparison range that should be shown in the calendar. */
+    comparisonEnd: D | null;
+    _startInput: CuteStartDate<D> | undefined;
+    _endInput: CuteEndDate<D> | undefined;
+    /**
+     * Implemented as a part of `CuteFormFieldControl`.
+     * TODO(crisbeto): change type to `AbstractControlDirective` after #18206 lands.
+     * @docs-private
+     */
+    ngControl: NgControl | null;
+    /** Emits when the input's state has changed. */
+    readonly stateChanges: Subject<void>;
+    /**
+     * Disable the automatic labeling to avoid issues like #27241.
+     * @docs-private
+     */
+    readonly disableAutomaticLabeling = true;
+    readonly controlElementRef: ElementRef | undefined;
+    constructor(...args: unknown[]);
+    /**
+     * Implemented as a part of `CuteFormFieldControl`.
+     */
+    setDescribedByIds(ids: string[]): void;
+    /**
+     * Implemented as part of CuteFormFieldControl.
+     */
+    get describedByIds(): string[];
+    /**
+     * Implemented as a part of `CuteFormFieldControl`.
+     */
+    onContainerClick(): void;
+    ngAfterContentInit(): void;
+    ngOnChanges(changes: SimpleChanges): void;
+    ngOnDestroy(): void;
+    /** Gets the date at which the calendar should start. */
+    getStartValue(): D | null;
+    /** Gets the input's theme palette. */
+    getThemeColor(): ThemeColor | undefined;
+    /** Gets the element to which the calendar overlay should be attached. */
+    getConnectedOverlayOrigin(): ElementRef;
+    /** Gets the ID of an element that should be used a description for the calendar overlay. */
+    getOverlayLabelId(): string | null;
+    /** Gets the value that is used to mirror the state input. */
+    protected _getInputMirrorValue(part: 'start' | 'end'): string;
+    /** Whether the input placeholders should be hidden. */
+    protected _shouldHidePlaceholders(): boolean;
+    /**
+     *  Handles the value in one of the child inputs changing.
+     *  Implementing interface `CuteDateRangeInputParent`.
+     */
+    _handleChildValueChange(): void;
+    /**
+     * Opens the date range picker associated with the input.
+     * Implementing interface `CuteDateRangeInputParent`.
+     */
+    _openDatepicker(): void;
+    /** Whether the separate text should be hidden. */
+    protected _shouldHideSeparator(): boolean | "" | null;
+    /** Gets the value for the `aria-labelledby` attribute of the inputs. */
+    protected _getAriaLabelledby(): string | null;
+    /**
+     * Implementing interface `CuteDateRangeInputParent`.
+     */
+    _getStartDateAccessibleName(): string;
+    /**
+     * Implementing interface `CuteDateRangeInputParent`.
+     */
+    _getEndDateAccessibleName(): string;
+    /** Updates the focused state of the range input. */
+    _updateFocus(origin: FocusOrigin): void;
+    /** Re-runs the validators on the start/end inputs. */
+    private _revalidate;
+    /** Registers the current date selection model with the start/end inputs. */
+    private _registerModel;
+    /** Checks whether a specific range input directive is required. */
+    private _isTargetRequired;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CuteDateRangeInput<any>, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<CuteDateRangeInput<any>, "cute-date-range-input", ["cuteDateRangeInput"], { "rangePicker": { "alias": "rangePicker"; "required": false; }; "required": { "alias": "required"; "required": false; }; "dateFilter": { "alias": "dateFilter"; "required": false; }; "min": { "alias": "min"; "required": false; }; "max": { "alias": "max"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "separator": { "alias": "separator"; "required": false; }; "comparisonStart": { "alias": "comparisonStart"; "required": false; }; "comparisonEnd": { "alias": "comparisonEnd"; "required": false; }; }, {}, ["_startInput", "_endInput"], ["input[cuteStartDate]", "input[cuteEndDate]"], true, never>;
+    static ngAcceptInputType_required: unknown;
+    static ngAcceptInputType_disabled: unknown;
+}
+
+/**
+ * @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).
+ */
+
+/** Button that will close the datepicker and assign the current selection to the data model. */
+declare class CuteDatepickerApply {
+    private _datepicker;
+    constructor(...args: unknown[]);
+    _applySelection(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CuteDatepickerApply, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<CuteDatepickerApply, "[cuteDatepickerApply], [cuteDateRangePickerApply]", never, {}, {}, never, never, true, never>;
+}
+/** Button that will close the datepicker and discard the current selection. */
+declare class CuteDatepickerCancel {
+    _datepicker: CuteDatepickerBase<CuteDatepickerControl<any>, unknown, {}>;
+    constructor(...args: unknown[]);
+    static ɵfac: i0.ɵɵFactoryDeclaration<CuteDatepickerCancel, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<CuteDatepickerCancel, "[cuteDatepickerCancel], [cuteDateRangePickerCancel]", never, {}, {}, never, never, true, never>;
+}
+/**
+ * Container that can be used to project a row of action buttons
+ * to the bottom of a datepicker or date range picker.
+ */
+declare class CuteDatepickerActions implements AfterViewInit, OnDestroy {
+    private _datepicker;
+    private _viewContainerRef;
+    _template: TemplateRef<unknown>;
+    private _portal;
+    constructor(...args: unknown[]);
+    ngAfterViewInit(): void;
+    ngOnDestroy(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CuteDatepickerActions, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<CuteDatepickerActions, "cute-datepicker-actions, cute-date-range-picker-actions", never, {}, {}, never, ["*"], true, never>;
+}
+
+declare class CuteDatepickerModule {
+    static ɵfac: i0.ɵɵFactoryDeclaration<CuteDatepickerModule, never>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<CuteDatepickerModule, never, [typeof i1.CommonModule, typeof i2.CuteButtonModule, typeof i3.OverlayModule, typeof i4.A11yModule, typeof i5.PortalModule, typeof CuteCalendar, typeof CuteCalendarBody, typeof CuteDatepicker, typeof CuteDatepickerContent, typeof CuteDatepickerInput, typeof CuteDatepickerToggle, typeof CuteDatepickerToggleIcon, typeof CuteMonthView, typeof CuteYearView, typeof CuteMultiYearView, typeof CuteCalendarHeader, typeof CuteDateRangeInput, typeof CuteStartDate, typeof CuteEndDate, typeof CuteDateRangePicker, typeof CuteDatepickerActions, typeof CuteDatepickerCancel, typeof CuteDatepickerApply], [typeof i19.CdkScrollableModule, typeof CuteCalendar, typeof CuteCalendarBody, typeof CuteDatepicker, typeof CuteDatepickerContent, typeof CuteDatepickerInput, typeof CuteDatepickerToggle, typeof CuteDatepickerToggleIcon, typeof CuteMonthView, typeof CuteYearView, typeof CuteMultiYearView, typeof CuteCalendarHeader, typeof CuteDateRangeInput, typeof CuteStartDate, typeof CuteEndDate, typeof CuteDateRangePicker, typeof CuteDatepickerActions, typeof CuteDatepickerCancel, typeof CuteDatepickerApply]>;
+    static ɵinj: i0.ɵɵInjectorDeclaration<CuteDatepickerModule>;
+}
+
+/**
+ * @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).
+ */
+
+/** Injection token used to customize the date range selection behavior. */
+declare const CUTE_DATE_RANGE_SELECTION_STRATEGY: InjectionToken<CuteDateRangeSelectionStrategy<any>>;
+/** Object that can be provided in order to customize the date range selection behavior. */
+interface CuteDateRangeSelectionStrategy<D> {
+    /**
+     * Called when the user has finished selecting a value.
+     * @param date Date that was selected. Will be null if the user cleared the selection.
+     * @param currentRange Range that is currently show in the calendar.
+     * @param event DOM event that triggered the selection. Currently only corresponds to a `click`
+     *    event, but it may get expanded in the future.
+     */
+    selectionFinished(date: D | null, currentRange: DateRange<D>, event: Event): DateRange<D>;
+    /**
+     * Called when the user has activated a new date (e.g. by hovering over
+     * it or moving focus) and the calendar tries to display a date range.
+     *
+     * @param activeDate Date that the user has activated. Will be null if the user moved
+     *    focus to an element that's no a calendar cell.
+     * @param currentRange Range that is currently shown in the calendar.
+     * @param event DOM event that caused the preview to be changed. Will be either a
+     *    `mouseenter`/`mouseleave` or `focus`/`blur` depending on how the user is navigating.
+     */
+    createPreview(activeDate: D | null, currentRange: DateRange<D>, event: Event): DateRange<D>;
+    /**
+     * Called when the user has dragged a date in the currently selected range to another
+     * date. Returns the date updated range that should result from this interaction.
+     *
+     * @param dragOrigin The date the user started dragging from.
+     * @param originalRange The originally selected date range.
+     * @param newDate The currently targeted date in the drag operation.
+     * @param event DOM event that triggered the updated drag state. Will be
+     *     `mouseenter`/`mouseup` or `touchmove`/`touchend` depending on the device type.
+     */
+    createDrag?(dragOrigin: D, originalRange: DateRange<D>, newDate: D, event: Event): DateRange<D> | null;
+}
+/** Provides the default date range selection behavior. */
+declare class DefaultCuteCalendarRangeStrategy<D> implements CuteDateRangeSelectionStrategy<D> {
+    private _dateAdapter;
+    constructor(_dateAdapter: DateAdapter<D>);
+    selectionFinished(date: D, currentRange: DateRange<D>): DateRange<D>;
+    createPreview(activeDate: D | null, currentRange: DateRange<D>): DateRange<D>;
+    createDrag(dragOrigin: D, originalRange: DateRange<D>, newDate: D): DateRange<D> | null;
+    static ɵfac: i0.ɵɵFactoryDeclaration<DefaultCuteCalendarRangeStrategy<any>, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<DefaultCuteCalendarRangeStrategy<any>>;
+}
+
+export { CUTE_DATEPICKER_SCROLL_STRATEGY, CUTE_DATEPICKER_VALIDATORS, CUTE_DATEPICKER_VALUE_ACCESSOR, CUTE_DATE_RANGE_SELECTION_STRATEGY, CUTE_RANGE_DATE_SELECTION_MODEL_PROVIDER, CUTE_SINGLE_DATE_SELECTION_MODEL_PROVIDER, CuteCalendar, CuteCalendarBody, CuteCalendarCell, CuteCalendarHeader, CuteDateRangeInput, CuteDateRangePicker, CuteDateSelectionModel, CuteDatepicker, CuteDatepickerActions, CuteDatepickerApply, CuteDatepickerCancel, CuteDatepickerContent, CuteDatepickerInput, CuteDatepickerInputEvent, CuteDatepickerIntl, CuteDatepickerModule, CuteDatepickerToggle, CuteDatepickerToggleIcon, CuteEndDate, CuteMonthView, CuteMultiYearView, CuteRangeDateSelectionModel, CuteSingleDateSelectionModel, CuteStartDate, CuteYearView, DateRange, DefaultCuteCalendarRangeStrategy, yearsPerPage, yearsPerRow };
+export type { CuteCalendarCellClassFunction, CuteCalendarCellCssClasses, CuteCalendarUserEvent, CuteCalendarView, CuteDateRangeSelectionStrategy, CuteDatepickerControl, CuteDatepickerPanel, DateFilterFn, DateSelectionModelChange, DatepickerDropdownPositionX, DatepickerDropdownPositionY, ExtractDateTypeFromSelection };