primeng 16.0.0-rc.1 → 16.0.0-rc.2

package/calendar/calendar.d.ts

@@ -1,9 +1,11 @@
 import { AnimationEvent } from '@angular/animations';
 import { ChangeDetectorRef, ElementRef, EventEmitter, NgZone, OnDestroy, OnInit, QueryList, Renderer2, TemplateRef } from '@angular/core';
 import { ControlValueAccessor } from '@angular/forms';
-import { OverlayService, PrimeNGConfig } from 'primeng/api';
+import { OverlayService, PrimeNGConfig, PrimeTemplate } from 'primeng/api';
 import { ConnectedOverlayScrollHandler } from 'primeng/dom';
 import { Subscription } from 'rxjs';
+import { Nullable, VoidListener } from 'primeng/ts-helpers';
+import { NavigationState, CalendarResponsiveOptions, CalendarTypeView, LocaleSettings, Month, CalendarMonthChangeEvent, CalendarYearChangeEvent } from './calendar.interface';
 import * as i0 from "@angular/core";
 import * as i1 from "@angular/common";
 import * as i2 from "primeng/button";
@@ -16,19 +18,6 @@ import * as i8 from "primeng/icons/chevrondown";
 import * as i9 from "primeng/icons/times";
 import * as i10 from "primeng/icons/calendar";
 export declare const CALENDAR_VALUE_ACCESSOR: any;
