@siemens/element-ng 47.2.0 → 47.4.0

package/datepicker/si-datepicker-overlay.component.d.ts

@@ -0,0 +1,82 @@
+import { AfterViewInit, OnChanges, OnDestroy, OnInit, SimpleChanges } from '@angular/core';
+import { Cell } from './components/si-calendar-body.component';
+import { SiDatepickerComponent } from './si-datepicker.component';
+import { DatepickerConfig, DateRange } from './si-datepicker.model';
+import * as i0 from "@angular/core";
+export declare class SiDatepickerOverlayComponent implements OnChanges, OnInit, AfterViewInit, OnDestroy {
+    protected readonly minMonth: import("@angular/core").WritableSignal<Date | undefined>;
+    protected readonly maxMonth: import("@angular/core").WritableSignal<Date | undefined>;
+    protected readonly datepicker: import("@angular/core").Signal<SiDatepickerComponent>;
+    /**
+     * {@inheritDoc SiDatepickerComponent#initialFocus}
+     * @defaultValue false
+     */
+    readonly initialFocus: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+    /**
+     * {@inheritDoc SiDatepickerComponent#config}
+     * @defaultValue
+     * ```
+     * {}
+     * ```
+     */
+    readonly config: import("@angular/core").InputSignal<DatepickerConfig>;
+    /**
+     * {@inheritDoc SiDatepickerComponent#date}
+     */
+    readonly date: import("@angular/core").ModelSignal<Date | undefined>;
+    /**
+     * {@inheritDoc SiDatepickerComponent#dateRange}
+     */
+    readonly dateRange: import("@angular/core").ModelSignal<DateRange | undefined>;
+    /**
+     * {@inheritDoc SiDatepickerComponent#rangeType}
+     */
+    readonly rangeType: import("@angular/core").ModelSignal<"START" | "END" | undefined>;
+    /**
+     * {@inheritDoc SiDatepickerComponent#time12h}
+     * @defaultValue false
+     */
+    readonly time12h: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+    /**
+     * Emits an event to notify about disabling the time from the datepicker.
+     * When time is disable, we construct a pure date object in UTC 00:00:00 time.
+     */
+    readonly disabledTimeChange: import("@angular/core").OutputEmitterRef<boolean>;
+    /**
+     * @deprecated Property provides internal information that should not be used.
+     *
+     * @defaultValue false
+     */
+    isFocused: boolean;
+    private readonly document;
+    private readonly elementRef;
+    private readonly focusMonitor;
+    private readonly focusTrapFactory;
+    private focusTrap;
+    private previousActiveElement?;
+    protected disableTime: boolean;
+    protected activeHover?: Cell;
+    protected readonly isTwoMonthDateRange: import("@angular/core").Signal<boolean>;
+    protected readonly firstDatepickerConfig: import("@angular/core").WritableSignal<DatepickerConfig>;
+    protected readonly secondDatepickerConfig: import("@angular/core").WritableSignal<DatepickerConfig>;
+    /**
+     * Indicate that the overlay is opened in small screen.
+     * A modal dialog animation display when true and a wrapped two month calendar layout is displayed.
+     *
+     * @defaultValue false
+     */
+    readonly isMobile: import("@angular/core").InputSignal<boolean>;
+    protected readonly completeAnimation: import("@angular/core").WritableSignal<boolean>;
+    ngOnChanges(changes: SimpleChanges): void;
+    ngOnInit(): void;
+    ngAfterViewInit(): void;
+    ngOnDestroy(): void;
+    /**
+     * Focus active cell in the current datepicker view.
+     */
+    focusActiveCell(): void;
+    protected firstDatepickerFocusDateChange(newFocusedDate?: Date): void;
+    protected secondDatepickerFocusDateChange(newFocusedDate?: Date): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SiDatepickerOverlayComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SiDatepickerOverlayComponent, "si-datepicker-overlay", never, { "initialFocus": { "alias": "initialFocus"; "required": false; "isSignal": true; }; "config": { "alias": "config"; "required": false; "isSignal": true; }; "date": { "alias": "date"; "required": false; "isSignal": true; }; "dateRange": { "alias": "dateRange"; "required": false; "isSignal": true; }; "rangeType": { "alias": "rangeType"; "required": false; "isSignal": true; }; "time12h": { "alias": "time12h"; "required": false; "isSignal": true; }; "isMobile": { "alias": "isMobile"; "required": false; "isSignal": true; }; }, { "date": "dateChange"; "dateRange": "dateRangeChange"; "rangeType": "rangeTypeChange"; "disabledTimeChange": "disabledTimeChange"; }, never, never, true, never>;
+}

