@openmrs/ngx-formentry 3.0.1-pre.8

package/components/ngx-pick-datetime/lib/date-time/calendar-year-view.component.d.ts

@@ -0,0 +1,120 @@
+/**
+ * calendar-year-view.component
+ */
+import { AfterContentInit, ChangeDetectorRef, EventEmitter, OnDestroy, OnInit } from '@angular/core';
+import { CalendarCell, OwlCalendarBodyComponent } from './calendar-body.component';
+import { DateTimeAdapter } from './adapter/date-time-adapter.class';
+import { OwlDateTimeFormats } from './adapter/date-time-format.class';
+import { SelectMode } from './date-time.class';
+export declare class OwlYearViewComponent<T> implements OnInit, AfterContentInit, OnDestroy {
+    private cdRef;
+    private dateTimeAdapter;
+    private dateTimeFormats;
+    /**
+     * The select mode of the picker;
+     * */
+    private _selectMode;
+    get selectMode(): SelectMode;
+    set selectMode(val: SelectMode);
+    /** The currently selected date. */
+    private _selected;
+    get selected(): T | null;
+    set selected(value: T | null);
+    private _selecteds;
+    get selecteds(): T[];
+    set selecteds(values: T[]);
+    private _pickerMoment;
+    get pickerMoment(): T;
+    set pickerMoment(value: T);
+    /**
+     * A function used to filter which dates are selectable
+     * */
+    private _dateFilter;
+    get dateFilter(): (date: T) => boolean;
+    set dateFilter(filter: (date: T) => boolean);
+    /** The minimum selectable date. */
+    private _minDate;
+    get minDate(): T | null;
+    set minDate(value: T | null);
+    /** The maximum selectable date. */
+    private _maxDate;
+    get maxDate(): T | null;
+    set maxDate(value: T | null);
+    private readonly monthNames;
+    private _months;
+    get months(): CalendarCell[][];
+    get activeCell(): number;
+    get isInSingleMode(): boolean;
+    get isInRangeMode(): boolean;
+    private localeSub;
+    private initiated;
+    todayMonth: number | null;
+    /**
+     * An array to hold all selectedDates' month value
+     * the value is the month number in current year
+     * */
+    selectedMonths: number[];
+    /**
+     * Callback to invoke when a new month is selected
+     * */
+    readonly change: EventEmitter<T>;
+    /**
+     * Emits the selected year. This doesn't imply a change on the selected date
+     * */
+    readonly monthSelected: EventEmitter<T>;
+    /** Emits when any date is activated. */
+    readonly pickerMomentChange: EventEmitter<T>;
+    /** Emits when use keyboard enter to select a calendar cell */
+    readonly keyboardEnter: EventEmitter<any>;
+    /** The body of calendar table */
+    calendarBodyElm: OwlCalendarBodyComponent;
+    get owlDTCalendarView(): boolean;
+    constructor(cdRef: ChangeDetectorRef, dateTimeAdapter: DateTimeAdapter<T>, dateTimeFormats: OwlDateTimeFormats);
+    ngOnInit(): void;
+    ngAfterContentInit(): void;
+    ngOnDestroy(): void;
+    /**
+     * Handle a calendarCell selected
+     */
+    selectCalendarCell(cell: CalendarCell): void;
+    /**
+     * Handle a new month selected
+     */
+    private selectMonth;
+    /**
+     * Handle keydown event on calendar body
+     */
+    handleCalendarKeydown(event: KeyboardEvent): void;
+    /**
+     * Generate the calendar month list
+     * */
+    private generateMonthList;
+    /**
+     * Creates an CalendarCell for the given month.
+     */
+    private createMonthCell;
+    /**
+     * Check if the given month is enable
+     */
+    private isMonthEnabled;
+    /**
+     * Gets the month in this year that the given Date falls on.
+     * Returns null if the given Date is in another year.
+     */
+    private getMonthInCurrentYear;
+    /**
+     * Set the selectedMonths value
+     * In single mode, it has only one value which represent the month the selected date in
+     * In range mode, it would has two values, one for the month the fromValue in and the other for the month the toValue in
+     * */
+    private setSelectedMonths;
+    /**
+     * Check the given dates are in the same year
+     */
+    private hasSameYear;
+    /**
+     * Get a valid date object
+     */
+    private getValidDate;
+    private focusActiveCell;
+}

