igniteui-webcomponents 5.3.0-beta.0 → 5.3.0-beta.2

package/components/button/themes/icon-button/dark/icon-button.material.css.d.ts

@@ -0,0 +1 @@
+export declare const styles: import("lit").CSSResult;

package/components/button/themes/icon-button/icon-button.base.css.d.ts

@@ -0,0 +1 @@
+export declare const styles: import("lit").CSSResult;

package/components/button/themes/icon-button/light/icon-button.bootstrap.css.d.ts

@@ -0,0 +1 @@
+export declare const styles: import("lit").CSSResult;

package/components/button/themes/icon-button/light/icon-button.fluent.css.d.ts

@@ -0,0 +1 @@
+export declare const styles: import("lit").CSSResult;

package/components/button/themes/icon-button/light/icon-button.indigo.css.d.ts

@@ -0,0 +1 @@
+export declare const styles: import("lit").CSSResult;

package/components/button/themes/icon-button/light/icon-button.material.css.d.ts

@@ -0,0 +1 @@
+export declare const styles: import("lit").CSSResult;

package/components/button/themes/icon-button/shared/icon-button.bootstrap.css.d.ts

@@ -0,0 +1 @@
+export declare const styles: import("lit").CSSResult;

package/components/button/themes/icon-button/shared/icon-button.common.css.d.ts

@@ -0,0 +1 @@
+export declare const styles: import("lit").CSSResult;

package/components/button/themes/icon-button/shared/icon-button.fluent.css.d.ts

@@ -0,0 +1 @@
+export declare const styles: import("lit").CSSResult;

package/components/button/themes/icon-button/shared/icon-button.indigo.css.d.ts

@@ -0,0 +1 @@
+export declare const styles: import("lit").CSSResult;

package/components/button/themes/icon-button/shared/icon-button.material.css.d.ts

@@ -0,0 +1 @@
+export declare const styles: import("lit").CSSResult;

package/components/button/themes/icon-button/themes.d.ts

@@ -0,0 +1,2 @@
+import type { Themes } from '../../../../theming/types.js';
+export declare const all: Themes;

package/components/button-group/button-group.d.ts

@@ -0,0 +1,67 @@
+import { LitElement } from 'lit';
+import type { Constructor } from '../common/mixins/constructor.js';
+export interface IgcButtonGroupComponentEventMap {
+    igcSelect: CustomEvent<string | undefined>;
+    igcDeselect: CustomEvent<string | undefined>;
+}
+declare const IgcButtonGroupComponent_base: Constructor<import("../common/mixins/event-emitter.js").EventEmitterInterface<IgcButtonGroupComponentEventMap>> & Constructor<LitElement>;
+/**
+ * The `igc-button-group` groups a series of `igc-toggle-button`s together, exposing features such as layout and selection.
+ *
+ * @element igc-button-group
+ *
+ * @slot - Renders `igc-toggle-button` component.
+ *
+ * @fires igcSelect - Emitted when a button is selected through user interaction.
+ * @fires igcDeselect - Emitted when a button is deselected through user interaction.
+ *
+ * @csspart group - The button group container.
+ */
+export default class IgcButtonGroupComponent extends IgcButtonGroupComponent_base {
+    static readonly tagName = "igc-button-group";
+    static styles: import("lit").CSSResult[];
+    static register(): void;
+    private get isMultiple();
+    private _selectedItems;
+    private _observerCallback;
+    private get _selectedButtons();
+    private toggleButtons;
+    /**
+     * Disables all buttons inside the group.
+     * @attr
+     */
+    disabled: boolean;
+    /**
+     * Sets the orientation of the buttons in the group.
+     * @attr
+     */
+    alignment: 'horizontal' | 'vertical';
+    /**
+     * Controls the mode of selection for the button group.
+     * @attr
+     */
+    selection: 'single' | 'single-required' | 'multiple';
+    /**
+     * Gets/Sets the currently selected buttons (their values).
+     * @attr
+     */
+    get selectedItems(): string[];
+    set selectedItems(values: string[]);
+    protected updateDisabledState(): void;
+    protected updateSelectionState(): void;
+    constructor();
+    protected firstUpdated(): void;
+    private handleClick;
+    private handleSingleSelection;
+    private handleMultipleSelection;
+    private emitSelectEvent;
+    private emitDeselectEvent;
+    private setSelection;
+    protected render(): import("lit-html").TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'igc-button-group': IgcButtonGroupComponent;
+    }
+}
+export {};

