@energycap/components 0.42.4-esbuild.20250131-1219 → 0.42.4-esbuild.20250131-1256

package/lib/controls/combobox/combobox.component.d.ts

@@ -0,0 +1,418 @@
+import { EventEmitter, OnInit, OnChanges, SimpleChanges, AfterViewInit, TemplateRef } from '@angular/core';
+import { UntypedFormControl } from "@angular/forms";
+import { TranslateService } from "@ngx-translate/core";
+import { FormControlBase } from '../form-control-base';
+import { Observable } from 'rxjs';
+import { TextboxComponent } from '../textbox/textbox.component';
+import { ValidationMessageService } from '../../core/validation-message.service';
+import { FormGroupHelper } from '../../shared/form-group.helper';
+import { MenuItem, MenuTemplateType, MenuHostElementClasses } from '../menu/menu.component';
+import { PopupStatus } from '../../shared/directives/popup/popup-container.directive';
+import { ScrollService } from '../../core/scroll.service';
+import * as i0 from "@angular/core";
+/**
+ * Position of the menu relative to the input
+ */
+export type ComboboxMenuPosition = "top_right" | "top_left" | "bottom_left" | "bottom_right";
+/**
+ * The type of add new implementation. Static displays a simple static button while dynamic updates
+ * the label of the button with value of the textbox
+ */
+type AddNewType = "dynamic" | "static" | boolean;
+/**
+ * Options for configuring the "Add new" button when in static mode
+ */
+type AddNewOptions = {
+    label?: string; /** A custom label to display in place of the default "Add new..." */
+    classList?: string; /** A string of space-separated utility classes we'll apply to the label */
+    icon?: string; /** A custom icon to display in place of the default 'icon-add' */
+};
+/**
+ * Select box (select, autocomplete, combobox)
+ *
+ * NOTE: Min/max length validation is implemented on the internal ec-textbox.
+ * Values passed in via input properties (@see maxlength , @see minlength )
+ * are used to create validators on the textbox.  When the validation on the
+ * textbox fails, the validation error(s) get passed up to the {@see formModel }.
+ * When setting up this component's {@see FormControl }, you do NOT need to set the
+ * Validators.minLength or Validators.maxLength validators.
+ *
+ * Required is also passed via input property, but you SHOULD also set up the
+ * Validators.required validator on this component's FormControl.
+ *
+ * @export
+ */
+export declare class ComboboxComponent extends FormControlBase implements OnInit, OnChanges, AfterViewInit {
+    protected validationMessageService: ValidationMessageService;
+    protected formGroupHelper: FormGroupHelper;
+    protected translate: TranslateService;
+    protected scrollService: ScrollService;
+    /**
+     * Close the popup menu on resize so the width and positioning can be recalculated
+     * correctly. Cannot be placed on the popupDirective because of a bug where
+     * HostListeners for global events don't fire
+     * @see https://github.com/angular/angular/issues/14191
+     */
+    onResize(): void;
+    /**
+     * Show the add new button in the popup
+     */
+    addNew?: AddNewType;
+    /** Configure the addNew button label & icon when addNew is true and set to static
+     * Default is set to: { label: 'All new...', icon: 'icon-add'}
+     * @see AddNewOptions
+     * @memberof ComboboxComponent
+     * @example
+     * <ec-combobox [addNew]="true"
+     * 	         [addNewOptions]="{
+* 						label: 'Help me choose...',
+* 						icon: 'icon-search',
+* 						classList: 'text-body-2 text-link' }">
+     * </ec-combobox>
+     */
+    addNewOptions?: AddNewOptions;
+    /**
+     * The maximum number of characters allowed in the input.
+     *
+     * @memberof TextboxComponent
+     */
+    maxlength?: number;
+    /**
+     * Position of the menu relative to the text box
+     * @default 'bottom_right'
+     * @memberof ComboboxComponent
+     */
+    menuPosition?: ComboboxMenuPosition;
+    /**
+     * The minimum number of characters allowed in the input
+     *
+     * @memberof TextboxComponent
+     */
+    minlength?: number;
+    /**
+     * Items to show in combobox menu
+     *
+     * @memberof ComboboxComponent
+     */
+    options: Array<MenuItem>;
+    /**
+     * Display template for menu items
+     *
+     * @memberof ComboboxComponent
+     */
+    templateType: MenuTemplateType;
+    /**
+     * Optional custom template for the menu items. Must declare a template
+     * input variable called "item" like so: <ng-template #templateName let-item>,
+     * where item represents the menuItem.
+     * Will override the choice for templateType if provided.
+     *
+     * @memberof ComboboxComponent
+     */
+    customMenuTemplate?: TemplateRef<any>;
+    /**
+     * When true, the menu items will preserve the icon space when there is no icon
+     */
+    preserveIconSpace: boolean;
+    /**
+     * Position the menu as fixed, ideal when comboboxes are inside dialogs
+     * Defaulting to true so all menus will be at least the width of the
+     * textbox + button, but can grow wider if the inner elements need it
+     */
+    popupFixed: boolean;
+    /**
+     * The total number of records from the datasource
+     */
+    totalRecords?: number;
+    /**
+     * If set to true, we will upperCase the text box and apply the class on the add box
+     */
+    upperCase: boolean;
+    /**The placeholder to show in the combobox. Leave empty to use default behavior determined
+     * by whether Add New is enabled
+     */
+    placeholder: string;
+    /** Observable to subscribe to when the combobox menu is opened for the first time */
+    loadOnOpenObservable?: Observable<MenuItem[]> | undefined;
+    /** Do not display the toggle button when true */
+    hideToggleButton: boolean;
+    /**
+     * Always show the menu when the formModel has a value. Sets
+     * hideToggleButton to true and menuStatus to visible as well.
+     */
+    alwaysOpen: boolean;
+    /**
+     * Additonal classes to apply to the ec-menu element
+     */
+    menuElementClasses: MenuHostElementClasses | string[];
+    /**
+     * Additional classes to apply to the .textbox-group element
+     */
+    textboxElementClasses: string[];
+    /** Hide 'No matches' message when true */
+    hideNoMatches: boolean;
+    /**
+   * Text to show when the menu is empty. "No matches" is the default.
+   */
+    noMatchesText: string;
+    /**
+     * Truncate menu items when true
+     */
+    truncateItems: boolean;
+    /**
+     * Notify the parent that the add new button was clicked
+     * @todo discuss if we need to send along the value or should
+     * the parent get it from the formModel
+     * (lwf 2017.07.13): I think we might as well send the value along and
+     * leave it up to the parent to decide how to handle it.
+     */
+    addNewClick: EventEmitter<string>;
+    /**
+     * Notify parent when text typed into textbox
+     */
+    search: EventEmitter<string>;
+    textbox: TextboxComponent;
+    /**
+     * Access to the menu's component via the  {@link PopupContainerDirective}
+     */
+    private popup?;
+    /**
+     * Reference the add-new button element
+     */
+    private addNewButton;
+    /**
+     * Filtered Items to show in combobox menu
+     */
+    filteredOptions: Array<MenuItem>;
+    /**
+     * Tracks if the menu is open or hidden
+     */
+    menuStatus: PopupStatus;
+    /**
+     * Placeholder to assign to textbox
+     */
+    effectivePlaceholder: string;
+    /**
+     * Reference to the currently-selected menu item
+     */
+    selectedItem: MenuItem | null;
+    /**
+     * FormControl for the textbox
+     */
+    textboxFormModel: UntypedFormControl;
+    /**
+     * Tracks whether the add new button is selected
+     */
+    addNewSelected: boolean;
+    /**
+     * Tracks whether the textboxFormModel value matches an item in the filteredOptions
+     */
+    foundMatch: boolean;
+    /**
+     * Number of filtered options to display in the footer.  Excludes headings.
+     */
+    filteredOptionCount: number;
+    /**
+     * Flat list of selectable items in the combobox.
+     * Does not include headings or divider-section items.
+     */
+    private selectableItems;
+    /**
+     * Index of the currently-selected options
+     */
+    private selectedItemIndex;
+    /** Placeholder text for 'Choose or Add...' */
+    private chooseOrAddPlaceholder;
+    /** Placeholder text for 'Choose' */
+    private choosePlaceholder;
+    private hasDataBeenLoadedOnOpen;
+    constructor(validationMessageService: ValidationMessageService, formGroupHelper: FormGroupHelper, translate: TranslateService, scrollService: ScrollService);
+    /**
+     * The angular onChanges lifecycle event
+     * @see https://angular.io/guide/lifecycle-hooks
+     */
+    ngOnChanges(changes: SimpleChanges): void;
+    /**
+     * The angular onInit lifecycle hook
+     * @see https://angular.io/guide/lifecycle-hooks
+     */
+    ngOnInit(): void;
+    /**
+     * The angular afterViewInit lifecycle hook
+     * @see https://angular.io/guide/lifecycle-hooks
+     */
+    ngAfterViewInit(): void;
+    /**
+     * Set errors on the textboxFormModel, which will then set errors on the
+     * formModel. Also mark the formModel as touched to display any errors.
+     * @param errors key(s) of ValidationMessageService errors to display or remove
+     * @memberof ComoboboxComponent
+     */
+    setErrors(errors: {
+        [key: string]: boolean;
+    }): void;
+    /**
+     * Unfilter options and update the selectedItem and selectedItemIndex
+     * @memberof ComboboxComponent
+     */
+    resetOptions(options?: MenuItem[]): void;
+    /**
+     * Listen to the selected changed event from {@link MenuComponent} and update the form
+     * model and close menu
+     */
+    selectedChanged(item: MenuItem): void;
+    /**
+     * Show and hide the popup menu
+     *
+     * @memberof ComboboxComponent
+     */
+    toggleMenu(event?: Event): void;
+    onBlur(): void;
+    /**
+     * Control the menu with keyboard navigation
+     *
+     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/key#Example | KeyboardEvent.key}
+     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/key/Key_Values | Key Values}
+     *
+     * @memberof ComboboxComponent
+     */
+    keyNavigate(event: KeyboardEvent): void;
+    /**
+     * Facilitates adding items to a combobox
+     *
+     * @param addFn Function from parent that should make an API request to add a new item to the combobox's options
+     * @memberof ComboboxComponent
+     */
+    addNewItem(addFn: () => Promise<void>): Promise<void>;
+    /**
+     * Figure out whether they are adding new or have an item selected, and commit it to the form model
+     */
+    private commitSelection;
+    /**
+     * Send the current value of the textbox to the parent when the add new button is
+     * clicked
+     *
+     * @param event Add new button click or enter key event
+     * @memberof ComboboxComponent
+     */
+    onAddNew(event: Event): void;
+    /**
+     * Navigate the dropdown menu using up and down arrow keys
+     *
+     * @param event Up or down arrow keydown event
+     * @memberof ComboboxComponent
+     */
+    private onArrowDownUp;
+    /**
+
+     * Filter array of options by label or caption (contains)
+     *
+     * @param filterText The value of textbox that we will filter our options by
+     *
+     * @memberof ComboboxComponent
+     */
+    private filterOptionsArray;
+    /**
+     * Find a given item's index in the filtered items array.
+     *
+     * Returns -1 if not found
+     * @param item The matching item to find in the
+     * filterdOptions array. Will use the selectedItem if nothing is passed.
+     * @memberof ComboboxComponent
+     */
+    private findSelectedItemIndex;
+    /**
+     * React to our formModel changing
+     *
+     * The formModel represents the currently selected ModelItem
+     * When changed, set the value of the TextboxComponent and
+     * find index of item in options list.
+     *
+     * @memberof ComboboxComponent
+     */
+    private formModelChanged;
+    /**
+     * Scroll the menu if the current selectedItemIndex is out of view
+     *
+     * @memberof ComboboxComponent
+     */
+    private scrollMenu;
+    /**
+     * Search/Filter based on textbox input
+     * NOTE: so as not to receive a notification on every key event, we suggest you debounce your
+     * subscription
+     * @see {@link http://reactivex.io/rxjs/class/es6/Observable.js~Observable.html#instance-method-debounceTime | Observable.debounceTime}
+     *
+     * @memberof ComboboxComponent
+     */
+    private searchAndFilter;
+    /**
+     * Set {@link formModel }'s validation errors equal to the internal textbox's.
+     *
+     * When the internal textbox is invalid, need to set this control's
+     * errors because we are using our own label, not TextboxControl's.
+     * We use our own label so label text will wrap at the end of the button,
+     * not at the end of the textbox.
+     *
+     * @memberof ComboboxComponent
+     */
+    private setFormModelValidationErrors;
+    /**
+     * Update the form model value with the selected item or reset form model value if item is null
+     *
+     * @memberof ComboboxComponent
+     */
+    private setFormModelValue;
+    /**
+     * Set validators on the {@see textboxFormModel }
+     *
+     * Validators are currently set based on the {@see maxlength },
+     * {@see minlength }, and {@see required } inputs.  This works well
+     * with {@see TextboxComponent }, which needs these inputs to apply
+     * the proper attributes to its inputs.
+     *
+     * A future release of Angular will supposedly add these attributes
+     * for you, which will eliminate the need for TextboxComponent to have
+     * such inputs.  This component, however, will still need these inputs
+     * as there is no current way to know which validators are applied to it
+     * from its parent View Component.
+     *
+     *
+     * @memberof ComboboxComponent
+     */
+    private setTextboxFormModelValidators;
+    /**
+     * Keep textbox's disabled status in-sync with combobox's
+     *
+     * {@link TextboxComponent} gets its disabled status from its {@link FormControl}
+     *
+     * @memberof ComboboxComponent
+     */
+    private synchronizeDisabledAttributes;
+    /**
+     * If the formModel value and textbox value do not match, reset the textbox and selectedItem to
+     * the formModle value. If there is no formModel value, make sure we clear the textbox. Reset the
+     * filteredOptions to the full list and update the selectedItemIndex
+     *
+     */
+    private syncModelValues;
+    /**
+     * Search and filter the options list when the value of the textbox input changes. If addNew is
+     * set also check for matches in our filteredOptions to conditionally show and hide the add new
+     * button
+     *
+     * @see https://developer.mozilla.org/en-US/docs/Web/Events/input
+     */
+    textboxValueChanged(event: Event): void;
+    private clearSelectedItem;
+    /**Recompute what the placeholder should be based on whether the user provided one and the current state of the addNew input */
+    private updatePlaceholderText;
+    /**Find the option we want to be the default selection. If there is an exact match, use that
+     * otherwise if there are items, return zero to indicate the first item. Otherwise return -1
+     * to indicate no selection
+     */
+    private findDefaultSelectionIndex;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ComboboxComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ComboboxComponent, "ec-combobox", never, { "addNew": { "alias": "addNew"; "required": false; }; "addNewOptions": { "alias": "addNewOptions"; "required": false; }; "maxlength": { "alias": "maxlength"; "required": false; }; "menuPosition": { "alias": "menuPosition"; "required": false; }; "minlength": { "alias": "minlength"; "required": false; }; "options": { "alias": "options"; "required": false; }; "templateType": { "alias": "templateType"; "required": false; }; "customMenuTemplate": { "alias": "customMenuTemplate"; "required": false; }; "preserveIconSpace": { "alias": "preserveIconSpace"; "required": false; }; "popupFixed": { "alias": "popupFixed"; "required": false; }; "totalRecords": { "alias": "totalRecords"; "required": false; }; "upperCase": { "alias": "upperCase"; "required": false; }; "placeholder": { "alias": "placeholder"; "required": false; }; "loadOnOpenObservable": { "alias": "loadOnOpenObservable"; "required": false; }; "hideToggleButton": { "alias": "hideToggleButton"; "required": false; }; "alwaysOpen": { "alias": "alwaysOpen"; "required": false; }; "menuElementClasses": { "alias": "menuElementClasses"; "required": false; }; "textboxElementClasses": { "alias": "textboxElementClasses"; "required": false; }; "hideNoMatches": { "alias": "hideNoMatches"; "required": false; }; "noMatchesText": { "alias": "noMatchesText"; "required": false; }; "truncateItems": { "alias": "truncateItems"; "required": false; }; }, { "addNewClick": "addNewClick"; "search": "search"; }, never, never, false, never>;
+}
+export {};