package/components/ngx-pick-datetime/lib/date-time/calendar.component.d.ts

@@ -0,0 +1,141 @@
+/**
+ * calendar.component
+ */
+import { AfterContentInit, AfterViewChecked, ChangeDetectorRef, ElementRef, EventEmitter, NgZone, OnDestroy, OnInit } from '@angular/core';
+import { OwlDateTimeIntl } from './date-time-picker-intl.service';
+import { DateTimeAdapter } from './adapter/date-time-adapter.class';
+import { OwlDateTimeFormats } from './adapter/date-time-format.class';
+import { SelectMode } from './date-time.class';
+export declare class OwlCalendarComponent<T> implements OnInit, AfterContentInit, AfterViewChecked, OnDestroy {
+    private elmRef;
+    private pickerIntl;
+    private ngZone;
+    private cdRef;
+    private dateTimeAdapter;
+    private dateTimeFormats;
+    get minDate(): T | null;
+    set minDate(value: T | null);
+    get maxDate(): T | null;
+    set maxDate(value: T | null);
+    get pickerMoment(): T;
+    set pickerMoment(value: T);
+    get selected(): T | null;
+    set selected(value: T | null);
+    get selecteds(): T[];
+    set selecteds(values: T[]);
+    get periodButtonText(): string;
+    get periodButtonLabel(): string;
+    get prevButtonLabel(): string;
+    get nextButtonLabel(): string;
+    get currentView(): 'month' | 'year' | 'multi-years';
+    set currentView(view: 'month' | 'year' | 'multi-years');
+    get isInSingleMode(): boolean;
+    get isInRangeMode(): boolean;
+    get showControlArrows(): boolean;
+    get isMonthView(): boolean;
+    /**
+     * Bind class 'owl-dt-calendar' to host
+     * */
+    get owlDTCalendarClass(): boolean;
+    constructor(elmRef: ElementRef, pickerIntl: OwlDateTimeIntl, ngZone: NgZone, cdRef: ChangeDetectorRef, dateTimeAdapter: DateTimeAdapter<T>, dateTimeFormats: OwlDateTimeFormats);
+    /**
+     * Date filter for the month and year view
+     * */
+    dateFilter: Function;
+    /**
+     * Set the first day of week
+     */
+    firstDayOfWeek: number;
+    /** The minimum selectable date. */
+    private _minDate;
+    /** The maximum selectable date. */
+    private _maxDate;
+    /** The current picker moment */
+    private _pickerMoment;
+    selectMode: SelectMode;
+    /** The currently selected moment. */
+    private _selected;
+    private _selecteds;
+    /**
+     * The view that the calendar should start in.
+     */
+    startView: 'month' | 'year' | 'multi-years';
+    /**
+     * 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 currently selected date changes. */
+    selectedChange: EventEmitter<T>;
+    /** Emits when any date is selected. */
+    userSelection: EventEmitter<void>;
+    /**
+     * Emits the selected year. This doesn't imply a change on the selected date
+     * */
+    readonly yearSelected: EventEmitter<T>;
+    /**
+     * Emits the selected month. This doesn't imply a change on the selected date
+     * */
+    readonly monthSelected: EventEmitter<T>;
+    private _currentView;
+    private intlChangesSub;
+    /**
+     * 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;
+    /**
+     * Date filter for the month and year view
+     */
+    dateFilterForViews: (date: T) => boolean;
+    ngOnInit(): void;
+    ngAfterContentInit(): void;
+    ngAfterViewChecked(): void;
+    ngOnDestroy(): void;
+    /**
+     * Toggle between month view and year view
+     */
+    toggleViews(): void;
+    /**
+     * Handles user clicks on the previous button.
+     * */
+    previousClicked(): void;
+    /**
+     * Handles user clicks on the next button.
+     * */
+    nextClicked(): void;
+    dateSelected(date: T): void;
+    /**
+     * Change the pickerMoment value and switch to a specific view
+     */
+    goToDateInView(date: T, view: 'month' | 'year' | 'multi-years'): void;
+    /**
+     * Change the pickerMoment value
+     */
+    handlePickerMomentChange(date: T): void;
+    userSelected(): void;
+    /**
+     * Whether the previous period button is enabled.
+     */
+    prevButtonEnabled(): boolean;
+    /**
+     * Whether the next period button is enabled.
+     */
+    nextButtonEnabled(): boolean;
+    /**
+     * Focus to the host element
+     * */
+    focusActiveCell(): void;
+    selectYearInMultiYearView(normalizedYear: T): void;
+    selectMonthInYearView(normalizedMonth: T): void;
+    /**
+     * Whether the two dates represent the same view in the current view mode (month or year).
+     */
+    private isSameView;
+    /**
+     * Get a valid date object
+     */
+    private getValidDate;
+}