package/components/button-group/themes/button.base.css.d.ts

@@ -0,0 +1 @@
+export declare const styles: import("lit").CSSResult;

package/components/button-group/themes/button.d.ts

@@ -0,0 +1,2 @@
+import type { Themes } from '../../../theming/types.js';
+export declare const all: Themes;

package/components/button-group/themes/dark/button-group.bootstrap.css.d.ts

@@ -0,0 +1 @@
+export declare const styles: import("lit").CSSResult;

package/components/button-group/themes/dark/button-group.fluent.css.d.ts

@@ -0,0 +1 @@
+export declare const styles: import("lit").CSSResult;

package/components/button-group/themes/dark/button-group.indigo.css.d.ts

@@ -0,0 +1 @@
+export declare const styles: import("lit").CSSResult;

package/components/button-group/themes/dark/button-group.material.css.d.ts

@@ -0,0 +1 @@
+export declare const styles: import("lit").CSSResult;

package/components/button-group/themes/dark/button-group.shared.css.d.ts

@@ -0,0 +1 @@
+export declare const styles: import("lit").CSSResult;

package/components/button-group/themes/group.base.css.d.ts

@@ -0,0 +1 @@
+export declare const styles: import("lit").CSSResult;

package/components/button-group/themes/group.d.ts

@@ -0,0 +1,2 @@
+import type { Themes } from '../../../theming/types.js';
+export declare const all: Themes;

package/components/button-group/themes/light/button-group.bootstrap.css.d.ts

@@ -0,0 +1 @@
+export declare const styles: import("lit").CSSResult;

package/components/button-group/themes/light/button-group.fluent.css.d.ts

@@ -0,0 +1 @@
+export declare const styles: import("lit").CSSResult;

package/components/button-group/themes/light/button-group.indigo.css.d.ts

@@ -0,0 +1 @@
+export declare const styles: import("lit").CSSResult;

package/components/button-group/themes/light/button-group.material.css.d.ts

@@ -0,0 +1 @@
+export declare const styles: import("lit").CSSResult;

package/components/button-group/themes/light/button-group.shared.css.d.ts

@@ -0,0 +1 @@
+export declare const styles: import("lit").CSSResult;

package/components/button-group/themes/shared/button/button.bootstrap.css.d.ts

@@ -0,0 +1 @@
+export declare const styles: import("lit").CSSResult;

package/components/button-group/themes/shared/button/button.common.css.d.ts

@@ -0,0 +1 @@
+export declare const styles: import("lit").CSSResult;

package/components/button-group/themes/shared/button/button.fluent.css.d.ts

@@ -0,0 +1 @@
+export declare const styles: import("lit").CSSResult;

package/components/button-group/themes/shared/button/button.indigo.css.d.ts

@@ -0,0 +1 @@
+export declare const styles: import("lit").CSSResult;

package/components/button-group/themes/shared/button/button.material.css.d.ts

@@ -0,0 +1 @@
+export declare const styles: import("lit").CSSResult;

package/components/button-group/themes/shared/group/group.bootstrap.css.d.ts

@@ -0,0 +1 @@
+export declare const styles: import("lit").CSSResult;

package/components/button-group/themes/shared/group/group.common.css.d.ts

@@ -0,0 +1 @@
+export declare const styles: import("lit").CSSResult;

package/components/button-group/themes/shared/group/group.fluent.css.d.ts

@@ -0,0 +1 @@
+export declare const styles: import("lit").CSSResult;