package/lib/controls/date-input/date-input-selection-strategies/date-input-selection-strategy-base.d.ts

@@ -0,0 +1,42 @@
+import { Calendar } from "../../calendar/calendar.types";
+import { DateInput } from "../date-input.types";
+/**
+ * Contains the logic for selecting, formatting, and parsing date dates for a specific selection mode.
+ */
+export declare abstract class DateInputSelectionStrategyBase {
+    /** The calendar view mode where selections occur for this mode. This is used to zoom the calendar into the selection */
+    abstract readonly selectionViewMode: Calendar.ViewMode;
+    /** The list of view modes that are accessible by this selection mode. Used to determine whether the calendar view needs to be changed or not on selection change. */
+    abstract readonly validViewModes: Calendar.ViewMode[];
+    /** Whether the secondary textbox should be shown for this selection mode */
+    abstract readonly showSecondaryTextbox: boolean;
+    /** Whether the secondary calendar should be shown for this selection mode */
+    abstract readonly showSecondaryCalendar: boolean;
+    /** Parses the string into a date using the provided parse formats. */
+    parseString(value: string | null | undefined, parseFormats: string[], opts?: DateInput.ParsingOptions): Date | null;
+    /** Formats a date input selection into values to be displayed in the date input's textboxes. */
+    abstract formatSelection(selection?: DateInput.Selection | null): DateInput.TextboxGroup['value'];
+    /**
+     * Parses the date input's values into a date selection to display in the calendars.
+     * `parseFromEnd` controls whether the fixed range modes (last7days, last28days) will key off the end date instead of the start date.
+     * This is used when the user is typing in the end date textbox.
+     */
+    abstract parseTextboxValues(value: DateInput.TextboxGroup['value'], parseFormats: string[], opts?: DateInput.ParsingOptions): DateInput.Selection | null;
+    /** Returns a selection given a date and an existing selection (in the case of date ranges). Called when a date is clicked in the calendars. */
+    abstract getSelectionFromDate(date: Date, existingSelection?: DateInput.Selection | null): DateInput.Selection | null;
+    /** Returns a new selection that best matches the given previous selection from a different selection mode */
+    abstract getNewSelectionFromExisting(previousSelection?: DateInput.Selection | null): DateInput.Selection | null;
+    /** Returns a new selection for the provided date. */
+    getSelectionForQuickSelectDate(date: Date, existingSelection?: DateInput.Selection | null): DateInput.Selection | null;
+    /** Returns the next selection. Called by the date input steppers to move the range. */
+    abstract getNextSelection(selection: DateInput.Selection | null): DateInput.Selection | null;
+    /** Returns the previous selection. Called by the date input steppers to move the range. */
+    abstract getPreviousSelection(selection: DateInput.Selection | null): DateInput.Selection | null;
+    /** Returns the view for the primary calendar for the selection and selection mode */
+    getPrimaryCalendarView(selection: DateInput.Selection | null, minDate: Date, maxDate: Date, currentView: Calendar.View): Calendar.View;
+    /**
+     * Returns the view for the secondary calendar for the selection and selection mode.
+     * This is is only used by the range selection strategy. All others just return the current date.
+     */
+    getSecondaryCalendarView(selection: DateInput.Selection | null, minDate: Date, maxDate: Date, currentView: Calendar.View): Calendar.View;
+}