package/datepicker/si-datepicker-overlay.directive.d.ts

@@ -0,0 +1,104 @@
+import { ConnectionPositionPair } from '@angular/cdk/overlay';
+import { ComponentRef, OnDestroy } from '@angular/core';
+import { SiDatepickerOverlayComponent } from './si-datepicker-overlay.component';
+import { DatepickerConfig, DateRange } from './si-datepicker.model';
+import * as i0 from "@angular/core";
+export declare enum CloseCause {
+    Backdrop = "backdrop",
+    Detach = "detach",
+    Escape = "escape",
+    Select = "select"
+}
+export type DatepickerInput = {
+    config: DatepickerConfig;
+    date: Date;
+    dateRange: DateRange;
+    rangeType: 'START' | 'END';
+    time12h: boolean;
+    showTime: true;
+};
+/** Partial datepicker inputs */
+export type DatepickerInputPartial = Partial<DatepickerInput>;
+/**
+ * Directive with the responsibility to open/close datepicker overlay.
+ */
+export declare class SiDatepickerOverlayDirective implements OnDestroy {
+    /**
+     * Position of the datepicker overlay. Accepts an array of positions or a single position.
+     * The position will be chosen based on the first position that fits into the viewport.
+     * The input is necessary since the positions between the siDatepicker directive and si-date-range
+     * component are different.
+     * @internal
+     */
+    readonly placement: import("@angular/core").WritableSignal<"auto" | "top" | "start" | "end" | "bottom" | ConnectionPositionPair[]>;
+    /**
+     * Output event on closing datepicker e.g. by clicking backdrop or escape key.
+     */
+    readonly siDatepickerClose: import("@angular/core").OutputEmitterRef<CloseCause>;
+    private overlayRef?;
+    private datepickerRef?;
+    private autoCloseSelection;
+    /** Guard for siDatepickerClose event emitter to make sure the cause is emitter just once */
+    private ignoreClose;
+    private readonly overlay;
+    private readonly triggerElementRef;
+    private readonly mediaMatcher;
+    private readonly breakpointObserver;
+    private readonly destroyRef;
+    /**
+     * When the media query matches on open the overlay is displayed like a modal dialog.
+     * In case, users change the screen size to the matching media query we close the overlay
+     * if it is open with a connected overlay strategy.
+     */
+    private readonly smallScreenQuery;
+    ngOnDestroy(): void;
+    /**
+     * Toggle open/close overlay.
+     * @param focus - move focus to the datepicker.
+     * @param inputs - for datepicker.
+     * @returns create datepicker overlay instance or undefined
+     *
+     * @deprecated Use {@link showOverlay} or {@link closeOverlay} instead.
+     */
+    toggleOverlay(focus: boolean, inputs?: DatepickerInputPartial): ComponentRef<SiDatepickerOverlayComponent> | undefined;
+    /**
+     * Show datepicker overlay.
+     * @param focus - move focus to the datepicker.
+     * @returns create datepicker overlay instance
+     */
+    showOverlay(focus?: boolean, inputs?: DatepickerInputPartial): ComponentRef<SiDatepickerOverlayComponent>;
+    /**
+     * Close datepicker.
+     */
+    closeOverlay(): undefined;
+    /**
+     * Focus active cell in datepicker.
+     * @param focus - show transfer focus.
+     * @returns current instance.
+     */
+    focus(focus?: boolean): this;
+    /** @deprecated Property provides internal information that should not be used. */
+    isFocused(): boolean;
+    /**
+     * Indicate the datepicker is visible.
+     * @returns is visible.
+     */
+    isShown(): ComponentRef<SiDatepickerOverlayComponent> | undefined;
+    /** Set datepicker inputs */
+    setInputs(inputs?: DatepickerInputPartial): this;
+    /** Close overlay with cause select, which will recover the focus */
+    closeAfterSelection(): void;
+    /** Indicate whether the HTML element is a child of the datepicker overlay. */
+    contains(element: HTMLElement): boolean;
+    private showDatepicker;
+    protected createMobileOverlay(): void;
+    protected createDesktopOverlay(): void;
+    /**
+     * Merge events which shall close the overlay
+     * @param overlayRef - source for backdrop, detach or escape events.
+     * @returns merged observable
+     */
+    private closeStream;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SiDatepickerOverlayDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<SiDatepickerOverlayDirective, "[siDatepickerOverlay]", ["siDatepickerOverlay"], {}, { "siDatepickerClose": "siDatepickerClose"; }, never, never, true, never>;
+}