package/components/button-group/themes/shared/group/group.indigo.css.d.ts

@@ -0,0 +1 @@
+export declare const styles: import("lit").CSSResult;

package/components/button-group/toggle-button.d.ts

@@ -0,0 +1,51 @@
+import { LitElement } from 'lit';
+/**
+ * The `igc-toggle-button` wraps a native button element and exposes additional `value` and `selected` properties.
+ * It is used in the context of an `igc-button-group` to facilitate the creation of group/toolbar like UX behaviors.
+ *
+ * @element igc-toggle-button
+ *
+ * @slot Renders the label/content of the button.
+ *
+ * @csspart toggle - The native button element.
+ */
+export default class IgcToggleButtonComponent extends LitElement {
+    static styles: import("lit").CSSResult[];
+    static readonly tagName = "igc-toggle-button";
+    static shadowRootOptions: {
+        delegatesFocus: boolean;
+        mode: ShadowRootMode;
+        serializable?: boolean;
+        slotAssignment?: SlotAssignmentMode;
+    };
+    static register(): void;
+    private _kbFocus;
+    private _nativeButton;
+    /**
+     * The value attribute of the control.
+     * @attr
+     */
+    value: string;
+    /**
+     * Determines whether the button is selected.
+     * @attr
+     */
+    selected: boolean;
+    /**
+     * Determines whether the button is disabled.
+     * @attr
+     */
+    disabled: boolean;
+    /** Sets focus on the button. */
+    focus(options?: FocusOptions): void;
+    /** Removes focus from the button. */
+    blur(): void;
+    /** Simulates a mouse click on the element. */
+    click(): void;
+    protected render(): import("lit-html").TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'igc-toggle-button': IgcToggleButtonComponent;
+    }
+}

package/components/calendar/base.d.ts

@@ -0,0 +1,65 @@
+import { LitElement } from 'lit';
+import { CalendarDay } from './model.js';
+import type { DateRangeDescriptor, WeekDays } from './types.js';
+export declare class IgcCalendarBaseComponent extends LitElement {
+    private _initialActiveDateSet;
+    protected get _hasValues(): boolean;
+    protected get _isSingle(): boolean;
+    protected get _isMultiple(): boolean;
+    protected get _isRange(): boolean;
+    protected _rangePreviewDate?: CalendarDay;
+    protected _firstDayOfWeek: number;
+    protected _activeDate: CalendarDay;
+    protected _value: CalendarDay | null;
+    protected _values: CalendarDay[];
+    protected _specialDates: DateRangeDescriptor[];
+    protected _disabledDates: DateRangeDescriptor[];
+    /**
+     * The current value of the calendar.
+     * Used when selection is set to single
+     *
+     * @attr value
+     */
+    set value(value: Date | string | null | undefined);
+    get value(): Date | null;
+    /**
+     * The current values of the calendar.
+     * Used when selection is set to multiple of range.
+     *
+     * @attr values
+     */
+    set values(values: (Date | string)[] | string | null | undefined);
+    get values(): Date[];
+    /** Get/Set the date which is shown in view and is highlighted. By default it is the current date. */
+    set activeDate(value: Date | string | null | undefined);
+    get activeDate(): Date;
+    /**
+     * Sets the type of selection in the component.
+     * @attr selection
+     */
+    selection: 'single' | 'multiple' | 'range';
+    /**
+     * Whether to show the week numbers.
+     * @attr show-week-numbers
+     */
+    showWeekNumbers: boolean;
+    /**
+     * Gets/Sets the first day of the week.
+     * @attr week-start
+     */
+    weekStart: WeekDays;
+    /**
+     * Gets/Sets the locale used for formatting and displaying the dates in the component.
+     * @attr locale
+     */
+    locale: string;
+    /** Gets/Sets the special dates for the component. */
+    set specialDates(value: DateRangeDescriptor[]);
+    get specialDates(): DateRangeDescriptor[] | undefined;
+    /** Gets/Sets the disabled dates for the component. */
+    set disabledDates(value: DateRangeDescriptor[]);
+    get disabledDates(): DateRangeDescriptor[] | undefined;
+    protected weekStartChanged(): void;
+    protected selectionChanged(): void;
+    protected firstUpdated(): void;
+}