package/lib/controls/date-input/date-input-selection-strategies/day-selection-strategy.d.ts

@@ -0,0 +1,21 @@
+import { DateDisplayPipe } from "../../../shared/display/pipes/date-display.pipe";
+import { Calendar } from "../../calendar/calendar.types";
+import { DateInput } from "../date-input.types";
+import { DateInputSelectionStrategyBase } from "./date-input-selection-strategy-base";
+/**
+ * Selection strategy for the 'day' selection mode.
+ */
+export declare class DaySelectionStrategy extends DateInputSelectionStrategyBase {
+    private dateDisplayPipe;
+    readonly selectionViewMode: Calendar.ViewMode;
+    readonly validViewModes: Calendar.ViewMode[];
+    readonly showSecondaryTextbox = false;
+    readonly showSecondaryCalendar = false;
+    constructor(dateDisplayPipe: DateDisplayPipe);
+    formatSelection(selection?: DateInput.Selection | null): DateInput.TextboxGroup['value'];
+    parseTextboxValues(value: DateInput.TextboxGroup['value'], parseFormats: string[], opts?: DateInput.ParsingOptions): DateInput.Selection | null;
+    getSelectionFromDate(date: Date): DateInput.Selection | null;
+    getNewSelectionFromExisting(previousSelection?: DateInput.Selection | null): DateInput.Selection | null;
+    getNextSelection(selection: DateInput.Selection | null): DateInput.Selection | null;
+    getPreviousSelection(selection: DateInput.Selection | null): DateInput.Selection | null;
+}

