@netwin/angular-datetime-picker 19.0.0-rc.4 → 19.0.0-rc.6

package/lib/date-time/adapter/date-time-adapter.class.d.ts

@@ -1,7 +1,12 @@
+/**
+ * date-time-adapter.class
+ */
 import { InjectionToken } from '@angular/core';
-import { Subject } from 'rxjs';
+import { Observable, Subject } from 'rxjs';
 /** InjectionToken for date time picker that can be used to override default locale code. */
 export declare const OWL_DATE_TIME_LOCALE: InjectionToken<string>;
+/** @docs-private */
+export declare function OWL_DATE_TIME_LOCALE_FACTORY(): string;
 /** Provider for OWL_DATE_TIME_LOCALE injection token. */
 export declare const OWL_DATE_TIME_LOCALE_PROVIDER: {
     provide: InjectionToken<string>;
@@ -9,10 +14,10 @@ export declare const OWL_DATE_TIME_LOCALE_PROVIDER: {
 };
 export declare abstract class DateTimeAdapter<T> {
     /** The locale to use for all dates. */
-    protected locale: string;
+    protected locale: any;
     /** A stream that emits when the locale changes. */
     protected _localeChanges: Subject<string>;
-    localeChanges: import("rxjs").Observable<string>;
+    get localeChanges(): Observable<string>;
     /** total milliseconds in a day. */
     protected readonly millisecondsInDay = 86400000;
     /** total milliseconds in a minute. */
@@ -128,10 +133,11 @@ export declare abstract class DateTimeAdapter<T> {
      */
     abstract setSeconds(date: T, amount: number): T;
     /**
-     * Creates a date with the given year, month, day, hour, minute and second.
-     * Does not allow over/under-flow of the month and date.
+     * Creates a date with the given year, month, date, hour, minute and second. Does not allow over/under-flow of the
+     * month and date.
      */
-    abstract createDate(year: number, month: number, day: number, hours?: number, minutes?: number, seconds?: number): T;
+    abstract createDate(year: number, month: number, date: number): T;
+    abstract createDate(year: number, month: number, date: number, hours: number, minutes: number, seconds: number): T;
     /**
      * Clone the given date
      */
@@ -143,7 +149,11 @@ export declare abstract class DateTimeAdapter<T> {
     /**
      * Formats a date as a string according to the given format.
      */
-    abstract format(date: T, displayFormat: Intl.DateTimeFormatOptions): string;
+    abstract format(date: T, displayFormat: any): string;
+    /**
+     * Parse a user-provided value to a Date Object
+     */
+    abstract parse(value: any, parseFormat: any): T | null;
     /**
      * Compare two given dates
      * 1 if the first date is after the second,
@@ -167,7 +177,7 @@ export declare abstract class DateTimeAdapter<T> {
      * support passing values from your backend directly to these properties by overriding this method
      * to also deserialize the format used by your backend.
      */
-    deserialize(value: unknown | null): T | null;
+    deserialize(value: any): T | null;
     /**
      * Sets the locale used for all dates.
      */
@@ -175,7 +185,7 @@ export declare abstract class DateTimeAdapter<T> {
     /**
      * Get the locale used for all dates.
      */
-    getLocale(): string;
+    getLocale(): any;
     /**
      * Clamp the given date between min and max dates.
      */

package/lib/date-time/adapter/date-time-format.class.d.ts

@@ -1,11 +1,15 @@
+/**
+ * date-time-format.class
+ */
 import { InjectionToken } from '@angular/core';
-export type OwlDateTimeFormats = {
-    fullPickerInput: Pick<Intl.DateTimeFormatOptions, 'year' | 'month' | 'day' | 'hour' | 'minute'>;
-    datePickerInput: Pick<Intl.DateTimeFormatOptions, 'year' | 'month' | 'day'>;
-    timePickerInput: Pick<Intl.DateTimeFormatOptions, 'hour' | 'minute'>;
-    monthYearLabel: Pick<Intl.DateTimeFormatOptions, 'year' | 'month'>;
-    dateA11yLabel: Pick<Intl.DateTimeFormatOptions, 'year' | 'month' | 'day'>;
-    monthYearA11yLabel: Pick<Intl.DateTimeFormatOptions, 'year' | 'month'>;
-};
+export interface OwlDateTimeFormats {
+    parseInput: any;
+    fullPickerInput: any;
+    datePickerInput: any;
+    timePickerInput: any;
+    monthYearLabel: any;
+    dateA11yLabel: any;
+    monthYearA11yLabel: any;
+}
 /** InjectionToken for date time picker that can be used to override default format. */
 export declare const OWL_DATE_TIME_FORMATS: InjectionToken<OwlDateTimeFormats>;

package/lib/date-time/adapter/native-date-time-adapter.class.d.ts

@@ -1,11 +1,21 @@
+/**
+ * native-date-time-adapter.class
+ */
+import { Platform } from '@angular/cdk/platform';
 import { DateTimeAdapter } from './date-time-adapter.class';
 import * as i0 from "@angular/core";
 export declare class NativeDateTimeAdapter extends DateTimeAdapter<Date> {
-    private readonly platform;
-    private readonly owlDateTimeLocale;
+    private owlDateTimeLocale;
     /** Whether to clamp the date between 1 and 9999 to avoid IE and Edge errors. */
     private readonly _clampDate;
-    constructor();
+    /**
+     * Whether to use `timeZone: 'utc'` with `Intl.DateTimeFormat` when formatting dates.
+     * Without this `Intl.DateTimeFormat` sometimes chooses the wrong timeZone, which can throw off
+     * the result. (e.g. in the en-US locale `new Date(1800, 7, 14).toLocaleDateString()`
+     * will produce `'8/13/1800'`.
+     */
+    useUtcForDisplay: boolean;
+    constructor(owlDateTimeLocale: string, platform: Platform);
     getYear(date: Date): number;
     getMonth(date: Date): number;
     getDay(date: Date): number;
@@ -36,12 +46,13 @@ export declare class NativeDateTimeAdapter extends DateTimeAdapter<Date> {
     clone(date: Date): Date;
     now(): Date;
     format(date: Date, displayFormat: Intl.DateTimeFormatOptions): string;
+    parse(value: any, parseFormat: any): Date | null;
     /**
      * Returns the given value if given a valid Date or null. Deserializes valid ISO 8601 strings
      * (https://www.ietf.org/rfc/rfc3339.txt) into valid Dates and empty string into null. Returns an
      * invalid date for all other values.
      */
-    deserialize(value: unknown): Date | null;
+    deserialize(value: any): Date | null;
     /**
      * Strip out unicode LTR and RTL characters. Edge and IE insert these into formatted dates while
      * other browsers do not. We remove them to make output consistent and because they interfere with
@@ -56,6 +67,6 @@ export declare class NativeDateTimeAdapter extends DateTimeAdapter<Date> {
      * representation with the local date and time.
      */
     private _format;
-    static ɵfac: i0.ɵɵFactoryDeclaration<NativeDateTimeAdapter, never>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<NativeDateTimeAdapter, [{ optional: true; }, null]>;
     static ɵprov: i0.ɵɵInjectableDeclaration<NativeDateTimeAdapter>;
 }

package/lib/date-time/adapter/native-date-time-format.class.d.ts

@@ -1,2 +1,5 @@
+/**
+ * native-date-time-format.class
+ */
 import { OwlDateTimeFormats } from './date-time-format.class';
 export declare const OWL_NATIVE_DATE_TIME_FORMATS: OwlDateTimeFormats;

package/lib/date-time/adapter/unix-timestamp-adapter/unix-timestamp-date-time-adapter.class.d.ts

@@ -1,11 +1,21 @@
+/**
+ * unix-timestamp-date-time-adapter.class
+ */
+import { Platform } from '@angular/cdk/platform';
 import { DateTimeAdapter } from '../date-time-adapter.class';
 import * as i0 from "@angular/core";
 export declare class UnixTimestampDateTimeAdapter extends DateTimeAdapter<number> {
-    private readonly platform;
-    private readonly owlDateTimeLocale;
+    private owlDateTimeLocale;
+    constructor(owlDateTimeLocale: string, platform: Platform);
     /** Whether to clamp the date between 1 and 9999 to avoid IE and Edge errors. */
     private readonly _clampDate;
-    constructor();
+    /**
+     * Whether to use `timeZone: 'utc'` with `Intl.DateTimeFormat` when formatting dates.
+     * Without this `Intl.DateTimeFormat` sometimes chooses the wrong timeZone, which can throw off
+     * the result. (e.g. in the en-US locale `new Date(1800, 7, 14).toLocaleDateString()`
+     * will produce `'8/13/1800'`.
+     */
+    useUtcForDisplay: boolean;
     /**
      * Strip out unicode LTR and RTL characters. Edge and IE insert these into formatted dates while
      * other browsers do not. We remove them to make output consistent and because they interfere with
@@ -47,10 +57,11 @@ export declare class UnixTimestampDateTimeAdapter extends DateTimeAdapter<number
     isSameDay(dateLeft: number, dateRight: number): boolean;
     isValid(date: number): boolean;
     now(): number;
+    parse(value: any, parseFormat: any): number | null;
     setHours(date: number, amount: number): number;
     setMinutes(date: number, amount: number): number;
     setSeconds(date: number, amount: number): number;
     toIso8601(date: number): string;
-    static ɵfac: i0.ɵɵFactoryDeclaration<UnixTimestampDateTimeAdapter, never>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<UnixTimestampDateTimeAdapter, [{ optional: true; }, null]>;
     static ɵprov: i0.ɵɵInjectableDeclaration<UnixTimestampDateTimeAdapter>;
 }

package/lib/date-time/adapter/unix-timestamp-adapter/unix-timestamp-date-time-format.class.d.ts

@@ -1,2 +1,5 @@
+/**
+ * unix-timestamp-date-time-format.class
+ */
 import { OwlDateTimeFormats } from '../date-time-format.class';
 export declare const OWL_UNIX_TIMESTAMP_DATE_TIME_FORMATS: OwlDateTimeFormats;

package/lib/date-time/calendar-body.component.d.ts

@@ -1,5 +1,8 @@
-import { EventEmitter } from '@angular/core';
-import { SelectMode } from '../types';
+/**
+ * calendar-body.component
+ */
+import { ElementRef, NgZone } from '@angular/core';
+import { SelectMode } from './date-time.class';
 import * as i0 from "@angular/core";
 export declare class CalendarCell {
     value: number;
@@ -11,8 +14,8 @@ export declare class CalendarCell {
     constructor(value: number, displayValue: string, ariaLabel: string, enabled: boolean, out?: boolean, cellClass?: string);
 }
 export declare class OwlCalendarBodyComponent {
-    private readonly elmRef;
-    private readonly ngZone;
+    private elmRef;
+    private ngZone;
     /**
      * The cell number of the active cell in the table.
      */
@@ -44,27 +47,29 @@ export declare class OwlCalendarBodyComponent {
     /**
      * Emit when a calendar cell is selected
      */
-    readonly select: EventEmitter<CalendarCell>;
-    protected get isInSingleMode(): boolean;
-    protected get isInRangeMode(): boolean;
-    protected selectCell(cell: CalendarCell): void;
-    protected isActiveCell(rowIndex: number, colIndex: number): boolean;
+    readonly select: import("@angular/core").OutputEmitterRef<CalendarCell>;
+    get owlDTCalendarBodyClass(): boolean;
+    get isInSingleMode(): boolean;
+    get isInRangeMode(): boolean;
+    constructor(elmRef: ElementRef, ngZone: NgZone);
+    selectCell(cell: CalendarCell): void;
+    isActiveCell(rowIndex: number, colIndex: number): boolean;
     /**
      * Check if the cell is selected
      */
-    protected isSelected(value: number): boolean;
+    isSelected(value: number): boolean;
     /**
      * Check if the cell in the range
      */
-    protected isInRange(value: number): boolean;
+    isInRange(value: number): boolean;
     /**
      * Check if the cell is the range from
      */
-    protected isRangeFrom(value: number): boolean;
+    isRangeFrom(value: number): boolean;
     /**
      * Check if the cell is the range to
      */
-    protected isRangeTo(value: number): boolean;
+    isRangeTo(value: number): boolean;
     /**
      * Focus to a active cell
      */

package/lib/date-time/calendar-month-view.component.d.ts

@@ -1,8 +1,8 @@
-import { AfterContentInit, ChangeDetectorRef, EventEmitter, OnDestroy, OnInit } from '@angular/core';
-import { SelectMode } from '../types';
+import { AfterContentInit, ChangeDetectorRef, OnDestroy, OnInit } from '@angular/core';
 import { DateTimeAdapter } from './adapter/date-time-adapter.class';
 import { OwlDateTimeFormats } from './adapter/date-time-format.class';
 import { CalendarCell, OwlCalendarBodyComponent } from './calendar-body.component';
+import { SelectMode } from './date-time.class';
 import * as i0 from "@angular/core";
 export declare class OwlMonthViewComponent<T> implements OnInit, AfterContentInit, OnDestroy {
     private cdRef;
@@ -51,16 +51,16 @@ export declare class OwlMonthViewComponent<T> implements OnInit, AfterContentIni
     get maxDate(): T | null;
     set maxDate(value: T | null);
     private _weekdays;
-    protected get weekdays(): Array<{
+    get weekdays(): {
         long: string;
         short: string;
         narrow: string;
-    }>;
+    }[];
     private _days;
-    protected get days(): Array<Array<CalendarCell>>;
-    protected get activeCell(): number;
-    protected get isInSingleMode(): boolean;
-    protected get isInRangeMode(): boolean;
+    get days(): CalendarCell[][];
+    get activeCell(): number;
+    get isInSingleMode(): boolean;
+    get isInRangeMode(): boolean;
     private firstDateOfMonth;
     private localeSub;
     private initiated;
@@ -78,11 +78,16 @@ export declare class OwlMonthViewComponent<T> implements OnInit, AfterContentIni
     /**
      * Callback to invoke when a new date is selected
      */
-    readonly selectedChange: EventEmitter<T>;
+    readonly selectedChange: import("@angular/core").OutputEmitterRef<T>;
+    /**
+     * Callback to invoke when any date is selected.
+     */
+    readonly userSelection: import("@angular/core").OutputEmitterRef<void>;
     /** Emits when any date is activated. */
-    readonly pickerMomentChange: EventEmitter<T>;
+    readonly pickerMomentChange: import("@angular/core").OutputEmitterRef<T>;
     /** The body of calendar table */
-    protected calendarBodyElm: OwlCalendarBodyComponent;
+    calendarBodyElm: OwlCalendarBodyComponent;
+    get owlDTCalendarView(): boolean;
     constructor(cdRef: ChangeDetectorRef, dateTimeAdapter: DateTimeAdapter<T>, dateTimeFormats: OwlDateTimeFormats);
     ngOnInit(): void;
     ngAfterContentInit(): void;
@@ -132,5 +137,5 @@ export declare class OwlMonthViewComponent<T> implements OnInit, AfterContentIni
     private setSelectedDates;
     private focusActiveCell;
     static ɵfac: i0.ɵɵFactoryDeclaration<OwlMonthViewComponent<any>, [null, { optional: true; }, { optional: true; }]>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<OwlMonthViewComponent<any>, "owl-date-time-month-view", ["owlYearView"], { "hideOtherMonths": { "alias": "hideOtherMonths"; "required": false; }; "firstDayOfWeek": { "alias": "firstDayOfWeek"; "required": false; }; "selectMode": { "alias": "selectMode"; "required": false; }; "selected": { "alias": "selected"; "required": false; }; "selecteds": { "alias": "selecteds"; "required": false; }; "pickerMoment": { "alias": "pickerMoment"; "required": false; }; "dateFilter": { "alias": "dateFilter"; "required": false; }; "minDate": { "alias": "minDate"; "required": false; }; "maxDate": { "alias": "maxDate"; "required": false; }; }, { "selectedChange": "selectedChange"; "pickerMomentChange": "pickerMomentChange"; }, never, never, false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<OwlMonthViewComponent<any>, "owl-date-time-month-view", ["owlYearView"], { "hideOtherMonths": { "alias": "hideOtherMonths"; "required": false; }; "firstDayOfWeek": { "alias": "firstDayOfWeek"; "required": false; }; "selectMode": { "alias": "selectMode"; "required": false; }; "selected": { "alias": "selected"; "required": false; }; "selecteds": { "alias": "selecteds"; "required": false; }; "pickerMoment": { "alias": "pickerMoment"; "required": false; }; "dateFilter": { "alias": "dateFilter"; "required": false; }; "minDate": { "alias": "minDate"; "required": false; }; "maxDate": { "alias": "maxDate"; "required": false; }; }, { "selectedChange": "selectedChange"; "userSelection": "userSelection"; "pickerMomentChange": "pickerMomentChange"; }, never, never, false, never>;
 }

package/lib/date-time/calendar-multi-year-view.component.d.ts

@@ -1,9 +1,8 @@
-import { AfterContentInit, ChangeDetectorRef, EventEmitter } from '@angular/core';
-import { SelectMode } from '../types';
+import { AfterContentInit, ChangeDetectorRef } from '@angular/core';
 import { DateTimeAdapter } from './adapter/date-time-adapter.class';
 import { CalendarCell, OwlCalendarBodyComponent } from './calendar-body.component';
 import { OwlDateTimeIntl } from './date-time-picker-intl.service';
-import { Options } from './options-provider';
+import { SelectMode } from './date-time.class';
 import * as i0 from "@angular/core";
 export declare class OwlMultiYearViewComponent<T> implements AfterContentInit {
     private cdRef;
@@ -24,7 +23,7 @@ export declare class OwlMultiYearViewComponent<T> implements AfterContentInit {
     get selecteds(): Array<T>;
     set selecteds(values: Array<T>);
     private _pickerMoment;
-    get pickerMoment(): T | null;
+    get pickerMoment(): T;
     set pickerMoment(value: T);
     /**
      * A function used to filter which dates are selectable
@@ -43,7 +42,7 @@ export declare class OwlMultiYearViewComponent<T> implements AfterContentInit {
     private _todayYear;
     get todayYear(): number;
     private _years;
-    get years(): Array<Array<CalendarCell>>;
+    get years(): CalendarCell[][];
     private _selectedYears;
     get selectedYears(): Array<number>;
     private initiated;
@@ -56,19 +55,20 @@ export declare class OwlMultiYearViewComponent<T> implements AfterContentInit {
     /**
      * Callback to invoke when a new month is selected
      */
-    readonly change: EventEmitter<T>;
+    readonly change: import("@angular/core").OutputEmitterRef<T>;
     /**
      * Emits the selected year. This doesn't imply a change on the selected date
      */
-    readonly yearSelected: EventEmitter<T>;
+    readonly yearSelected: import("@angular/core").OutputEmitterRef<T>;
     /** Emits when any date is activated. */
-    readonly pickerMomentChange: EventEmitter<T>;
+    readonly pickerMomentChange: import("@angular/core").OutputEmitterRef<T>;
     /** Emits when use keyboard enter to select a calendar cell */
-    readonly keyboardEnter: EventEmitter<KeyboardEvent>;
+    readonly keyboardEnter: import("@angular/core").OutputEmitterRef<void>;
     /** The body of calendar table */
     calendarBodyElm: OwlCalendarBodyComponent;
+    get owlDTCalendarView(): boolean;
     get owlDTCalendarMultiYearView(): boolean;
-    constructor(cdRef: ChangeDetectorRef, pickerIntl: OwlDateTimeIntl, dateTimeAdapter: DateTimeAdapter<T>, options: Options['multiYear']);
+    constructor(cdRef: ChangeDetectorRef, pickerIntl: OwlDateTimeIntl, dateTimeAdapter: DateTimeAdapter<T>, options: any);
     ngAfterContentInit(): void;
     /**
      * Handle a calendarCell selected
@@ -78,11 +78,11 @@ export declare class OwlMultiYearViewComponent<T> implements AfterContentInit {
     /**
      * Generate the previous year list
      */
-    prevYearList(event: MouseEvent): void;
+    prevYearList(event: any): void;
     /**
      * Generate the next year list
      */
-    nextYearList(event: MouseEvent): void;
+    nextYearList(event: any): void;
     generateYearList(): void;
     /** Whether the previous period button is enabled. */
     previousEnabled(): boolean;

package/lib/date-time/calendar-year-view.component.d.ts

@@ -1,8 +1,8 @@
-import { AfterContentInit, ChangeDetectorRef, EventEmitter, OnDestroy, OnInit } from '@angular/core';
-import { SelectMode } from '../types';
+import { AfterContentInit, ChangeDetectorRef, OnDestroy, OnInit } from '@angular/core';
 import { DateTimeAdapter } from './adapter/date-time-adapter.class';
 import { OwlDateTimeFormats } from './adapter/date-time-format.class';
 import { CalendarCell, OwlCalendarBodyComponent } from './calendar-body.component';
+import { SelectMode } from './date-time.class';
 import * as i0 from "@angular/core";
 export declare class OwlYearViewComponent<T> implements OnInit, AfterContentInit, OnDestroy {
     private cdRef;
@@ -55,17 +55,18 @@ export declare class OwlYearViewComponent<T> implements OnInit, AfterContentInit
     /**
      * Callback to invoke when a new month is selected
      */
-    readonly change: EventEmitter<T>;
+    readonly change: import("@angular/core").OutputEmitterRef<T>;
     /**
      * Emits the selected year. This doesn't imply a change on the selected date
      */
-    readonly monthSelected: EventEmitter<T>;
+    readonly monthSelected: import("@angular/core").OutputEmitterRef<T>;
     /** Emits when any date is activated. */
-    readonly pickerMomentChange: EventEmitter<T>;
+    readonly pickerMomentChange: import("@angular/core").OutputEmitterRef<T>;
     /** Emits when use keyboard enter to select a calendar cell */
-    readonly keyboardEnter: EventEmitter<any>;
+    readonly keyboardEnter: import("@angular/core").OutputEmitterRef<void>;
     /** The body of calendar table */
     calendarBodyElm: OwlCalendarBodyComponent;
+    get owlDTCalendarView(): boolean;
     constructor(cdRef: ChangeDetectorRef, dateTimeAdapter: DateTimeAdapter<T>, dateTimeFormats: OwlDateTimeFormats);
     ngOnInit(): void;
     ngAfterContentInit(): void;

package/lib/date-time/calendar.component.d.ts

@@ -1,8 +1,11 @@
-import { AfterContentInit, AfterViewChecked, ChangeDetectorRef, ElementRef, EventEmitter, NgZone, OnDestroy } from '@angular/core';
-import { DateView, SelectMode } from '../types';
+/**
+ * calendar.component
+ */
+import { AfterContentInit, AfterViewChecked, ChangeDetectorRef, ElementRef, NgZone, OnDestroy } from '@angular/core';
 import { DateTimeAdapter } from './adapter/date-time-adapter.class';
 import { OwlDateTimeFormats } from './adapter/date-time-format.class';
 import { OwlDateTimeIntl } from './date-time-picker-intl.service';
+import { DateView, DateViewType, SelectMode } from './date-time.class';
 import * as i0 from "@angular/core";
 export declare class OwlCalendarComponent<T> implements AfterContentInit, AfterViewChecked, OnDestroy {
     private elmRef;
@@ -11,7 +14,7 @@ export declare class OwlCalendarComponent<T> implements AfterContentInit, AfterV
     private cdRef;
     private dateTimeAdapter;
     private dateTimeFormats;
-    protected readonly DateView: typeof DateView;
+    DateView: typeof DateView;
     get minDate(): T | null;
     set minDate(value: T | null);
     get maxDate(): T | null;
@@ -24,10 +27,11 @@ export declare class OwlCalendarComponent<T> implements AfterContentInit, AfterV
     set selecteds(values: Array<T>);
     get periodButtonText(): string;
     get periodButtonLabel(): string;
+    get todayButtonLabel(): string;
     get prevButtonLabel(): string;
     get nextButtonLabel(): string;
-    get currentView(): DateView;
-    set currentView(view: DateView);
+    get currentView(): DateViewType;
+    set currentView(view: DateViewType);
     get isInSingleMode(): boolean;
     get isInRangeMode(): boolean;
     get showControlArrows(): boolean;
@@ -58,7 +62,7 @@ export declare class OwlCalendarComponent<T> implements AfterContentInit, AfterV
     /**
      * The view that the calendar should start in.
      */
-    startView: DateView;
+    startView: DateViewType;
     /**
      * Whether to should only the year and multi-year views.
      */
@@ -71,20 +75,34 @@ export declare class OwlCalendarComponent<T> implements AfterContentInit, AfterV
      * Whether to hide dates in other months at the start or end of the current month.
      */
     hideOtherMonths: boolean;
-    /** Emits when the currently picker moment changes. */
-    pickerMomentChange: EventEmitter<T>;
-    /** Emits when the selected date changes. */
-    readonly dateClicked: EventEmitter<T>;
-    /** Emits when the currently selected date changes. */
-    readonly selectedChange: EventEmitter<T>;
+    /**
+     * Flag to show today button to jump to today's date. Defaults to `false`.
+     */
+    showTodayButton: boolean;
+    /**
+     * Emits when the currently picker moment changes.
+     */
+    readonly pickerMomentChange: import("@angular/core").OutputEmitterRef<T>;
+    /**
+     * Emits when the selected date changes.
+     */
+    readonly dateClicked: import("@angular/core").OutputEmitterRef<T>;
+    /**
+     * Emits when the currently selected date changes.
+     */
+    readonly selectedChange: import("@angular/core").OutputEmitterRef<T>;
+    /**
+     * Emits when any date is selected.
+     */
+    readonly userSelection: import("@angular/core").OutputEmitterRef<void>;
     /**
      * Emits the selected year. This doesn't imply a change on the selected date
      */
-    readonly yearSelected: EventEmitter<T>;
+    readonly yearSelected: import("@angular/core").OutputEmitterRef<T>;
     /**
      * Emits the selected month. This doesn't imply a change on the selected date
      */
-    readonly monthSelected: EventEmitter<T>;
+    readonly monthSelected: import("@angular/core").OutputEmitterRef<T>;
     private _currentView;
     private intlChangesSub;
     /**
@@ -96,7 +114,7 @@ export declare class OwlCalendarComponent<T> implements AfterContentInit, AfterV
     /**
      * Date filter for the month and year view
      */
-    dateFilterForViews: (date: T) => boolean;
+    dateFilterForViews: (date: T | null) => boolean;
     ngAfterContentInit(): void;
     ngAfterViewChecked(): void;
     ngOnDestroy(): void;
@@ -112,15 +130,17 @@ export declare class OwlCalendarComponent<T> implements AfterContentInit, AfterV
      * Handles user clicks on the next button.
      */
     nextClicked(): void;
+    jumpToToday(): void;
     dateSelected(date: T): void;
     /**
      * Change the pickerMoment value and switch to a specific view
      */
-    goToDateInView(date: T, view: DateView): void;
+    goToDateInView(date: T, view: DateViewType): void;
     /**
      * Change the pickerMoment value
      */
     handlePickerMomentChange(date: T): void;
+    userSelected(): void;
     /**
      * Whether the previous period button is enabled.
      */
@@ -144,5 +164,5 @@ export declare class OwlCalendarComponent<T> implements AfterContentInit, AfterV
      */
     private getValidDate;
     static ɵfac: i0.ɵɵFactoryDeclaration<OwlCalendarComponent<any>, [null, null, null, null, { optional: true; }, { optional: true; }]>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<OwlCalendarComponent<any>, "owl-date-time-calendar", ["owlDateTimeCalendar"], { "minDate": { "alias": "minDate"; "required": false; }; "maxDate": { "alias": "maxDate"; "required": false; }; "pickerMoment": { "alias": "pickerMoment"; "required": false; }; "selected": { "alias": "selected"; "required": false; }; "selecteds": { "alias": "selecteds"; "required": false; }; "dateFilter": { "alias": "dateFilter"; "required": false; }; "firstDayOfWeek": { "alias": "firstDayOfWeek"; "required": false; }; "selectMode": { "alias": "selectMode"; "required": false; }; "startView": { "alias": "startView"; "required": false; }; "yearOnly": { "alias": "yearOnly"; "required": false; }; "multiyearOnly": { "alias": "multiyearOnly"; "required": false; }; "hideOtherMonths": { "alias": "hideOtherMonths"; "required": false; }; }, { "pickerMomentChange": "pickerMomentChange"; "dateClicked": "dateClicked"; "selectedChange": "selectedChange"; "yearSelected": "yearSelected"; "monthSelected": "monthSelected"; }, never, never, false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<OwlCalendarComponent<any>, "owl-date-time-calendar", ["owlDateTimeCalendar"], { "minDate": { "alias": "minDate"; "required": false; }; "maxDate": { "alias": "maxDate"; "required": false; }; "pickerMoment": { "alias": "pickerMoment"; "required": false; }; "selected": { "alias": "selected"; "required": false; }; "selecteds": { "alias": "selecteds"; "required": false; }; "dateFilter": { "alias": "dateFilter"; "required": false; }; "firstDayOfWeek": { "alias": "firstDayOfWeek"; "required": false; }; "selectMode": { "alias": "selectMode"; "required": false; }; "startView": { "alias": "startView"; "required": false; }; "yearOnly": { "alias": "yearOnly"; "required": false; }; "multiyearOnly": { "alias": "multiyearOnly"; "required": false; }; "hideOtherMonths": { "alias": "hideOtherMonths"; "required": false; }; "showTodayButton": { "alias": "showTodayButton"; "required": false; }; }, { "pickerMomentChange": "pickerMomentChange"; "dateClicked": "dateClicked"; "selectedChange": "selectedChange"; "userSelection": "userSelection"; "yearSelected": "yearSelected"; "monthSelected": "monthSelected"; }, never, never, false, never>;
 }