package/components/calendar/calendar.d.ts

@@ -0,0 +1,154 @@
+import { nothing } from 'lit';
+import type { Constructor } from '../common/mixins/constructor.js';
+import { IgcCalendarBaseComponent } from './base.js';
+import { CalendarDay } from './model.js';
+import type { IgcCalendarComponentEventMap } from './types.js';
+export declare const focusActiveDate: unique symbol;
+declare const IgcCalendarComponent_base: Constructor<import("../common/mixins/event-emitter.js").EventEmitterInterface<IgcCalendarComponentEventMap>> & Constructor<IgcCalendarBaseComponent>;
+/**
+ * Represents a calendar that lets users
+ * to select a date value in a variety of different ways.
+ *
+ * @element igc-calendar
+ *
+ * @slot - The default slot for the calendar.
+ * @slot title - Renders the title of the calendar header.
+ * @slot header-date - Renders content instead of the current date/range in the calendar header.
+ *
+ * @fires igcChange - Emitted when calendar changes its value.
+ *
+ * @csspart header - The header element of the calendar.
+ * @csspart header-title - The header title element of the calendar.
+ * @csspart header-date - The header date element of the calendar.
+ * @csspart content - The content element which contains the views and navigation elements of the calendar.
+ * @csspart navigation - The navigation container element of the calendar.
+ * @csspart months-navigation - The months navigation button element of the calendar.
+ * @csspart years-navigation - The years navigation button element of the calendar.
+ * @csspart years-range - The years range element of the calendar.
+ * @csspart navigation-buttons - The navigation buttons container of the calendar.
+ * @csspart navigation-button - Previous/next navigation button of the calendar.
+ * @csspart days-view-container - The days view container element of the calendar.
+ * @csspart days-view - Days view element of the calendar.
+ * @csspart months-view - The months view element of the calendar.
+ * @csspart years-view - The years view element of the calendar.
+ * @csspart days-row - Days row element of the calendar.
+ * @csspart label - Week header label element of the calendar.
+ * @csspart week-number - Week number element of the calendar.
+ * @csspart week-number-inner - Week number inner element of the calendar.
+ * @csspart date - Date element of the calendar.
+ * @csspart date-inner - Date inner element of the calendar.
+ * @csspart first - The first selected date element of the calendar in range selection.
+ * @csspart last - The last selected date element of the calendar in range selection.
+ * @csspart inactive - Inactive date element of the calendar.
+ * @csspart hidden - Hidden date element of the calendar.
+ * @csspart weekend - Weekend date element of the calendar.
+ * @csspart range - Range selected element of the calendar.
+ * @csspart special - Special date element of the calendar.
+ * @csspart disabled - Disabled date element of the calendar.
+ * @csspart single - Single selected date element of the calendar.
+ * @csspart preview - Range selection preview date element of the calendar.
+ * @csspart month - Month element of the calendar.
+ * @csspart month-inner - Month inner element of the calendar.
+ * @csspart year - Year element of the calendar.
+ * @csspart year-inner - Year inner element of the calendar.
+ * @csspart selected - Indicates selected state. Applies to date, month and year elements of the calendar.
+ * @csspart current - Indicates current state. Applies to date, month and year elements of the calendar.
+ */
+export default class IgcCalendarComponent extends IgcCalendarComponent_base {
+    static readonly tagName = "igc-calendar";
+    static styles: import("lit").CSSResult;
+    static register(): void;
+    private get _isDayView();
+    private get _isMonthView();
+    private get _isYearView();
+    private get previousButtonLabel();
+    private get nextButtonLabel();
+    private contentRef;
+    private activeDaysViewIndex;
+    private daysViews;
+    private monthsView;
+    private yearsView;
+    /**
+     * Whether to show the dates that do not belong to the current active month.
+     * @attr hide-outside-days
+     */
+    hideOutsideDays: boolean;
+    /**
+     * Whether to render the calendar header part.
+     * When the calendar selection is set to `multiple` the header is always hidden.
+     *
+     * @attr hide-header
+     */
+    hideHeader: boolean;
+    /**
+     * The orientation of the calendar header.
+     * @attr header-orientation
+     */
+    headerOrientation: 'vertical' | 'horizontal';
+    /**
+     * The orientation of the calendar months when more than one month
+     * is being shown.
+     * @attr orientation
+     */
+    orientation: 'vertical' | 'horizontal';
+    /**
+     * The number of months displayed in the days view.
+     * @attr visible-months
+     */
+    visibleMonths: number;
+    /**
+     * The current active view of the component.
+     * @attr active-view
+     */
+    activeView: 'days' | 'months' | 'years';
+    /** The options used to format the months and the weekdays in the calendar views. */
+    formatOptions: Pick<Intl.DateTimeFormatOptions, 'month' | 'weekday'>;
+    /**
+     * The resource strings for localization.
+     */
+    resourceStrings: import("../common/i18n/calendar.resources.js").IgcCalendarResourceStrings;
+    private _intl;
+    protected localeChange(): void;
+    protected formatOptionsChange(): void;
+    /** @private @hidden @internal */
+    [focusActiveDate](): Promise<void>;
+    private updateViewIndex;
+    private getSubsequentActiveDate;
+    private handleArrowKey;
+    private onPageKeys;
+    private onShiftPageKeys;
+    private onHomeKey;
+    private onEndKey;
+    private isNotFromCalendarView;
+    constructor();
+    protected renderNavigationButtons(): import("lit-html").TemplateResult<1>;
+    protected renderMonthButtonNavigation(active: CalendarDay, viewIndex: number): import("lit-html").TemplateResult<1>;
+    protected renderYearButtonNavigation(active: CalendarDay, viewIndex: number): import("lit-html").TemplateResult<1>;
+    protected renderYearRangeNavigation(active: CalendarDay): import("lit-html").TemplateResult<1>;
+    protected renderNavigation(date?: CalendarDay, showButtons?: boolean, viewIndex?: number): import("lit-html").TemplateResult<1>;
+    protected renderHeader(): import("lit-html").TemplateResult<1> | typeof nothing;
+    protected renderHeaderDateSingle(): import("lit-html").TemplateResult<1>;
+    protected renderHeaderDateRange(): import("lit-html").TemplateResult<1>;
+    protected renderHeaderDate(): import("lit-html").TemplateResult<1>;
+    protected renderDaysView(): import("lit-html").TemplateResult<1>;
+    protected renderMonthView(): import("lit-html").TemplateResult<1>;
+    protected renderYearView(): import("lit-html").TemplateResult<1>;
+    protected render(): import("lit-html").TemplateResult<1>;
+    protected changeMonth(event: CustomEvent<Date>): void;
+    protected changeYear(event: CustomEvent<Date>): void;
+    protected changeValue(event: CustomEvent<Date>): void;
+    protected activeDateChanged(event: CustomEvent<Date>): void;
+    protected rangePreviewDateChanged(event: CustomEvent<Date>): void;
+    private getActiveDates;
+    private activateDaysView;
+    private navigatePrevious;
+    private navigateNext;
+    private switchToMonths;
+    private switchToYears;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'igc-calendar': IgcCalendarComponent;
+    }
+}
+export {};