package/lib/controls/date-input/date-input-selection-strategies/last-28-days-selection-strategy.d.ts

@@ -0,0 +1,21 @@
+import { Calendar } from "../../calendar/calendar.types";
+import { DateInput } from "../date-input.types";
+import { DateInputSelectionStrategyBase } from "./date-input-selection-strategy-base";
+import { RangeSelectionStrategy } from "./range-selection-strategy";
+/**
+ * Selection strategy for the 'last 28 days' selection mode.
+ */
+export declare class Last28DaysSelectionStrategy extends DateInputSelectionStrategyBase {
+    private rangeStrategy;
+    readonly selectionViewMode: Calendar.ViewMode;
+    readonly validViewModes: Calendar.ViewMode[];
+    readonly showSecondaryTextbox = true;
+    readonly showSecondaryCalendar = false;
+    constructor(rangeStrategy: RangeSelectionStrategy);
+    formatSelection(value?: DateInput.Selection | null): DateInput.TextboxGroup['value'];
+    parseTextboxValues(value: DateInput.TextboxGroup['value'], parseFormats: string[], opts?: DateInput.ParsingOptions): DateInput.Selection | null;
+    getSelectionFromDate(date: Date): DateInput.Selection | null;
+    getNewSelectionFromExisting(previousSelection?: DateInput.Selection): DateInput.Selection | null;
+    getNextSelection(selection: DateInput.Selection | null): DateInput.Selection | null;
+    getPreviousSelection(selection: DateInput.Selection | null): DateInput.Selection | null;
+}