package/components/ngx-pick-datetime/lib/date-time/date-time-inline.component.d.ts

@@ -0,0 +1,90 @@
+/**
+ * date-time-inline.component
+ */
+import { ChangeDetectorRef, EventEmitter, OnInit } from '@angular/core';
+import { ControlValueAccessor } from '@angular/forms';
+import { OwlDateTime, PickerMode, PickerType, SelectMode } from './date-time.class';
+import { DateTimeAdapter } from './adapter/date-time-adapter.class';
+import { OwlDateTimeFormats } from './adapter/date-time-format.class';
+import { OwlDateTimeContainerComponent } from './date-time-picker-container.component';
+export declare const OWL_DATETIME_VALUE_ACCESSOR: any;
+export declare class OwlDateTimeInlineComponent<T> extends OwlDateTime<T> implements OnInit, ControlValueAccessor {
+    protected changeDetector: ChangeDetectorRef;
+    protected dateTimeAdapter: DateTimeAdapter<T>;
+    protected dateTimeFormats: OwlDateTimeFormats;
+    container: OwlDateTimeContainerComponent<T>;
+    /**
+     * Set the type of the dateTime picker
+     *      'both' -- show both calendar and timer
+     *      'calendar' -- show only calendar
+     *      'timer' -- show only timer
+     */
+    private _pickerType;
+    get pickerType(): PickerType;
+    set pickerType(val: PickerType);
+    private _disabled;
+    get disabled(): boolean;
+    set disabled(value: boolean);
+    private _selectMode;
+    get selectMode(): SelectMode;
+    set selectMode(mode: SelectMode);
+    /** The date to open the calendar to initially. */
+    private _startAt;
+    get startAt(): T | null;
+    set startAt(date: T | null);
+    private _dateTimeFilter;
+    get dateTimeFilter(): (date: T | null) => boolean;
+    set dateTimeFilter(filter: (date: T | null) => boolean);
+    /** The minimum valid date. */
+    private _min;
+    get minDateTime(): T | null;
+    set minDateTime(value: T | null);
+    /** The maximum valid date. */
+    private _max;
+    get maxDateTime(): T | null;
+    set maxDateTime(value: T | null);
+    private _value;
+    get value(): T | null;
+    set value(value: T | null);
+    private _values;
+    get values(): T[];
+    set values(values: T[]);
+    /**
+     * Emits selected year in multi-year view
+     * This doesn't imply a change on the selected date.
+     * */
+    yearSelected: EventEmitter<T>;
+    /**
+     * Emits selected month in year view
+     * This doesn't imply a change on the selected date.
+     * */
+    monthSelected: EventEmitter<T>;
+    private _selected;
+    get selected(): T | null;
+    set selected(value: T | null);
+    private _selecteds;
+    get selecteds(): T[];
+    set selecteds(values: T[]);
+    get opened(): boolean;
+    get pickerMode(): PickerMode;
+    get isInSingleMode(): boolean;
+    get isInRangeMode(): boolean;
+    get owlDTInlineClass(): boolean;
+    private onModelChange;
+    private onModelTouched;
+    constructor(changeDetector: ChangeDetectorRef, dateTimeAdapter: DateTimeAdapter<T>, dateTimeFormats: OwlDateTimeFormats);
+    ngOnInit(): void;
+    writeValue(value: any): void;
+    registerOnChange(fn: any): void;
+    registerOnTouched(fn: any): void;
+    setDisabledState(isDisabled: boolean): void;
+    select(date: T[] | T): void;
+    /**
+     * Emits the selected year in multi-year view
+     * */
+    selectYear(normalizedYear: T): void;
+    /**
+     * Emits selected month in year view
+     * */
+    selectMonth(normalizedMonth: T): void;
+}