-export interface LocaleSettings {
-    firstDayOfWeek?: number;
-    dayNames?: string[];
-    dayNamesShort?: string[];
-    dayNamesMin?: string[];
-    monthNames?: string[];
-    monthNamesShort?: string[];
-    today?: string;
-    clear?: string;
-    dateFormat?: string;
-    weekHeader?: string;
-}
-export type CalendarTypeView = 'date' | 'month' | 'year';
 export declare class Calendar implements OnInit, OnDestroy, ControlValueAccessor {
     private document;
     el: ElementRef;
@@ -37,179 +26,490 @@ export declare class Calendar implements OnInit, OnDestroy, ControlValueAccessor
     private zone;
     private config;
     overlayService: OverlayService;
-    style: any;
-    styleClass: string;
-    inputStyle: any;
-    inputId: string;
-    name: string;
-    inputStyleClass: string;
-    placeholder: string;
-    ariaLabelledBy: string;
-    iconAriaLabel: string;
-    disabled: any;
-    dateFormat: string;
+    /**
+     * Inline style of the component.
+     * @group Props
+     */
+    style: {
+        [klass: string]: any;
+    } | null | undefined;
+    /**
+     * Style class of the component.
+     * @group Props
+     */
+    styleClass: string | undefined;
+    /**
+     * Inline style of the input field.
+     * @group Props
+     */
+    inputStyle: {
+        [klass: string]: any;
+    } | null | undefined;
+    /**
+     * Identifier of the focus input to match a label defined for the component.
+     * @group Props
+     */
+    inputId: string | undefined;
+    /**
+     * Name of the input element.
+     * @group Props
+     */
+    name: string | undefined;
+    /**
+     * Style class of the input field.
+     * @group Props
+     */
+    inputStyleClass: string | undefined;
+    /**
+     * Placeholder text for the input.
+     * @group Props
+     */
+    placeholder: string | undefined;
+    /**
+     * Establishes relationships between the component and label(s) where its value should be one or more element IDs.
+     * @group Props
+     */
+    ariaLabelledBy: string | undefined;
+    /**
+     * Defines a string that labels the icon button for accessibility.
+     * @group Props
+     */
+    iconAriaLabel: string | undefined;
+    /**
+     * When specified, disables the component.
+     * @group Props
+     */
+    disabled: boolean | undefined;
+    /**
+     * Format of the date which can also be defined at locale settings.
+     * @group Props
+     */
+    dateFormat: string | undefined;
+    /**
+     * Separator for multiple selection mode.
+     * @group Props
+     */
     multipleSeparator: string;
+    /**
+     * Separator for joining start and end dates on range selection mode.
+     * @group Props
+     */
     rangeSeparator: string;
+    /**
+     * When enabled, displays the calendar as inline. Default is false for popup mode.
+     * @group Props
+     */
     inline: boolean;
+    /**
+     * Whether to display dates in other months (non-selectable) at the start or end of the current month. To make these days selectable use the selectOtherMonths option.
+     * @group Props
+     */
     showOtherMonths: boolean;
-    selectOtherMonths: boolean;
-    showIcon: boolean;
-    icon: string;
-    appendTo: any;
-    readonlyInput: boolean;
+    /**
+     * Whether days in other months shown before or after the current month are selectable. This only applies if the showOtherMonths option is set to true.
+     * @group Props
+     */
+    selectOtherMonths: boolean | undefined;
+    /**
+     * When enabled, displays a button with icon next to input.
+     * @group Props
+     */
+    showIcon: boolean | undefined;
+    /**
+     * Icon of the calendar button.
+     * @group Props
+     */
+    icon: string | undefined;
+    /**
+     * Target element to attach the overlay, valid values are "body" or a local ng-template variable of another element (note: use binding with brackets for template variables, e.g. [appendTo]="mydiv" for a div element having#mydiv as variable name).
+     * @group Props
+     */
+    appendTo: HTMLElement | ElementRef | TemplateRef<any> | string | null | undefined | any;
+    /**
+     * When specified, prevents entering the date manually with keyboard.
+     * @group Props
+     */
+    readonlyInput: boolean | undefined;
+    /**
+     * The cutoff year for determining the century for a date.
+     * @group Props
+     */
     shortYearCutoff: any;
-    monthNavigator: boolean;
-    yearNavigator: boolean;
+    /**
+     * Whether the month should be rendered as a dropdown instead of text.
+     * @deprecated Navigator is always on
+     * @group Props
+     */
+    monthNavigator: boolean | undefined;
+    /**
+     * Whether the year should be rendered as a dropdown instead of text.
+     * @deprecated  Navigator is always on.
+     * @group Props
+     */
+    yearNavigator: boolean | undefined;
+    /**
+     * Specifies 12 or 24 hour format.
+     * @group Props
+     */
     hourFormat: string;
-    timeOnly: boolean;
+    /**
+     * Whether to display timepicker only.
+     * @group Props
+     */
+    timeOnly: boolean | undefined;
+    /**
+     * Hours to change per step.
+     * @group Props
+     */
     stepHour: number;
+    /**
+     * Minutes to change per step.
+     * @group Props
+     */
     stepMinute: number;
+    /**
+     * Seconds to change per step.
+     * @group Props
+     */
     stepSecond: number;
+    /**
+     * Whether to show the seconds in time picker.
+     * @group Props
+     */
     showSeconds: boolean;
-    required: boolean;
+    /**
+     * When present, it specifies that an input field must be filled out before submitting the form.
+     * @group Props
+     */
+    required: boolean | undefined;
+    /**
+     * When disabled, datepicker will not be visible with input focus.
+     * @group Props
+     */
     showOnFocus: boolean;
+    /**
+     * When enabled, calendar will show week numbers.
+     * @group Props
+     */
     showWeek: boolean;
+    /**
+     * When enabled, a clear icon is displayed to clear the value.
+     * @group Props
+     */
     showClear: boolean;
+    /**
+     * Type of the value to write back to ngModel, default is date and alternative is string.
+     * @group Props
+     */
     dataType: string;
-    selectionMode: string;
-    maxDateCount: number;
-    showButtonBar: boolean;
+    /**
+     * Defines the quantity of the selection, valid values are "single", "multiple" and "range".
+     * @group Props
+     */
+    selectionMode: 'single' | 'multiple' | 'range' | undefined;
+    /**
+     * Maximum number of selectable dates in multiple mode.
+     * @group Props
+     */
+    maxDateCount: number | undefined;
+    /**
+     * Whether to display today and clear buttons at the footer
+     * @group Props
+     */
+    showButtonBar: boolean | undefined;
+    /**
+     * Style class of the today button.
+     * @group Props
+     */
     todayButtonStyleClass: string;
+    /**
+     * Style class of the clear button.
+     * @group Props
+     */
     clearButtonStyleClass: string;
+    /**
+     * Whether to automatically manage layering.
+     * @group Props
+     */
     autoZIndex: boolean;
+    /**
+     * Base zIndex value to use in layering.
+     * @group Props
+     */
     baseZIndex: number;
-    panelStyleClass: string;
+    /**
+     * Style class of the datetimepicker container element.
+     * @group Props
+     */
+    panelStyleClass: string | undefined;
+    /**
+     * Inline style of the datetimepicker container element.
+     * @group Props
+     */
     panelStyle: any;
+    /**
+     * Keep invalid value when input blur.
+     * @group Props
+     */
     keepInvalid: boolean;
+    /**
+     * Whether to hide the overlay on date selection.
+     * @group Props
+     */
     hideOnDateTimeSelect: boolean;
-    touchUI: boolean;
+    /**
+     * When enabled, calendar overlay is displayed as optimized for touch devices.
+     * @group Props
+     */
+    touchUI: boolean | undefined;
+    /**
+     * Separator of time selector.
+     * @group Props
+     */
     timeSeparator: string;
+    /**
+     * When enabled, can only focus on elements inside the calendar.
+     * @group Props
+     */
     focusTrap: boolean;
+    /**
+     * Transition options of the show animation.
+     * @group Props
+     */
     showTransitionOptions: string;
+    /**
+     * Transition options of the hide animation.
+     * @group Props
+     */
     hideTransitionOptions: string;
-    onFocus: EventEmitter<any>;
-    onBlur: EventEmitter<any>;
-    onClose: EventEmitter<any>;
-    onSelect: EventEmitter<any>;
+    /**
+     * Index of the element in tabbing order.
+     * @group Props
+     */
+    tabindex: number | undefined;
+    /**
+     * The minimum selectable date.
+     * @group Props
+     */
+    get minDate(): Date;
+    set minDate(date: Date);
+    /**
+     * The maximum selectable date.
+     * @group Props
+     */
+    get maxDate(): Date;
+    set maxDate(date: Date);
+    /**
+     * Array with dates that should be disabled (not selectable).
+     * @group Props
+     */
+    get disabledDates(): Date[];
+    set disabledDates(disabledDates: Date[]);
+    /**
+     * Array with weekday numbers that should be disabled (not selectable).
+     * @group Props
+     */
+    get disabledDays(): number[];
+    set disabledDays(disabledDays: number[]);
+    /**
+     * @deprecated Years are based on decades by default.
+     * The range of years displayed in the year drop-down in (nnnn:nnnn) format such as (2000:2020).
+     * @group Props
+     */
+    get yearRange(): string;
+    set yearRange(yearRange: string);
+    /**
+     * Whether to display timepicker.
+     * @group Props
+     */
+    get showTime(): boolean;
+    set showTime(showTime: boolean);
+    /**
+     * An array of options for responsive design.
+     * @group Props
+     */
+    get responsiveOptions(): CalendarResponsiveOptions[];
+    set responsiveOptions(responsiveOptions: CalendarResponsiveOptions[]);
+    /**
+     * Number of months to display.
+     * @group Props
+     */
+    get numberOfMonths(): number;
+    set numberOfMonths(numberOfMonths: number);
+    /**
+     * Defines the first of the week for various date calculations.
+     * @group Props
+     */
+    get firstDayOfWeek(): number;
+    set firstDayOfWeek(firstDayOfWeek: number);
+    /**
+     * No description available.
+     * @group Props
+     */
+    set locale(newLocale: LocaleSettings);
+    /**
+     * Type of view to display, valid values are "date" for datepicker and "month" for month picker.
+     * @group Props
+     */
+    get view(): CalendarTypeView;
+    set view(view: CalendarTypeView);
+    /**
+     * Set the date to highlight on first opening if the field is blank.
+     * @group Props
+     */
+    get defaultDate(): Date;
+    set defaultDate(defaultDate: Date);
+    /**
+     * Callback to invoke on focus of input field.
+     * @param {Event} event - browser event.
+     * @group Emits
+     */
+    onFocus: EventEmitter<Event>;
+    /**
+     * Callback to invoke on blur of input field.
+     * @param {Event} event - browser event.
+     * @group Emits
+     */
+    onBlur: EventEmitter<Event>;
+    /**
+     * Callback to invoke when date panel closed.
+     * @param {Event} event - Mouse event
+     * @group Emits
+     */
+    onClose: EventEmitter<AnimationEvent>;
+    /**
+     * Callback to invoke on date select.
+     * @param {Date} date - date value.
+     * @group Emits
+     */
+    onSelect: EventEmitter<Date>;
+    /**
+     * Callback to invoke when input field cleared.
+     * @group Emits
+     */
     onClear: EventEmitter<any>;
+    /**
+     * Callback to invoke when input field is being typed.
+     * @param {Event} event - browser event
+     * @group Emits
+     */
     onInput: EventEmitter<any>;
+    /**
+     * Callback to invoke when today button is clicked.
+     * @param {Date} date - today as a date instance.
+     * @group Emits
+     */
     onTodayClick: EventEmitter<any>;
+    /**
+     * Callback to invoke when clear button is clicked.
+     * @param {Event} event - browser event.
+     * @group Emits
+     */
     onClearClick: EventEmitter<any>;
-    onMonthChange: EventEmitter<any>;
-    onYearChange: EventEmitter<any>;
+    /**
+     * Callback to invoke when a month is changed using the navigators.
+     * @param {CalendarMonthChangeEvent} event - custom month change event.
+     * @group Emits
+     */
+    onMonthChange: EventEmitter<CalendarMonthChangeEvent>;
+    /**
+     * Callback to invoke when a year is changed using the navigators.
+     * @param {CalendarYearChangeEvent} event - custom year change event.
+     * @group Emits
+     */
+    onYearChange: EventEmitter<CalendarYearChangeEvent>;
+    /**
+     * Callback to invoke when clicked outside of the date panel.
+     * @group Emits
+     */
     onClickOutside: EventEmitter<any>;
+    /**
+     * Callback to invoke when datepicker panel is shown.
+     * @group Emits
+     */
     onShow: EventEmitter<any>;
-    templates: QueryList<any>;
-    tabindex: number;
-    containerViewChild: ElementRef;
-    inputfieldViewChild: ElementRef;
+    templates: QueryList<PrimeTemplate>;
+    containerViewChild: Nullable<ElementRef>;
+    inputfieldViewChild: Nullable<ElementRef>;
     set content(content: ElementRef);
     contentViewChild: ElementRef;
     value: any;
-    dates: any[];
-    months: any[];
-    weekDays: string[];
+    dates: Nullable<Date[]>;
+    months: Month[];
+    weekDays: Nullable<string[]>;
     currentMonth: number;
     currentYear: number;
-    currentHour: number;
-    currentMinute: number;
-    currentSecond: number;
-    pm: boolean;
-    mask: HTMLDivElement;
-    maskClickListener: VoidFunction | null;
-    overlay: HTMLDivElement;
-    responsiveStyleElement: any;
-    overlayVisible: boolean;
+    currentHour: Nullable<number>;
+    currentMinute: Nullable<number>;
+    currentSecond: Nullable<number>;
+    pm: Nullable<boolean>;
+    mask: Nullable<HTMLDivElement>;
+    maskClickListener: VoidListener;
+    overlay: Nullable<HTMLDivElement>;
+    responsiveStyleElement: HTMLStyleElement | undefined | null;
+    overlayVisible: Nullable<boolean>;
     onModelChange: Function;
     onModelTouched: Function;
-    calendarElement: any;
+    calendarElement: Nullable<HTMLElement | ElementRef>;
     timePickerTimer: any;
-    documentClickListener: VoidFunction | null;
-    animationEndListener: VoidFunction | null;
-    ticksTo1970: number;
-    yearOptions: number[];
-    focus: boolean;
-    isKeydown: boolean;
-    filled: boolean;
-    inputFieldValue: string;
+    documentClickListener: VoidListener;
+    animationEndListener: VoidListener;
+    ticksTo1970: Nullable<number>;
+    yearOptions: Nullable<number[]>;
+    focus: Nullable<boolean>;
+    isKeydown: Nullable<boolean>;
+    filled: Nullable<boolean>;
+    inputFieldValue: Nullable<string>;
     _minDate: Date;
     _maxDate: Date;
     _showTime: boolean;
     _yearRange: string;
-    preventDocumentListener: boolean;
-    dateTemplate: TemplateRef<any>;
-    headerTemplate: TemplateRef<any>;
-    footerTemplate: TemplateRef<any>;
-    disabledDateTemplate: TemplateRef<any>;
-    decadeTemplate: TemplateRef<any>;
-    previousIconTemplate: TemplateRef<any>;
-    nextIconTemplate: TemplateRef<any>;
-    triggerIconTemplate: TemplateRef<any>;
-    clearIconTemplate: TemplateRef<any>;
-    decrementIconTemplate: TemplateRef<any>;
-    incrementIconTemplate: TemplateRef<any>;
+    preventDocumentListener: Nullable<boolean>;
+    dateTemplate: Nullable<TemplateRef<any>>;
+    headerTemplate: Nullable<TemplateRef<any>>;
+    footerTemplate: Nullable<TemplateRef<any>>;
+    disabledDateTemplate: Nullable<TemplateRef<any>>;
+    decadeTemplate: Nullable<TemplateRef<any>>;
+    previousIconTemplate: Nullable<TemplateRef<any>>;
+    nextIconTemplate: Nullable<TemplateRef<any>>;
+    triggerIconTemplate: Nullable<TemplateRef<any>>;
+    clearIconTemplate: Nullable<TemplateRef<any>>;
+    decrementIconTemplate: Nullable<TemplateRef<any>>;
+    incrementIconTemplate: Nullable<TemplateRef<any>>;
     _disabledDates: Array<Date>;
     _disabledDays: Array<number>;
-    selectElement: any;
-    todayElement: any;
-    focusElement: any;
-    scrollHandler: ConnectedOverlayScrollHandler | null;
-    documentResizeListener: VoidFunction | null;
-    navigationState: any;
-    isMonthNavigate: boolean;
-    initialized: boolean;
-    translationSubscription: Subscription;
+    selectElement: Nullable;
+    todayElement: Nullable;
+    focusElement: Nullable;
+    scrollHandler: Nullable<ConnectedOverlayScrollHandler>;
+    documentResizeListener: VoidListener;
+    navigationState: Nullable<NavigationState>;
+    isMonthNavigate: Nullable<boolean>;
+    initialized: Nullable<boolean>;
+    translationSubscription: Nullable<Subscription>;
     _locale: LocaleSettings;
-    _responsiveOptions: any[];
-    currentView: string;
-    attributeSelector: string;
+    _responsiveOptions: CalendarResponsiveOptions[];
+    currentView: Nullable<string>;
+    attributeSelector: Nullable<string>;
     _numberOfMonths: number;
     _firstDayOfWeek: number;
     _view: CalendarTypeView;
-    preventFocus: boolean;
-    get view(): CalendarTypeView;
-    set view(view: CalendarTypeView);
-    get defaultDate(): Date;
-    set defaultDate(defaultDate: Date);
+    preventFocus: Nullable<boolean>;
     _defaultDate: Date;
-    get minDate(): Date;
-    set minDate(date: Date);
-    get maxDate(): Date;
-    set maxDate(date: Date);
-    get disabledDates(): Date[];
-    set disabledDates(disabledDates: Date[]);
-    get disabledDays(): number[];
-    set disabledDays(disabledDays: number[]);
-    get yearRange(): string;
-    set yearRange(yearRange: string);
-    get showTime(): boolean;
-    set showTime(showTime: boolean);
-    get locale(): LocaleSettings;
-    get responsiveOptions(): any[];
-    set responsiveOptions(responsiveOptions: any[]);
-    get numberOfMonths(): number;
-    set numberOfMonths(numberOfMonths: number);
-    get firstDayOfWeek(): number;
-    set firstDayOfWeek(firstDayOfWeek: number);
-    set locale(newLocale: LocaleSettings);
     private window;
+    get locale(): LocaleSettings;
     constructor(document: Document, el: ElementRef, renderer: Renderer2, cd: ChangeDetectorRef, zone: NgZone, config: PrimeNGConfig, overlayService: OverlayService);
     ngOnInit(): void;
     ngAfterContentInit(): void;
     ngAfterViewInit(): void;
     getTranslation(option: string): any;
-    populateYearOptions(start: any, end: any): void;
+    populateYearOptions(start: number, end: number): void;
     createWeekDays(): void;
     monthPickerValues(): any[];
     yearPickerValues(): any[];
     createMonths(month: number, year: number): void;
     getWeekNumber(date: Date): number;
-    createMonth(month: number, year: number): {
-        month: number;
-        year: number;
-        dates: any[];
-        weekNumbers: any[];
-    };
+    createMonth(month: number, year: number): Month;
     initTime(date: Date): void;
     navBackward(event: any): void;
     navForward(event: any): void;
@@ -217,12 +517,12 @@ export declare class Calendar implements OnInit, OnDestroy, ControlValueAccessor
     decrementDecade(): void;
     incrementDecade(): void;
     incrementYear(): void;
-    switchToMonthView(event: any): void;
-    switchToYearView(event: any): void;
-    onDateSelect(event: any, dateMeta: any): void;
+    switchToMonthView(event: Event): void;
+    switchToYearView(event: Event): void;
+    onDateSelect(event: Event, dateMeta: any): void;
     shouldSelectDate(dateMeta: any): boolean;
-    onMonthSelect(event: any, index: any): void;
-    onYearSelect(event: any, year: any): void;
+    onMonthSelect(event: Event, index: number): void;
+    onYearSelect(event: Event, year: number): void;
     updateInputfield(): void;
     formatDateTime(date: any): any;
     setCurrentHourPM(hours: number): void;
@@ -241,37 +541,37 @@ export declare class Calendar implements OnInit, OnDestroy, ControlValueAccessor
         year: any;
     };
     getSundayIndex(): number;