package/lib/controls/date-input/date-input-selection-strategies/last-7-days-selection-strategy.d.ts

@@ -0,0 +1,21 @@
+import { Calendar } from "../../calendar/calendar.types";
+import { DateInput } from "../date-input.types";
+import { DateInputSelectionStrategyBase } from "./date-input-selection-strategy-base";
+import { RangeSelectionStrategy } from "./range-selection-strategy";
+/**
+ * Selection strategy for the 'last 7 days' selection mode.
+ */
+export declare class Last7DaysSelectionStrategy extends DateInputSelectionStrategyBase {
+    private rangeStrategy;
+    readonly selectionViewMode: Calendar.ViewMode;
+    readonly validViewModes: Calendar.ViewMode[];
+    readonly showSecondaryTextbox = true;
+    readonly showSecondaryCalendar = false;
+    constructor(rangeStrategy: RangeSelectionStrategy);
+    formatSelection(value?: DateInput.Selection | null): DateInput.TextboxGroup['value'];
+    parseTextboxValues(value: DateInput.TextboxGroup['value'], parseFormats: string[], opts?: DateInput.ParsingOptions): DateInput.Selection | null;
+    getSelectionFromDate(date: Date): DateInput.Selection | null;
+    getNewSelectionFromExisting(previousSelection?: DateInput.Selection | null): DateInput.Selection | null;
+    getNextSelection(selection: DateInput.Selection | null): DateInput.Selection | null;
+    getPreviousSelection(selection: DateInput.Selection | null): DateInput.Selection | null;
+}