package/components/calendar/days-view/days-view.d.ts

@@ -0,0 +1,87 @@
+import type { Constructor } from '../../common/mixins/constructor.js';
+import { IgcCalendarBaseComponent } from '../base.js';
+import { CalendarDay } from '../model.js';
+import { type IgcCalendarComponentEventMap } from '../types.js';
+export interface IgcDaysViewEventMap extends IgcCalendarComponentEventMap {
+    igcActiveDateChange: CustomEvent<Date>;
+    igcRangePreviewDateChange: CustomEvent<Date>;
+}
+declare const IgcDaysViewComponent_base: Constructor<import("../../common/mixins/event-emitter.js").EventEmitterInterface<IgcDaysViewEventMap>> & Constructor<IgcCalendarBaseComponent>;
+/**
+ * Instantiate a days view as a separate component in the calendar.
+ *
+ * @element igc-days-view
+ *
+ * @fires igcActiveDateChange - Emitted when the active date changes.
+ * @fires igcRangePreviewDateChange - Emitted when the range preview date changes.
+ *
+ * @csspart days-row - The days row container.
+ * @csspart label - The label container.
+ * @csspart label-inner - The inner label container.
+ * @csspart week-number - The week number container.
+ * @csspart week-number-inner - The inner week number container.
+ */
+export default class IgcDaysViewComponent extends IgcDaysViewComponent_base {
+    static readonly tagName = "igc-days-view";
+    static styles: import("lit").CSSResult;
+    static register(): void;
+    private dates;
+    private activeDay;
+    /** The active state of the component. */
+    active: boolean;
+    /**
+     * Whether to show leading days which do not belong to the current month.
+     * @attr hide-leading-days
+     */
+    hideLeadingDays: boolean;
+    /**
+     * Whether to show trailing days which do not belong to the current month.
+     * @attr hide-trailing-days
+     */
+    hideTrailingDays: boolean;
+    /** The range preview date. */
+    set rangePreviewDate(value: Date | undefined);
+    get rangePreviewDate(): Date | undefined;
+    /** The resource strings. */
+    resourceStrings: import("../../common/i18n/calendar.resources.js").IgcCalendarResourceStrings;
+    /**
+     * The format of the days. Defaults to narrow.
+     * @attr week-day-format
+     */
+    weekDayFormat: 'long' | 'short' | 'narrow';
+    private _intl;
+    protected localeChange(): void;
+    protected weekDayFormatChange(): void;
+    protected datesChange(): void;
+    constructor();
+    connectedCallback(): void;
+    /** Focuses the active date. */
+    focusActiveDate(): void;
+    protected handleInteraction(event: Event): void;
+    private _selectMultiple;
+    private _selectRange;
+    private selectDate;
+    private isSelected;
+    private setRangePreviewDate;
+    private changeRangePreview;
+    private clearRangePreview;
+    private isFirstInRange;
+    private isLastInRange;
+    private isRangeDate;
+    private isRangePreview;
+    private intlFormatDay;
+    private getDayHandlers;
+    private getDayProperties;
+    protected renderDay(day: CalendarDay, today: CalendarDay): import("lit-html").TemplateResult<1>;
+    protected renderHeaderWeekNumber(): import("lit-html").TemplateResult<1>;
+    protected renderWeekNumber(start: CalendarDay, last: boolean): import("lit-html").TemplateResult<1>;
+    protected renderHeaders(): import("lit-html").TemplateResult<1>;
+    protected renderWeeks(): Generator<import("lit-html").TemplateResult<1>, void, unknown>;
+    protected render(): import("lit-html").TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'igc-days-view': IgcDaysViewComponent;
+    }
+}
+export {};