package/components/ngx-pick-datetime/lib/date-time/date-time-picker-container.component.d.ts

@@ -0,0 +1,122 @@
+/**
+ * date-time-picker-container.component
+ */
+import { AfterContentInit, AfterViewInit, ChangeDetectorRef, ElementRef, OnInit } from '@angular/core';
+import { AnimationEvent } from '@angular/animations';
+import { OwlDateTimeIntl } from './date-time-picker-intl.service';
+import { OwlCalendarComponent } from './calendar.component';
+import { OwlTimerComponent } from './timer.component';
+import { DateTimeAdapter } from './adapter/date-time-adapter.class';
+import { OwlDateTime, PickerType } from './date-time.class';
+import { Observable } from 'rxjs';
+export declare class OwlDateTimeContainerComponent<T> implements OnInit, AfterContentInit, AfterViewInit {
+    private cdRef;
+    private elmRef;
+    private pickerIntl;
+    private dateTimeAdapter;
+    calendar: OwlCalendarComponent<T>;
+    timer: OwlTimerComponent<T>;
+    picker: OwlDateTime<T>;
+    activeSelectedIndex: number;
+    /**
+     * Stream emits when try to hide picker
+     * */
+    private hidePicker$;
+    get hidePickerStream(): Observable<any>;
+    /**
+     * Stream emits when try to confirm the selected value
+     * */
+    private confirmSelected$;
+    get confirmSelectedStream(): Observable<any>;
+    private pickerOpened$;
+    get pickerOpenedStream(): Observable<any>;
+    /**
+     * The current picker moment. This determines which time period is shown and which date is
+     * highlighted when using keyboard navigation.
+     */
+    private _clamPickerMoment;
+    get pickerMoment(): T;
+    set pickerMoment(value: T);
+    get pickerType(): PickerType;
+    get cancelLabel(): string;
+    get setLabel(): string;
+    /**
+     * The range 'from' label
+     * */
+    get fromLabel(): string;
+    /**
+     * The range 'to' label
+     * */
+    get toLabel(): string;
+    /**
+     * The range 'from' formatted value
+     * */
+    get fromFormattedValue(): string;
+    /**
+     * The range 'to' formatted value
+     * */
+    get toFormattedValue(): string;
+    /**
+     * Cases in which the control buttons show in the picker
+     * 1) picker mode is 'dialog'
+     * 2) picker type is NOT 'calendar' and the picker mode is NOT 'inline'
+     * */
+    get showControlButtons(): boolean;
+    get containerElm(): HTMLElement;
+    get owlDTContainerClass(): boolean;
+    get owlDTPopupContainerClass(): boolean;
+    get owlDTDialogContainerClass(): boolean;
+    get owlDTInlineContainerClass(): boolean;
+    get owlDTContainerDisabledClass(): boolean;
+    get owlDTContainerId(): string;
+    get owlDTContainerAnimation(): any;
+    constructor(cdRef: ChangeDetectorRef, elmRef: ElementRef, pickerIntl: OwlDateTimeIntl, dateTimeAdapter: DateTimeAdapter<T>);
+    ngOnInit(): void;
+    ngAfterContentInit(): void;
+    ngAfterViewInit(): void;
+    handleContainerAnimationDone(event: AnimationEvent): void;
+    dateSelected(date: T): void;
+    timeSelected(time: T): void;
+    /**
+     * Handle click on cancel button
+     */
+    onCancelClicked(event: any): void;
+    /**
+     * Handle click on set button
+     */
+    onSetClicked(event: any): void;
+    /**
+     * Handle click on inform radio group
+     */
+    handleClickOnInfoGroup(event: any, index: number): void;
+    /**
+     * Handle click on inform radio group
+     */
+    handleKeydownOnInfoGroup(event: any, next: any, index: number): void;
+    /**
+     * Set the value of activeSelectedIndex
+     */
+    private setActiveSelectedIndex;
+    private initPicker;
+    /**
+     * Select calendar date in single mode,
+     * it returns null when date is not selected.
+     */
+    private dateSelectedInSingleMode;
+    /**
+     * Select dates in range Mode
+     */
+    private dateSelectedInRangeMode;
+    /**
+     * Update the given calendar date's time and check if it is valid
+     * Because the calendar date has 00:00:00 as default time, if the picker type is 'both',
+     * we need to update the given calendar date's time before selecting it.
+     * if it is valid, return the updated dateTime
+     * if it is not valid, return null
+     */
+    private updateAndCheckCalendarDate;
+    /**
+     * Focus to the picker
+     * */
+    private focusPicker;
+}