package/datepicker/si-datepicker.component.d.ts

@@ -0,0 +1,228 @@
+import { AfterViewInit, OnChanges, OnInit, SimpleChanges } from '@angular/core';
+import { TranslatableString } from '@siemens/element-translate-ng/translate';
+import { Cell } from './components/si-calendar-body.component';
+import { DatepickerConfig, DateRange, WeekStart } from './si-datepicker.model';
+import * as i0 from "@angular/core";
+/**
+ * Choose which view shall be shown.
+ * @internal
+ */
+type ViewType = 'week' | 'month' | 'year' | undefined;
+export type RangeType = 'START' | 'END' | undefined;
+export declare class SiDatepickerComponent implements OnInit, OnChanges, AfterViewInit {
+    private readonly locale;
+    /**
+     * The date which is currently focused
+     * Compare to the selected date or range the calendar requires to have one element to focus.
+     */
+    readonly focusedDate: import("@angular/core").ModelSignal<Date | undefined>;
+    /**
+     * The selected date of the datepicker. Use for
+     * initialization and for bidirectional binding.
+     */
+    readonly date: import("@angular/core").ModelSignal<Date | undefined>;
+    /**
+     * The selected date range of the datepicker. Use for
+     * initialization and for bidirectional binding.
+     */
+    readonly dateRange: import("@angular/core").ModelSignal<DateRange | undefined>;
+    /** @internal */
+    readonly dateRangeRole: import("@angular/core").InputSignal<RangeType>;
+    /**
+     * Set initial focus to calendar body.
+     *
+     * @defaultValue false
+     */
+    readonly initialFocus: import("@angular/core").InputSignal<boolean>;
+    /**
+     * Disabled the optional visible time picker.
+     *
+     * @defaultValue false
+     */
+    readonly disabledTime: import("@angular/core").ModelSignal<boolean>;
+    /**
+     * Object to configure the datepicker.
+     *
+     * @defaultValue
+     * ```
+     * {}
+     * ```
+     */
+    readonly config: import("@angular/core").ModelSignal<DatepickerConfig>;
+    /**
+     * Aria label for the previous button. Needed for a11y.
+     *
+     * @defaultValue
+     * ```
+     * $localize`:@@SI_DATEPICKER.PREVIOUS:Previous`
+     * ```
+     */
+    readonly previousLabel: import("@angular/core").InputSignal<TranslatableString>;
+    /**
+     * Aria label for the next button. Needed for a11y.
+     *
+     * @defaultValue
+     * ```
+     * $localize`:@@SI_DATEPICKER.NEXT:Next`
+     * ```
+     */
+    readonly nextLabel: import("@angular/core").InputSignal<TranslatableString>;
+    /**
+     * Aria label for week number column
+     *
+     * @defaultValue
+     * ```
+     * $localize`:@@SI_DATEPICKER.CALENDAR_WEEK_LABEL:Calendar week`
+     * ```
+     */
+    readonly calenderWeekLabel: import("@angular/core").InputSignal<TranslatableString>;
+    /**
+     * Enable/disable 12H mode in timepicker. Defaults to locale
+     *
+     * @defaultValue undefined
+     */
+    readonly time12h: import("@angular/core").InputSignalWithTransform<boolean | undefined, unknown>;
+    /**
+     * Use this to force date range operation to select either start date or end date.
+     *
+     * @defaultValue 'START'
+     */
+    readonly rangeType: import("@angular/core").ModelSignal<RangeType>;
+    /**
+     * Optional input to control the minimum month the datepicker can show and the user can navigate.
+     * The `minMonth` can be larger than the `minDate` This option enables the usage of multiple
+     * datepickers next to each other while the more left calendar always
+     * shows a earlier month the the more right one.
+     * @internal
+     */
+    readonly minMonth: import("@angular/core").InputSignal<Date | undefined>;
+    /**
+     * Optional input to control the maximum month the datepicker can show and the user can navigate.
+     * The `maxMonth` can be smaller than the `maxDate` This option enables the usage of multiple
+     * datepickers next to each other while the more left calendar always
+     * shows a earlier month the the more right one.
+     * @internal
+     */
+    readonly maxMonth: import("@angular/core").InputSignal<Date | undefined>;
+    /**
+     * Option to hide the time switch.
+     *
+     * @defaultValue false
+     */
+    readonly hideTimeToggle: import("@angular/core").InputSignal<boolean>;
+    /** @internal */
+    readonly hideCalendar: import("@angular/core").InputSignal<boolean>;
+    /**
+     * Optional timepicker label.
+     */
+    readonly timepickerLabel: import("@angular/core").InputSignal<string | undefined>;
+    protected get startDate(): Date | undefined;
+    protected get endDate(): Date | undefined;
+    /**
+     * Returns the date object if not range selection is enabled. Otherwise, if
+     * the date range role is 'END', the date range end date is returned. If
+     * date range role is not 'END', the date range start date is returned.
+     */
+    private getRelevantDate;
+    private readonly defaultDisabledTimeText;
+    private readonly defaultEnableTimeText;
+    protected readonly includeTimeLabel: import("@angular/core").Signal<TranslatableString>;
+    protected get weekStartDay(): WeekStart;
+    protected get hideWeekNumbers(): boolean;
+    /**
+     * The active view
+     */
+    protected readonly view: import("@angular/core").WritableSignal<ViewType>;
+    /**
+     * Get the current shown view.
+     */
+    private readonly activeView;
+    protected readonly actualFocusedDate: import("@angular/core").Signal<Date>;
+    protected readonly requireFocus: import("@angular/core").WritableSignal<boolean>;
+    /** When the user switch from the year or month view via keyboard selection we force the focus. */
+    protected readonly forceFocus: import("@angular/core").Signal<boolean>;
+    protected months: string[];
+    protected switchId: string;
+    protected timepickerId: string;
+    /**
+     * Configuration which view shall be shown after year selection,
+     * when onlyMonthSelection is enabled the month view is shown otherwise the week view.
+     */
+    protected yearViewSwitchTo: 'month' | 'week';
+    protected monthViewSwitchTo: 'month' | 'week';
+    private readonly cdRef;
+    private readonly localeWeekStart;
+    /**
+     * Date object to track and change the time. Keeping time and date
+     * in separate objects to not change the date when flipping time.
+     * After change, a new date object is created with an adapted time.
+     */
+    protected time?: Date;
+    /**
+     * Used to hold the last time when setting the time to disabled.
+     * Value will be reset on enabling the time again.
+     */
+    private previousTime?;
+    private readonly timePicker;
+    /** Reference to the current day selection component. Shown when view === 'week' */
+    private readonly daySelection;
+    /** Reference to the current month selection component. Shown when view === 'month' */
+    private readonly monthSelection;
+    /** Reference to the current year selection component. Shown when view === 'year' */
+    private readonly yearSelection;
+    /**
+     * The cell which which has the mouse hover.
+     * @internal
+     */
+    readonly activeHover: import("@angular/core").ModelSignal<Cell | undefined>;
+    constructor();
+    ngOnChanges(changes: SimpleChanges): void;
+    ngOnInit(): void;
+    ngAfterViewInit(): void;
+    /** Initialize day and month labels */
+    private initCalendarLabels;
+    /**
+     * Validates and sets a new date to the this.date model object of this component
+     * and fires the related events. The model object shall not be updated elsewhere
+     * with a new date object. Shall only be called on simple date selection and not
+     * on date range selection.
+     *
+     * @param newDate - The new date to be set.
+     */
+    private setDate;
+    /**
+     * Validates and sets the new date range to the dateRange model
+     * object.
+     * @param newDateRange - The new range to be set.
+     * @returns True if the new range is valid and set. Otherwise false.
+     */
+    private setDateRange;
+    protected timeSelected(newTime: Date): void;
+    protected toggleDisabledTime(): void;
+    private onDisabledTimeChanged;
+    private validateTime;
+    /**
+     * Handle selection in the day view.
+     * @param selection - selected date.
+     */
+    protected selectionChange(selection: Date): void;
+    /**
+     * Handle month/year changes
+     * @param selection - the selected month or null of cancelled.
+     */
+    protected activeMonthChange(selection: Date | null): void;
+    /**
+     * Handle year changes
+     * @param selection - the selected year or null of cancelled.
+     */
+    protected activeYearChange(selection: Date | null): void;
+    /**
+     * Focus the active cell in view.
+     * The function is required to transfer the focus from input to the active date cell.
+     */
+    focusActiveCell(): void;
+    protected onActiveHoverChange(event?: Cell): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SiDatepickerComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SiDatepickerComponent, "si-datepicker", never, { "focusedDate": { "alias": "focusedDate"; "required": false; "isSignal": true; }; "date": { "alias": "date"; "required": false; "isSignal": true; }; "dateRange": { "alias": "dateRange"; "required": false; "isSignal": true; }; "dateRangeRole": { "alias": "dateRangeRole"; "required": false; "isSignal": true; }; "initialFocus": { "alias": "initialFocus"; "required": false; "isSignal": true; }; "disabledTime": { "alias": "disabledTime"; "required": false; "isSignal": true; }; "config": { "alias": "config"; "required": false; "isSignal": true; }; "previousLabel": { "alias": "previousLabel"; "required": false; "isSignal": true; }; "nextLabel": { "alias": "nextLabel"; "required": false; "isSignal": true; }; "calenderWeekLabel": { "alias": "calenderWeekLabel"; "required": false; "isSignal": true; }; "time12h": { "alias": "time12h"; "required": false; "isSignal": true; }; "rangeType": { "alias": "rangeType"; "required": false; "isSignal": true; }; "minMonth": { "alias": "minMonth"; "required": false; "isSignal": true; }; "maxMonth": { "alias": "maxMonth"; "required": false; "isSignal": true; }; "hideTimeToggle": { "alias": "hideTimeToggle"; "required": false; "isSignal": true; }; "hideCalendar": { "alias": "hideCalendar"; "required": false; "isSignal": true; }; "timepickerLabel": { "alias": "timepickerLabel"; "required": false; "isSignal": true; }; "activeHover": { "alias": "activeHover"; "required": false; "isSignal": true; }; }, { "focusedDate": "focusedDateChange"; "date": "dateChange"; "dateRange": "dateRangeChange"; "disabledTime": "disabledTimeChange"; "config": "configChange"; "rangeType": "rangeTypeChange"; "activeHover": "activeHoverChange"; }, never, never, true, never>;
+}
+export {};