package/components/calendar/helpers.d.ts

@@ -0,0 +1,55 @@
+import { CalendarDay, type CalendarRangeParams, type DayParameter } from './model.js';
+import { type DateRangeDescriptor, type WeekDays } from './types.js';
+export declare const MONTHS_PER_ROW = 3;
+export declare const YEARS_PER_ROW = 3;
+export declare const YEARS_PER_PAGE = 15;
+export declare function isValidDate(date: Date): Date | null;
+export declare function parseISODate(string: string): Date | null;
+/**
+ * Converts the given value to a Date object.
+ *
+ * If the value is already a valid Date object, it is returned directly.
+ * If the value is a string, it is parsed into a Date object.
+ * If the value is null or undefined, null is returned.
+ * If the parsing fails, null is returned.
+ */
+export declare function convertToDate(value?: Date | string | null): Date | null;
+/**
+ * Converts a Date object to an ISO 8601 string.
+ *
+ * If the `value` is a `Date` object, it is converted to an ISO 8601 string.
+ * If the `value` is null or undefined, null is returned.
+ */
+export declare function getDateFormValue(value: Date | null): string | null;
+/**
+ * Converts a comma-separated string of ISO 8601 dates or an array of Date objects | ISO 8601 strings into
+ * an array of Date objects.
+ *
+ * If the `value` is null or undefined, null is returned.
+ * If the `value` is an array of `Date` objects, a filtered array of valid `Date` objects is returned.
+ * If the `value` is a string, it is split by commas and each part is parsed into a `Date` object.
+ * If the parsing fails for any date, it is skipped.
+ */
+export declare function convertToDates(value?: (Date | string)[] | string | null): Date[] | null;
+/**
+ * Returns the value of the selected/activated element (day/month/year) in the calendar view.
+ */
+export declare function getViewElement(event: Event): number;
+export declare function getWeekDayNumber(value: WeekDays): number;
+export declare function areSameMonth(first: DayParameter, second: DayParameter): boolean;
+export declare function isNextMonth(target: DayParameter, origin: DayParameter): boolean;
+export declare function isPreviousMonth(target: DayParameter, origin: DayParameter): boolean;
+/**
+ * Returns a generator yielding day values between `start` and `end` (non-inclusive)
+ * by a given `unit` as a step.
+ *
+ * @remarks
+ * By default, `unit` is set to 'day'.
+ */
+export declare function calendarRange(options: CalendarRangeParams): Generator<CalendarDay, void, unknown>;
+export declare function generateMonth(value: DayParameter, firstWeekDay: number): Generator<CalendarDay, void, unknown>;
+export declare function getYearRange(current: DayParameter, range: number): {
+    start: number;
+    end: number;
+};
+export declare function isDateInRanges(date: DayParameter, ranges: DateRangeDescriptor[]): boolean;