-    isSelected(dateMeta: any): boolean;
+    isSelected(dateMeta: any): boolean | undefined;
     isComparable(): boolean;
-    isMonthSelected(month: any): boolean;
-    isMonthDisabled(month: any): boolean;
-    isYearSelected(year: any): boolean;
+    isMonthSelected(month: number): boolean;
+    isMonthDisabled(month: number): boolean;
+    isYearSelected(year: number): boolean;
     isDateEquals(value: any, dateMeta: any): boolean;
-    isDateBetween(start: any, end: any, dateMeta: any): boolean;
+    isDateBetween(start: Date, end: Date, dateMeta: any): boolean;
     isSingleSelection(): boolean;
     isRangeSelection(): boolean;
     isMultipleSelection(): boolean;
-    isToday(today: any, day: any, month: any, year: any): boolean;
+    isToday(today: Date, day: number, month: number, year: number): boolean;
     isSelectable(day: any, month: any, year: any, otherMonth: any): boolean;
     isDateDisabled(day: number, month: number, year: number): boolean;
     isDayDisabled(day: number, month: number, year: number): boolean;
     onInputFocus(event: Event): void;
     onInputClick(): void;
     onInputBlur(event: Event): void;
-    onButtonClick(event: any, inputfield: any): void;
+    onButtonClick(event: Event, inputfield: any): void;
     clear(): void;