package/datepicker/si-datepicker.directive.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Copyright Siemens 2016 - 2025.
+ * SPDX-License-Identifier: MIT
+ */
+import { AfterViewInit, ElementRef } from '@angular/core';
+import { SiDateInputDirective } from './si-date-input.directive';
+import * as i0 from "@angular/core";
+import * as i1 from "./si-datepicker-overlay.directive";
+export declare class SiDatepickerDirective extends SiDateInputDirective implements AfterViewInit {
+    /**
+     * Automatically close overlay on date selection.
+     * Do not use this behavior with config showTime = true, because it
+     * will close the overlay when the user change one of the time units.
+     *
+     * @defaultValue false
+     */
+    readonly autoClose: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+    /**
+     * @deprecated Property has no effect and will be removed without replacement.
+     *
+     * @defaultValue inject(ElementRef)
+     */
+    readonly triggeringInput: import("@angular/core").InputSignal<ElementRef<any>>;
+    /**
+     * During focus on close the datepicker will not show since we recover the focus on element.
+     * The focus on close is only relevant when the directive is configured without a calendar button.
+     */
+    private overlaySubscriptions?;
+    private externalTrigger?;
+    private readonly overlayToggle;
+    ngAfterViewInit(): void;
+    /** @internal */
+    touch(): void;
+    /**
+     * On click shall show datepicker.
+     */
+    protected onClick(): void;
+    /**
+     * Focus out shall close the datepicker except we are moving the focus to the datepicker.
+     * @param event - focus out event with the related target
+     */
+    protected onBlur(event: FocusEvent): void;
+    protected onTab(): void;
+    /**
+     * @internal
+     */
+    show(initialFocus?: boolean): void;
+    /**
+     * @internal
+     */
+    useExternalTrigger(element: ElementRef<HTMLElement>): void;
+    protected focusChange(): void;
+    private getTime12h;
+    private subscribeDateChanges;
+    /**
+     * Callback when the datepicker changes his value.
+     * @param date - updated date
+     */
+    protected onDateChanged(date?: Date): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SiDatepickerDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<SiDatepickerDirective, "[siDatepicker]", ["siDatepicker"], { "autoClose": { "alias": "autoClose"; "required": false; "isSignal": true; }; "triggeringInput": { "alias": "triggeringInput"; "required": false; "isSignal": true; }; }, {}, never, never, true, [{ directive: typeof i1.SiDatepickerOverlayDirective; inputs: {}; outputs: { "siDatepickerClose": "siDatepickerClose"; }; }]>;
+}