package/lib/controls/date-input/date-input-selection-strategies/month-selection-strategy.d.ts

@@ -0,0 +1,18 @@
+import { Calendar } from "../../calendar/calendar.types";
+import { DateInput } from "../date-input.types";
+import { DateInputSelectionStrategyBase } from "./date-input-selection-strategy-base";
+/**
+ * Selection strategy for the 'month' selection mode.
+ */
+export declare class MonthSelectionStrategy extends DateInputSelectionStrategyBase {
+    readonly selectionViewMode: Calendar.ViewMode;
+    readonly validViewModes: Calendar.ViewMode[];
+    readonly showSecondaryTextbox = false;
+    readonly showSecondaryCalendar = false;
+    formatSelection(selection?: DateInput.Selection | null): DateInput.TextboxGroup['value'];
+    parseTextboxValues(value: DateInput.TextboxGroup['value'], parseFormats: string[], opts?: DateInput.ParsingOptions): DateInput.Selection | null;
+    getSelectionFromDate(date: Date): DateInput.Selection | null;
+    getNewSelectionFromExisting(previousSelection?: DateInput.Selection): DateInput.Selection | null;
+    getNextSelection(selection: DateInput.Selection | null): DateInput.Selection | null;
+    getPreviousSelection(selection: DateInput.Selection | null): DateInput.Selection | null;
+}

package/lib/controls/date-input/date-input-selection-strategies/quarter-selection-strategy.d.ts