-    onOverlayClick(event: any): void;
-    getMonthName(index: any): any;
+    onOverlayClick(event: Event): void;
+    getMonthName(index: number): any;
     getYear(month: any): any;
-    switchViewButtonDisabled(): any;
-    onPrevButtonClick(event: any): void;
-    onNextButtonClick(event: any): void;
-    onContainerButtonKeydown(event: any): void;
+    switchViewButtonDisabled(): boolean;
+    onPrevButtonClick(event: Event): void;
+    onNextButtonClick(event: Event): void;
+    onContainerButtonKeydown(event: KeyboardEvent): void;
     onInputKeydown(event: any): void;
-    onDateCellKeydown(event: any, date: any, groupIndex: any): void;
-    onMonthCellKeydown(event: any, index: any): void;
-    onYearCellKeydown(event: any, index: any): void;
-    navigateToMonth(prev: any, groupIndex: any): void;
+    onDateCellKeydown(event: any, date: Date, groupIndex: number): void;
+    onMonthCellKeydown(event: any, index: number): void;
+    onYearCellKeydown(event: any, index: number): void;
+    navigateToMonth(prev: any, groupIndex: number): void;
     updateFocus(): void;
     initFocusableCell(): void;
     trapFocus(event: any): void;
@@ -283,7 +583,7 @@ export declare class Calendar implements OnInit, OnDestroy, ControlValueAccessor
     onTimePickerElementMouseDown(event: Event, type: number, direction: number): void;
     onTimePickerElementMouseUp(event: Event): void;
     onTimePickerElementMouseLeave(): void;