package/components/calendar/model.d.ts

@@ -0,0 +1,55 @@
+export type DayParameter = CalendarDay | Date;
+export type CalendarRangeParams = {
+    start: DayParameter;
+    end: DayParameter | number;
+    unit?: DayInterval;
+};
+type DayInterval = 'year' | 'quarter' | 'month' | 'week' | 'day';
+type CalendarDayParams = {
+    year: number;
+    month: number;
+    date?: number;
+};
+export declare const daysInWeek = 7;
+export declare function toCalendarDay(date: DayParameter): CalendarDay;
+export declare class CalendarDay {
+    private _date;
+    /** Constructs and returns the current day. */
+    static get today(): CalendarDay;
+    /** Constructs a new CalendarDay instance from a Date object. */
+    static from(date: Date): CalendarDay;
+    constructor(args: CalendarDayParams);
+    /** Returns a copy of this instance. */
+    clone(): CalendarDay;
+    /**
+     * Returns a new instance with values replaced.
+     */
+    set(args: Partial<CalendarDayParams>): CalendarDay;
+    add(unit: DayInterval, value: number): CalendarDay;
+    /** Returns the day of the week (Sunday = 0). */
+    get day(): number;
+    /** Returns the full year. */
+    get year(): number;
+    /** Returns the month. */
+    get month(): number;
+    /** Returns the date */
+    get date(): number;
+    /** Returns the timestamp since epoch in milliseconds. */
+    get timestamp(): number;
+    /** Returns the current week number. */
+    get week(): number;
+    /** Returns the underlying native date instance. */
+    get native(): Date;
+    /**
+     * Whether the current date is a weekend day.
+     *
+     * @remarks
+     * This is naive, since it does not account for locale specifics.
+     */
+    get weekend(): boolean;
+    equalTo(value: DayParameter): boolean;
+    greaterThan(value: DayParameter): boolean;
+    lessThan(value: DayParameter): boolean;
+    toString(): string;
+}
+export {};