package/components/ngx-pick-datetime/lib/date-time/date-time-picker-input.directive.d.ts

@@ -0,0 +1,152 @@
+/**
+ * date-time-picker-input.directive
+ */
+import { AfterContentInit, ElementRef, EventEmitter, OnDestroy, OnInit, Renderer2 } from '@angular/core';
+import { AbstractControl, ControlValueAccessor, Validator } from '@angular/forms';
+import { OwlDateTimeComponent } from './date-time-picker.component';
+import { DateTimeAdapter } from './adapter/date-time-adapter.class';
+import { OwlDateTimeFormats } from './adapter/date-time-format.class';
+import { SelectMode } from './date-time.class';
+export declare const OWL_DATETIME_VALUE_ACCESSOR: any;
+export declare const OWL_DATETIME_VALIDATORS: any;
+export declare class OwlDateTimeInputDirective<T> implements OnInit, AfterContentInit, OnDestroy, ControlValueAccessor, Validator {
+    private elmRef;
+    private renderer;
+    private dateTimeAdapter;
+    private dateTimeFormats;
+    /**
+     * The date time picker that this input is associated with.
+     * */
+    set owlDateTime(value: OwlDateTimeComponent<T>);
+    /**
+     * A function to filter date time
+     */
+    set owlDateTimeFilter(filter: (date: T | null) => boolean);
+    get dateTimeFilter(): (date: T) => boolean;
+    get disabled(): boolean;
+    set disabled(value: boolean);
+    get min(): T | null;
+    set min(value: T | null);
+    get max(): T | null;
+    set max(value: T | null);
+    get selectMode(): SelectMode;
+    set selectMode(mode: SelectMode);
+    get value(): T | null;
+    set value(value: T | null);
+    get values(): T[];
+    set values(values: T[]);
+    get elementRef(): ElementRef;
+    get isInSingleMode(): boolean;
+    get isInRangeMode(): boolean;
+    get owlDateTimeInputAriaHaspopup(): boolean;
+    get owlDateTimeInputAriaOwns(): string;
+    get minIso8601(): string;
+    get maxIso8601(): string;
+    get owlDateTimeInputDisabled(): boolean;
+    private _dateTimeFilter;
+    /** Whether the date time picker's input is disabled. */
+    private _disabled;
+    /** The minimum valid date. */
+    private _min;
+    /** The maximum valid date. */
+    private _max;
+    /**
+     * The picker's select mode
+     */
+    private _selectMode;
+    /**
+     * The character to separate the 'from' and 'to' in input value
+     */
+    rangeSeparator: string;
+    private _value;
+    private _values;
+    /**
+     * Callback to invoke when `change` event is fired on this `<input>`
+     * */
+    dateTimeChange: EventEmitter<any>;
+    /**
+     * Callback to invoke when an `input` event is fired on this `<input>`.
+     * */
+    dateTimeInput: EventEmitter<any>;
+    /** The date-time-picker that this input is associated with. */
+    dtPicker: OwlDateTimeComponent<T>;
+    private dtPickerSub;
+    private localeSub;
+    private lastValueValid;
+    /** The form control validator for whether the input parses. */
+    private parseValidator;
+    /** The form control validator for the min date. */
+    private minValidator;
+    /** The form control validator for the max date. */
+    private maxValidator;
+    /** The form control validator for the date filter. */
+    private filterValidator;
+    /**
+     * The form control validator for the range.
+     * Check whether the 'before' value is before the 'to' value
+     * */
+    private rangeValidator;
+    /** The combined form control validator for this input. */
+    private validator;
+    /** Emits when the value changes (either due to user input or programmatic change). */
+    valueChange: EventEmitter<T | T[]>;
+    /** Emits when the disabled state has changed */
+    disabledChange: EventEmitter<boolean>;
+    private onModelChange;
+    private onModelTouched;
+    private validatorOnChange;
+    constructor(elmRef: ElementRef, renderer: Renderer2, dateTimeAdapter: DateTimeAdapter<T>, dateTimeFormats: OwlDateTimeFormats);
+    ngOnInit(): void;
+    ngAfterContentInit(): void;
+    ngOnDestroy(): void;
+    writeValue(value: any): void;
+    registerOnChange(fn: any): void;
+    registerOnTouched(fn: any): void;
+    setDisabledState(isDisabled: boolean): void;
+    validate(c: AbstractControl): {
+        [key: string]: any;
+    };
+    registerOnValidatorChange(fn: () => void): void;
+    /**
+     * Open the picker when user hold alt + DOWN_ARROW
+     * */
+    handleKeydownOnHost(event: KeyboardEvent): void;
+    handleBlurOnHost(event: Event): void;
+    handleInputOnHost(event: any): void;
+    handleChangeOnHost(event: any): void;
+    /**
+     * Set the native input property 'value'
+     */
+    formatNativeInputValue(): void;
+    /**
+     * Register the relationship between this input and its picker component
+     */
+    private registerDateTimePicker;
+    /**
+     * Convert a given obj to a valid date object
+     */
+    private getValidDate;
+    /**
+     * Convert a time string to a date-time string
+     * When pickerType is 'timer', the value in the picker's input is a time string.
+     * The dateTimeAdapter parse fn could not parse a time string to a Date Object.
+     * Therefore we need this fn to convert a time string to a date-time string.
+     */
+    private convertTimeStringToDateTimeString;
+    /**
+     * Handle input change in single mode
+     */
+    private changeInputInSingleMode;
+    /**
+     * Handle input change in rangeFrom or rangeTo mode
+     */
+    private changeInputInRangeFromToMode;
+    /**
+     * Handle input change in range mode
+     */
+    private changeInputInRangeMode;
+    /**
+     * Check if the two value is the same
+     */
+    private isSameValue;
+}

package/components/ngx-pick-datetime/lib/date-time/date-time-picker-intl.service.d.ts

@@ -0,0 +1,51 @@
+/**
+ * date-time-picker-intl.service
+ */
+import { Subject } from 'rxjs';
+export declare class OwlDateTimeIntl {
+    /**
+     * 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 up second button (used by screen readers).  */
+    upSecondLabel: string;
+    /** A label for the down second button (used by screen readers).  */
+    downSecondLabel: string;
+    /** A label for the up minute button (used by screen readers).  */
+    upMinuteLabel: string;
+    /** A label for the down minute button (used by screen readers).  */
+    downMinuteLabel: string;
+    /** A label for the up hour button (used by screen readers).  */
+    upHourLabel: string;
+    /** A label for the down hour button (used by screen readers).  */
+    downHourLabel: 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 cancel button */
+    cancelBtnLabel: string;
+    /** A label for the set button */
+    setBtnLabel: string;
+    /** A label for the range 'from' in picker info */
+    rangeFromLabel: string;
+    /** A label for the range 'to' in picker info */
+    rangeToLabel: string;
+    /** A label for the hour12 button (AM) */
+    hour12AMLabel: string;
+    /** A label for the hour12 button (PM) */
+    hour12PMLabel: string;
+}