-    repeat(event: Event, interval: number, type: number, direction: number): void;
+    repeat(event: Event | null, interval: number | null, type: number | null, direction: number | null): void;
     clearTimePickerTimer(): void;
     decrementHour(event: any): void;
     incrementMinute(event: any): void;
@@ -292,9 +592,9 @@ export declare class Calendar implements OnInit, OnDestroy, ControlValueAccessor
     decrementSecond(event: any): void;
     updateTime(): void;
     toggleAMPM(event: any): void;
-    onUserInput(event: any): void;
+    onUserInput(event: KeyboardEvent | any): void;
     isValidSelection(value: any): boolean;
-    parseValueFromString(text: string): Date | Date[];
+    parseValueFromString(text: string): Date | Date[] | null;
     parseDateTime(text: any): Date;
     populateTime(value: any, timeString: any, ampm: any): void;
     isValidDate(date: any): boolean;
@@ -344,7 +644,7 @@ export declare class Calendar implements OnInit, OnDestroy, ControlValueAccessor
     onOverlayHide(): void;
     ngOnDestroy(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<Calendar, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<Calendar, "p-calendar", never, { "style": { "alias": "style"; "required": false; }; "styleClass": { "alias": "styleClass"; "required": false; }; "inputStyle": { "alias": "inputStyle"; "required": false; }; "inputId": { "alias": "inputId"; "required": false; }; "name": { "alias": "name"; "required": false; }; "inputStyleClass": { "alias": "inputStyleClass"; "required": false; }; "placeholder": { "alias": "placeholder"; "required": false; }; "ariaLabelledBy": { "alias": "ariaLabelledBy"; "required": false; }; "iconAriaLabel": { "alias": "iconAriaLabel"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "dateFormat": { "alias": "dateFormat"; "required": false; }; "multipleSeparator": { "alias": "multipleSeparator"; "required": false; }; "rangeSeparator": { "alias": "rangeSeparator"; "required": false; }; "inline": { "alias": "inline"; "required": false; }; "showOtherMonths": { "alias": "showOtherMonths"; "required": false; }; "selectOtherMonths": { "alias": "selectOtherMonths"; "required": false; }; "showIcon": { "alias": "showIcon"; "required": false; }; "icon": { "alias": "icon"; "required": false; }; "appendTo": { "alias": "appendTo"; "required": false; }; "readonlyInput": { "alias": "readonlyInput"; "required": false; }; "shortYearCutoff": { "alias": "shortYearCutoff"; "required": false; }; "monthNavigator": { "alias": "monthNavigator"; "required": false; }; "yearNavigator": { "alias": "yearNavigator"; "required": false; }; "hourFormat": { "alias": "hourFormat"; "required": false; }; "timeOnly": { "alias": "timeOnly"; "required": false; }; "stepHour": { "alias": "stepHour"; "required": false; }; "stepMinute": { "alias": "stepMinute"; "required": false; }; "stepSecond": { "alias": "stepSecond"; "required": false; }; "showSeconds": { "alias": "showSeconds"; "required": false; }; "required": { "alias": "required"; "required": false; }; "showOnFocus": { "alias": "showOnFocus"; "required": false; }; "showWeek": { "alias": "showWeek"; "required": false; }; "showClear": { "alias": "showClear"; "required": false; }; "dataType": { "alias": "dataType"; "required": false; }; "selectionMode": { "alias": "selectionMode"; "required": false; }; "maxDateCount": { "alias": "maxDateCount"; "required": false; }; "showButtonBar": { "alias": "showButtonBar"; "required": false; }; "todayButtonStyleClass": { "alias": "todayButtonStyleClass"; "required": false; }; "clearButtonStyleClass": { "alias": "clearButtonStyleClass"; "required": false; }; "autoZIndex": { "alias": "autoZIndex"; "required": false; }; "baseZIndex": { "alias": "baseZIndex"; "required": false; }; "panelStyleClass": { "alias": "panelStyleClass"; "required": false; }; "panelStyle": { "alias": "panelStyle"; "required": false; }; "keepInvalid": { "alias": "keepInvalid"; "required": false; }; "hideOnDateTimeSelect": { "alias": "hideOnDateTimeSelect"; "required": false; }; "touchUI": { "alias": "touchUI"; "required": false; }; "timeSeparator": { "alias": "timeSeparator"; "required": false; }; "focusTrap": { "alias": "focusTrap"; "required": false; }; "showTransitionOptions": { "alias": "showTransitionOptions"; "required": false; }; "hideTransitionOptions": { "alias": "hideTransitionOptions"; "required": false; }; "tabindex": { "alias": "tabindex"; "required": false; }; "view": { "alias": "view"; "required": false; }; "defaultDate": { "alias": "defaultDate"; "required": false; }; "minDate": { "alias": "minDate"; "required": false; }; "maxDate": { "alias": "maxDate"; "required": false; }; "disabledDates": { "alias": "disabledDates"; "required": false; }; "disabledDays": { "alias": "disabledDays"; "required": false; }; "yearRange": { "alias": "yearRange"; "required": false; }; "showTime": { "alias": "showTime"; "required": false; }; "responsiveOptions": { "alias": "responsiveOptions"; "required": false; }; "numberOfMonths": { "alias": "numberOfMonths"; "required": false; }; "firstDayOfWeek": { "alias": "firstDayOfWeek"; "required": false; }; "locale": { "alias": "locale"; "required": false; }; }, { "onFocus": "onFocus"; "onBlur": "onBlur"; "onClose": "onClose"; "onSelect": "onSelect"; "onClear": "onClear"; "onInput": "onInput"; "onTodayClick": "onTodayClick"; "onClearClick": "onClearClick"; "onMonthChange": "onMonthChange"; "onYearChange": "onYearChange"; "onClickOutside": "onClickOutside"; "onShow": "onShow"; }, ["templates"], ["p-header", "p-footer"], false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<Calendar, "p-calendar", never, { "style": { "alias": "style"; "required": false; }; "styleClass": { "alias": "styleClass"; "required": false; }; "inputStyle": { "alias": "inputStyle"; "required": false; }; "inputId": { "alias": "inputId"; "required": false; }; "name": { "alias": "name"; "required": false; }; "inputStyleClass": { "alias": "inputStyleClass"; "required": false; }; "placeholder": { "alias": "placeholder"; "required": false; }; "ariaLabelledBy": { "alias": "ariaLabelledBy"; "required": false; }; "iconAriaLabel": { "alias": "iconAriaLabel"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "dateFormat": { "alias": "dateFormat"; "required": false; }; "multipleSeparator": { "alias": "multipleSeparator"; "required": false; }; "rangeSeparator": { "alias": "rangeSeparator"; "required": false; }; "inline": { "alias": "inline"; "required": false; }; "showOtherMonths": { "alias": "showOtherMonths"; "required": false; }; "selectOtherMonths": { "alias": "selectOtherMonths"; "required": false; }; "showIcon": { "alias": "showIcon"; "required": false; }; "icon": { "alias": "icon"; "required": false; }; "appendTo": { "alias": "appendTo"; "required": false; }; "readonlyInput": { "alias": "readonlyInput"; "required": false; }; "shortYearCutoff": { "alias": "shortYearCutoff"; "required": false; }; "monthNavigator": { "alias": "monthNavigator"; "required": false; }; "yearNavigator": { "alias": "yearNavigator"; "required": false; }; "hourFormat": { "alias": "hourFormat"; "required": false; }; "timeOnly": { "alias": "timeOnly"; "required": false; }; "stepHour": { "alias": "stepHour"; "required": false; }; "stepMinute": { "alias": "stepMinute"; "required": false; }; "stepSecond": { "alias": "stepSecond"; "required": false; }; "showSeconds": { "alias": "showSeconds"; "required": false; }; "required": { "alias": "required"; "required": false; }; "showOnFocus": { "alias": "showOnFocus"; "required": false; }; "showWeek": { "alias": "showWeek"; "required": false; }; "showClear": { "alias": "showClear"; "required": false; }; "dataType": { "alias": "dataType"; "required": false; }; "selectionMode": { "alias": "selectionMode"; "required": false; }; "maxDateCount": { "alias": "maxDateCount"; "required": false; }; "showButtonBar": { "alias": "showButtonBar"; "required": false; }; "todayButtonStyleClass": { "alias": "todayButtonStyleClass"; "required": false; }; "clearButtonStyleClass": { "alias": "clearButtonStyleClass"; "required": false; }; "autoZIndex": { "alias": "autoZIndex"; "required": false; }; "baseZIndex": { "alias": "baseZIndex"; "required": false; }; "panelStyleClass": { "alias": "panelStyleClass"; "required": false; }; "panelStyle": { "alias": "panelStyle"; "required": false; }; "keepInvalid": { "alias": "keepInvalid"; "required": false; }; "hideOnDateTimeSelect": { "alias": "hideOnDateTimeSelect"; "required": false; }; "touchUI": { "alias": "touchUI"; "required": false; }; "timeSeparator": { "alias": "timeSeparator"; "required": false; }; "focusTrap": { "alias": "focusTrap"; "required": false; }; "showTransitionOptions": { "alias": "showTransitionOptions"; "required": false; }; "hideTransitionOptions": { "alias": "hideTransitionOptions"; "required": false; }; "tabindex": { "alias": "tabindex"; "required": false; }; "minDate": { "alias": "minDate"; "required": false; }; "maxDate": { "alias": "maxDate"; "required": false; }; "disabledDates": { "alias": "disabledDates"; "required": false; }; "disabledDays": { "alias": "disabledDays"; "required": false; }; "yearRange": { "alias": "yearRange"; "required": false; }; "showTime": { "alias": "showTime"; "required": false; }; "responsiveOptions": { "alias": "responsiveOptions"; "required": false; }; "numberOfMonths": { "alias": "numberOfMonths"; "required": false; }; "firstDayOfWeek": { "alias": "firstDayOfWeek"; "required": false; }; "locale": { "alias": "locale"; "required": false; }; "view": { "alias": "view"; "required": false; }; "defaultDate": { "alias": "defaultDate"; "required": false; }; }, { "onFocus": "onFocus"; "onBlur": "onBlur"; "onClose": "onClose"; "onSelect": "onSelect"; "onClear": "onClear"; "onInput": "onInput"; "onTodayClick": "onTodayClick"; "onClearClick": "onClearClick"; "onMonthChange": "onMonthChange"; "onYearChange": "onYearChange"; "onClickOutside": "onClickOutside"; "onShow": "onShow"; }, ["templates"], ["p-header", "p-footer"], false, never>;
 }
 export declare class CalendarModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<CalendarModule, never>;