@@ -0,0 +1,18 @@
+import { Calendar } from "../../calendar/calendar.types";
+import { DateInput } from "../date-input.types";
+import { DateInputSelectionStrategyBase } from "./date-input-selection-strategy-base";
+/**
+ * Selection strategy for the 'month' selection mode.
+ */
+export declare class QuarterSelectionStrategy extends DateInputSelectionStrategyBase {
+    readonly selectionViewMode: Calendar.ViewMode;
+    readonly validViewModes: Calendar.ViewMode[];
+    readonly showSecondaryTextbox = false;
+    readonly showSecondaryCalendar = false;
+    formatSelection(selection?: DateInput.Selection | null): DateInput.TextboxGroup['value'];
+    parseTextboxValues(value: DateInput.TextboxGroup['value'], parseFormats: string[], opts?: DateInput.ParsingOptions): DateInput.Selection | null;
+    getSelectionFromDate(date: Date): DateInput.Selection | null;
+    getNewSelectionFromExisting(previousSelection?: DateInput.Selection): DateInput.Selection | null;
+    getNextSelection(selection: DateInput.Selection | null): DateInput.Selection | null;
+    getPreviousSelection(selection: DateInput.Selection | null): DateInput.Selection | null;
+}

package/lib/controls/date-input/date-input-selection-strategies/range-selection-strategy.d.ts

@@ -0,0 +1,21 @@
+import { Calendar } from "../../calendar/calendar.types";
+import { DateInput } from "../date-input.types";
+import { DateInputSelectionStrategyBase } from "./date-input-selection-strategy-base";
+/**
+ * Selection strategy for the 'range' selection mode.
+ */
+export declare class RangeSelectionStrategy extends DateInputSelectionStrategyBase {
+    readonly selectionViewMode: Calendar.ViewMode;
+    readonly validViewModes: Calendar.ViewMode[];
+    readonly showSecondaryTextbox = true;
+    readonly showSecondaryCalendar = true;
+    formatSelection(selection?: DateInput.Selection | null): DateInput.TextboxGroup['value'];
+    parseTextboxValues(value: DateInput.TextboxGroup['value'], parseFormats: string[], opts?: DateInput.ParsingOptions): DateInput.Selection | null;
+    getSelectionFromDate(date: Date, existingSelection: DateInput.Selection | null): DateInput.Selection | null;
+    getNewSelectionFromExisting(previousSelection?: DateInput.Selection): DateInput.Selection | null;
+    getSelectionForQuickSelectDate(date: Date, existingSelection?: DateInput.Selection | null): DateInput.Selection | null;
+    getNextSelection(selection: DateInput.Selection | null): DateInput.Selection | null;
+    getPreviousSelection(selection: DateInput.Selection | null): DateInput.Selection | null;
+    getPrimaryCalendarView(selection: DateInput.Selection | null, minDate: Date, maxDate: Date, currentView: Calendar.View): Calendar.View;
+    getSecondaryCalendarView(selection: DateInput.Selection | null, minDate: Date, maxDate: Date, currentView: Calendar.View): Calendar.View;
+}

package/lib/controls/date-input/date-input-selection-strategies/year-selection-strategy.d.ts

@@ -0,0 +1,20 @@
+import { Calendar } from "../../calendar/calendar.types";
+import { DateInput } from "../date-input.types";
+import { DateInputSelectionStrategyBase } from "./date-input-selection-strategy-base";
+/**
+ * Selection strategy for the 'year' selection mode.
+ */
+export declare class YearSelectionStrategy extends DateInputSelectionStrategyBase {
+    readonly selectionViewMode: Calendar.ViewMode;
+    readonly validViewModes: Calendar.ViewMode[];
+    readonly showSecondaryTextbox = false;
+    readonly showSecondaryCalendar = false;
+    formatSelection(selection?: DateInput.Selection | null): DateInput.TextboxGroup['value'];
+    parseString(value: string | null | undefined, parseFormats: string[], opts?: DateInput.ParsingOptions): Date | null;
+    parseTextboxValues(value: DateInput.TextboxGroup['value'], parseFormats: string[], opts?: DateInput.ParsingOptions): DateInput.Selection | null;
+    getSelectionFromDate(date: Date): DateInput.Selection | null;
+    getNewSelectionFromExisting(previousSelection?: DateInput.Selection): DateInput.Selection | null;
+    getSelectionForQuickSelectDate(date: Date): DateInput.Selection | null;
+    getNextSelection(selection: DateInput.Selection): DateInput.Selection | null;
+    getPreviousSelection(selection: DateInput.Selection): DateInput.Selection | null;
+}