package/datepicker/si-datepicker.model.d.ts

@@ -0,0 +1,129 @@
+/**
+ * Copyright Siemens 2016 - 2025.
+ * SPDX-License-Identifier: MIT
+ */
+import { TranslatableString } from '@siemens/element-translate-ng/translate';
+export type WeekStart = 'monday' | 'saturday' | 'sunday' | undefined;
+export interface DatepickerConfig {
+    /**
+     * Text or translation key for today button title. Default is `Today`.
+     */
+    todayText?: TranslatableString;
+    /**
+     * Defines the starting day of the week. Default is `monday`.
+     */
+    weekStartDay?: WeekStart;
+    /**
+     * Configuration for hiding week numbers. Default is `false`.
+     */
+    hideWeekNumbers?: boolean;
+    /**
+     * Defines the timepicker visibility. Default is `false`.
+     */
+    showTime?: boolean;
+    /**
+     * Defines the timepicker minutes visibility. Default is `true`.
+     */
+    showMinutes?: boolean;
+    /**
+     * Defines the timepicker seconds visibility . Default is `false`.
+     */
+    showSeconds?: boolean;
+    /**
+     * Defines the timepicker milliseconds visibility . Default is `false`.
+     */
+    showMilliseconds?: boolean;
+    /**
+     * Hides disable time switch in the timepicker part and includes mandatory the
+     * time in the picker.
+     */
+    mandatoryTime?: boolean;
+    /**
+     * Defines the time is disabled when visible. Will also be updated on user change. Default is `false`.
+     */
+    disabledTime?: boolean;
+    /**
+     * Text or translation key for the `enabled` disable time. Default is `Consider time`.
+     */
+    enabledTimeText?: TranslatableString;
+    /**
+     * Text or translation key for the `disabled` disable time. Default is `Ignore time`.
+     */
+    disabledTimeText?: TranslatableString;
+    /**
+     * Minimal (earliest) selectable date.
+     */
+    minDate?: Date;
+    /**
+     * Maximal (latest) selectable date.
+     */
+    maxDate?: Date;
+    /**
+     * Options to turn on date range selection.
+     */
+    enableDateRange?: boolean;
+    /**
+     * Option to use two months view for date range picking.
+     */
+    enableTwoMonthDateRange?: boolean;
+    /**
+     * Consider time with minDate and maxDate
+     */
+    enableTimeValidation?: boolean;
+    /**
+     * Only month and year are selectable.
+     */
+    onlyMonthSelection?: boolean;
+    hoursLabel?: string;
+    minutesLabel?: string;
+    secondsLabel?: string;
+    millisecondsLabel?: string;
+    hideLabels?: boolean;
+    hoursAriaLabel?: string;
+    minutesAriaLabel?: string;
+    secondsAriaLabel?: string;
+    millisecondsAriaLabel?: string;
+    hoursPlaceholder?: string;
+    minutesPlaceholder?: string;
+    secondsPlaceholder?: string;
+    millisecondsPlaceholder?: string;
+    meridians?: string[];
+    meridiansLabel?: string;
+    meridiansAriaLabel?: string;
+    startTimeLabel?: string;
+    endTimeLabel?: string;
+}
+export interface DatepickerInputConfig extends DatepickerConfig {
+    /**
+     * A custom date/time format according the Angular date pipe (see {@link https://angular.dev/api/common/DatePipe}).
+     * Only numeric date formats are supported.
+     * The format is used to render the time of a date-time criterion. If not specified, `mediumTime` is
+     * used if the `showSeconds` flag is true, otherwise `shortTime` as default. For the date-only
+     * case, 'shortDate' is used.
+     */
+    dateTimeFormat?: string;
+    /**
+     * Similar to `dateTimeFormat`, but used when only a date is displayed
+     * (e.g. when `showTime === false` or `disabledTime === true`).
+     * Only numeric date formats are supported.
+     */
+    dateFormat?: string;
+}
+/**
+ * Returns date / datetime format to be used for rendering a date object as text
+ * to an Html input element, which has the `SiDatepickerDirective`.
+ *
+ * @see https://angular.dev/api/common/DatePipe?tab=usage-notes
+ * @param locale - The locale for which the format is returned.
+ * @param config - The config object of the datepicker.
+ * @param timeWhenDisabled - If `true`, a format with time (medium or short) is returned, even if the `disabledTime` config is `true`.
+ * @returns Either
+ *   - a custom format provided by the config,
+ *   - the localized `medium` format when time and seconds included
+ *   - the localized `short` format when time and no seconds included
+ */
+export declare const getDatepickerFormat: (locale: string, config?: DatepickerInputConfig, timeWhenDisabled?: boolean) => string;
+export type DateRange = {
+    start: Date | undefined;
+    end: Date | undefined;
+};

package/datepicker/si-datepicker.module.d.ts

@@ -0,0 +1,12 @@
+import * as i0 from "@angular/core";
+import * as i1 from "./si-calendar-button.component";
+import * as i2 from "./si-date-input.directive";
+import * as i3 from "./si-datepicker.component";
+import * as i4 from "./si-datepicker.directive";
+import * as i5 from "./si-date-range.component";
+import * as i6 from "./si-timepicker.component";
+export declare class SiDatepickerModule {
+    static ɵfac: i0.ɵɵFactoryDeclaration<SiDatepickerModule, never>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<SiDatepickerModule, never, [typeof i1.SiCalendarButtonComponent, typeof i2.SiDateInputDirective, typeof i3.SiDatepickerComponent, typeof i4.SiDatepickerDirective, typeof i5.SiDateRangeComponent, typeof i6.SiTimepickerComponent], [typeof i1.SiCalendarButtonComponent, typeof i2.SiDateInputDirective, typeof i3.SiDatepickerComponent, typeof i4.SiDatepickerDirective, typeof i5.SiDateRangeComponent, typeof i6.SiTimepickerComponent]>;
+    static ɵinj: i0.ɵɵInjectorDeclaration<SiDatepickerModule>;
+}