@cloudscape-design/components 3.0.1007 → 3.0.1008

package/date-range-picker/interfaces.d.ts

@@ -6,429 +6,430 @@ import { FormFieldValidationControlProps } from '../internal/context/form-field-
 import { NonCancelableEventHandler } from '../internal/events';
 import { TimeInputProps } from '../time-input/interfaces';
 export interface DateRangePickerBaseProps {
-  /**
-   * The current date range value. Can be either an absolute time range
-   * or a relative time range.
-   */
-  value: null | DateRangePickerProps.Value;
-  /**
-   * A list of relative time ranges that are shown as suggestions.
-   */
-  relativeOptions: ReadonlyArray<DateRangePickerProps.RelativeOption>;
-  /**
-   * A function that defines whether a particular date should be enabled
-   * in the calendar or not. Note that disabling a date in the calendar
-   * still allows users to enter this date via keyboard. We therefore
-   * recommend that you also validate these constraints client- and
-   * server-side, in the same way as for other form elements.
-   */
-  isDateEnabled?: DateRangePickerProps.IsDateEnabledFunction;
-  /**
-   * Provides a reason why a particular date in the calendar is not enabled (only when `isDateEnabled` returns `false`).
-   * If provided, the date becomes focusable.
-   * @param date
-   */
-  dateDisabledReason?: DateRangePickerProps.DateDisabledReasonFunction;
-  /**
-   * The locale to be used for rendering month names and defining the
-   * starting date of the week. If not provided, it will be determined
-   * from the page and browser locales. Supported values and formats
-   * are as-per the [JavaScript Intl API specification](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl#Locale_identification_and_negotiation).
-   */
-  locale?: string;
-  /**
-   * Starting day of the week. [0-6] maps to [Sunday-Saturday].
-   * By default the starting day of the week is defined by the locale,
-   * but you can override it using this property.
-   */
-  startOfWeek?: number;
-  /**
-   * An object containing all the necessary localized strings required by the component.
-   * @i18n
-   */
-  i18nStrings?: DateRangePickerProps.I18nStrings;
-  /**
-   * Hides time inputs and changes the input format to date-only, e.g. 2021-04-06.
-   *
-   * Do not use `dateOnly` flag conditionally. The component does not trigger the value update
-   * when the flag changes which means the value format can become inconsistent.
-   *
-   * This does not apply when the 'granularity' is set to 'month'
-   *
-   * Default: `false`.
-   */
-  dateOnly?: boolean;
-  /**
-   * Determines the range selector mode as follows:
-   *
-   * * `default` for combined absolute/relative range selector.
-   * * `absolute-only` for absolute-only range selector.
-   * * `relative-only` for relative-only range selector.
-   *
-   * By default, the range selector mode is `default`.
-   */
-  rangeSelectorMode?: DateRangePickerProps.RangeSelectorMode;
-  /**
-   * Specifies the format of the time input for absolute ranges.
-   *
-   * Use to restrict the granularity of time that the user can enter.
-   *
-   * Has no effect when `dateOnly` is true or `granularity` is set to 'month'.
-   */
-  timeInputFormat?: TimeInputProps.Format;
-  /**
-   * Fired whenever a user changes the component's value.
-   * The event `detail` contains the current value of the field.
-   */
-  onChange?: NonCancelableEventHandler<DateRangePickerProps.ChangeDetail>;
-  /**
-   * The time offset from UTC in minutes that should be used to
-   * display and produce values.
-   *
-   * Has no effect when `dateOnly` is true.
-   *
-   * Default: the user's current time offset as provided by the browser.
-   *
-   * @deprecated Use `getTimeOffset` instead.
-   */
-  timeOffset?: number;
-  /**
-   * A function that defines timezone offset from UTC in minutes for selected dates.
-   * Use it to define time relative to the desired timezone.
-   *
-   * The function is called for the start date and the end date and takes a UTC date
-   * corresponding the selected value as an argument.
-   *
-   * Has no effect when `dateOnly` is true.
-   *
-   * Default: the user's current time offset as provided by the browser.
-   */
-  getTimeOffset?: DateRangePickerProps.GetTimeOffsetFunction;
-}
-export interface DateRangePickerProps extends BaseComponentProps, FormFieldValidationControlProps, ExpandToViewport, DateRangePickerBaseProps, Pick<CalendarProps, 'granularity'> {
-  /**
-   * Specifies the placeholder text that is rendered when the value is empty.
-   */
-  placeholder?: string;
-  /**
-   * Specifies that the component is disabled, preventing the user from
-   * modifying the value. A disabled component cannot receive focus.
-   */
-  disabled?: boolean;
-  /**
-   * Specifies that the component is read-only, preventing the user from
-   * modifying the value. A read-only component can receive focus.
-   */
-  readOnly?: boolean;
-  /**
-   * Fired when keyboard focus is set onto the UI control.
-   */
-  onFocus?: NonCancelableEventHandler<null>;
-  /**
-   * Fired when keyboard focus is removed from the UI control.
-   */
-  onBlur?: NonCancelableEventHandler<null>;
-  /**
-   * A function that defines whether a particular range is valid or not.
-   *
-   * Ensure that your function checks for missing fields in the value.
-   */
-  isValidRange: DateRangePickerProps.ValidationFunction;
-  /**
-   * Specifies whether the component should show a button that
-   * allows the user to clear the selected value.
-   */
-  showClearButton?: boolean;
-  /**
-   * Specifies an additional control displayed in the dropdown, located below the range calendar.
-   */
-  customAbsoluteRangeControl?: DateRangePickerProps.AbsoluteRangeControl;
-  /**
-   * Specifies which time units to allow in the custom relative range control.
-   */
-  customRelativeRangeUnits?: DateRangePickerProps.TimeUnit[];
-  /**
-   * Specifies the time format to use for displaying the absolute time range.
-   *
-   * It can take the following values:
-   * * `iso`: ISO 8601 format, e.g.: 2024-01-30T13:32:32+01:00 (or 2024-01-30 when `dateOnly` is true)
-   * * `long-localized`: a more human-readable, localized format, e.g.: January 30, 2024, 13:32:32 (UTC+1) (or January 30, 2024 when `dateOnly` is true)
-   *
-   * Defaults to `iso`.
-   */
-  absoluteFormat?: DateRangePickerProps.AbsoluteFormat;
-  /**
-   * Specifies whether to hide the time offset in the displayed absolute time range.
-   * Defaults to `false`.
-   */
-  hideTimeOffset?: boolean;
-}
-export declare namespace DateRangePickerProps {
-  type Value = AbsoluteValue | RelativeValue;
-  interface AbsoluteValue {
-    /**
-     * In ISO8601 format, e.g.: 2021-04-06T17:23:50+02:00 (or 2021-04-06 when `dateOnly` is true)
-     */
-    startDate: string;
-    /**
-     * In ISO8601 format, e.g.: 2021-04-06T17:23:50+02:00 (or 2021-04-06 when `dateOnly` is true)
-     */
-    endDate: string;
-    type: 'absolute';
-  }
-  interface RelativeValue {
-    /**
-     * If provided, used to match this value
-     * to a provided relative option.
-     */
-    key?: string;
-    amount: number;
-    unit: TimeUnit;
-    type: 'relative';
-  }
-  interface RelativeOption {
-    /**
-     * Used to uniquely identify this relative option.
-     */
-    key: string;
-    amount: number;
-    unit: TimeUnit;
-    type: 'relative';
-  }
-  type TimeUnit = 'second' | 'minute' | 'hour' | 'day' | 'week' | 'month' | 'year';
-  type ValidationFunction = (value: Value | null) => ValidationResult;
-  type ValidationResult = ValidRangeResult | InvalidRangeResult;
-  interface ValidRangeResult {
-    valid: true;
-  }
-  interface InvalidRangeResult {
-    valid: false;
-    errorMessage: string;
-  }
-  interface ChangeDetail {
-    /**
-     * The newly selected range of this date range picker.
-     */
-    value: null | Value;
-  }
-  interface IsDateEnabledFunction {
-    (date: Date): boolean;
-  }
-  interface DateDisabledReasonFunction {
-    (date: Date): string;
-  }
-  interface GetTimeOffsetFunction {
-    (date: Date): number;
-  }
-  interface DateTimeStrings {
-    date: string;
-    time: string;
-  }
-  interface PendingAbsoluteValue {
-    start: DateTimeStrings;
-    end: DateTimeStrings;
-  }
-  type AbsoluteRangeControl = (selectedRange: PendingAbsoluteValue, setSelectedRange: React.Dispatch<React.SetStateAction<PendingAbsoluteValue>>) => React.ReactNode;
-  type RangeSelectorMode = 'default' | 'absolute-only' | 'relative-only';
-  interface Ref {
-    /**
-     * Sets the browser focus on the UI control
-     */
-    focus(): void;
-  }
-  interface I18nStrings {
-    /**
-     * Adds `aria-label` to the trigger and dropdown.
-     */
-    ariaLabel?: string;
-    /**
-     * Adds `aria-labelledby` to the trigger and dropdown.
-     */
-    ariaLabelledby?: string;
-    /**
-     * Adds `aria-describedby` to the trigger and dropdown.
-     */
-    ariaDescribedby?: string;
     /**
-     * Label of the mode selection group. In the standard view, it adds 'aria-label' to the group of segments.
-     * In a narrow container the label is visible and attached to the select component.
-     * @i18n
+     * The current date range value. Can be either an absolute time range
+     * or a relative time range.
      */
-    modeSelectionLabel?: string;
+    value: null | DateRangePickerProps.Value;
     /**
-     * Segment title of the relative range selection mode
-     * @i18n
+     * A list of relative time ranges that are shown as suggestions.
      */
-    relativeModeTitle?: string;
+    relativeOptions: ReadonlyArray<DateRangePickerProps.RelativeOption>;
     /**
-     * Segment title of the absolute range selection mode
-     * @i18n
+     * A function that defines whether a particular date should be enabled
+     * in the calendar or not. Note that disabling a date in the calendar
+     * still allows users to enter this date via keyboard. We therefore
+     * recommend that you also validate these constraints client- and
+     * server-side, in the same way as for other form elements.
      */
-    absoluteModeTitle?: string;
+    isDateEnabled?: DateRangePickerProps.IsDateEnabledFunction;
     /**
-     * Heading for the relative range selection area
-     * @i18n
+     * Provides a reason why a particular date in the calendar is not enabled (only when `isDateEnabled` returns `false`).
+     * If provided, the date becomes focusable.
+     * @param date
      */
-    relativeRangeSelectionHeading?: string;
+    dateDisabledReason?: DateRangePickerProps.DateDisabledReasonFunction;
     /**
-     * Description for the relative range selection area
-     * @i18n
-     */
-    relativeRangeSelectionMonthlyDescription?: string;
-    /**
-     * Visible label of the Cancel button
-     * @i18n
-     */
-    cancelButtonLabel?: string;
-    /**
-     * Visible label of the Clear and dismiss button
-     * @i18n
+     * The locale to be used for rendering month names and defining the
+     * starting date of the week. If not provided, it will be determined
+     * from the page and browser locales. Supported values and formats
+     * are as-per the [JavaScript Intl API specification](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl#Locale_identification_and_negotiation).
      */
-    clearButtonLabel?: string;
+    locale?: string;
     /**
-     * Visible label of the Apply button
-     * @i18n
+     * Starting day of the week. [0-6] maps to [Sunday-Saturday].
+     * By default the starting day of the week is defined by the locale,
+     * but you can override it using this property.
      */
-    applyButtonLabel?: string;
+    startOfWeek?: number;
     /**
-     * Formatting function for relative ranges.
-     * This function must convert a relative range to a human-readable string.
+     * An object containing all the necessary localized strings required by the component.
      * @i18n
      */
-    formatRelativeRange?: (value: RelativeValue) => string;
+    i18nStrings?: DateRangePickerProps.I18nStrings;
     /**
-     * Formatting function for time units.
+     * Hides time inputs and changes the input format to date-only, e.g. 2021-04-06.
      *
-     * This function must return a localized form of the unit that fits the provided time value.
-     * @i18n
-     */
-    formatUnit?: (unit: TimeUnit, value: number) => string;
-    /**
-     * Visible label for the option for selecting
-     * a custom relative range.
-     * @i18n
-     */
-    customRelativeRangeOptionLabel?: string;
-    /**
-     * Visible description for the option for selecting
-     * a custom relative range.
-     * @i18n
-     */
-    customRelativeRangeOptionDescription?: string;
-    /**
-     * Visible label for the duration selector for
-     * the custom relative range.
-     * @i18n
-     */
-    customRelativeRangeDurationLabel?: string;
-    /**
-     * Placeholder for the duration selector for
-     * the custom relative range.
-     * @i18n
-     */
-    customRelativeRangeDurationPlaceholder?: string;
-    /**
-     * Visible label for the unit selector for the
-     * custom relative range.
-     * @i18n
-     */
-    customRelativeRangeUnitLabel?: string;
-    /**
-     * Visible label for the Start Month input for the
-     * absolute range.
-     * @i18n
+     * Do not use `dateOnly` flag conditionally. The component does not trigger the value update
+     * when the flag changes which means the value format can become inconsistent.
+     *
+     * This does not apply when the 'granularity' is set to 'month'
+     *
+     * Default: `false`.
      */
-    startMonthLabel?: string;
+    dateOnly?: boolean;
     /**
-     * Visible label for the Start Date input for the
-     * absolute range.
-     * @i18n
+     * Determines the range selector mode as follows:
+     *
+     * * `default` for combined absolute/relative range selector.
+     * * `absolute-only` for absolute-only range selector.
+     * * `relative-only` for relative-only range selector.
+     *
+     * By default, the range selector mode is `default`.
      */
-    startDateLabel?: string;
+    rangeSelectorMode?: DateRangePickerProps.RangeSelectorMode;
     /**
-     * Visible label for the Start Time input for the
-     * absolute range.
-     * @i18n
+     * Specifies the format of the time input for absolute ranges.
+     *
+     * Use to restrict the granularity of time that the user can enter.
+     *
+     * Has no effect when `dateOnly` is true or `granularity` is set to 'month'.
      */
-    startTimeLabel?: string;
+    timeInputFormat?: TimeInputProps.Format;
     /**
-     * Visible label for the End Month input for the
-     * absolute range.
-     * @i18n
+     * Fired whenever a user changes the component's value.
+     * The event `detail` contains the current value of the field.
      */
-    endMonthLabel?: string;
+    onChange?: NonCancelableEventHandler<DateRangePickerProps.ChangeDetail>;
     /**
-     * Visible label for the End Date input for the
-     * absolute range.
-     * @i18n
+     * The time offset from UTC in minutes that should be used to
+     * display and produce values.
+     *
+     * Has no effect when `dateOnly` is true.
+     *
+     * Default: the user's current time offset as provided by the browser.
+     *
+     * @deprecated Use `getTimeOffset` instead.
      */
-    endDateLabel?: string;
+    timeOffset?: number;
     /**
-     * Visible label for the End Time input for the
-     * absolute range.
-     * @i18n
+     * A function that defines timezone offset from UTC in minutes for selected dates.
+     * Use it to define time relative to the desired timezone.
+     *
+     * The function is called for the start date and the end date and takes a UTC date
+     * corresponding the selected value as an argument.
+     *
+     * Has no effect when `dateOnly` is true.
+     *
+     * Default: the user's current time offset as provided by the browser.
      */
-    endTimeLabel?: string;
+    getTimeOffset?: DateRangePickerProps.GetTimeOffsetFunction;
+}
+export interface DateRangePickerProps extends BaseComponentProps, FormFieldValidationControlProps, ExpandToViewport, DateRangePickerBaseProps, Pick<CalendarProps, 'granularity'> {
     /**
-     * Constraint text for the date input field for the
-     * absolute range with no time option.
-     * @i18n
+     * Specifies the placeholder text that is rendered when the value is empty.
      */
-    dateConstraintText?: string;
+    placeholder?: string;
     /**
-     * Constraint text for the input fields for the
-     * absolute range.
-     * @i18n
+     * Specifies that the component is disabled, preventing the user from
+     * modifying the value. A disabled component cannot receive focus.
      */
-    dateTimeConstraintText?: string;
+    disabled?: boolean;
     /**
-     * Constraint text for the month input fields for the
-     * absolute range.
-     * @i18n
+     * Specifies that the component is read-only, preventing the user from
+     * modifying the value. A read-only component can receive focus.
      */
-    monthConstraintText?: string;
+    readOnly?: boolean;
     /**
-     * Provides a text alternative for the error icon in the error alert.
-     * @i18n
+     * Fired when keyboard focus is set onto the UI control.
      */
-    errorIconAriaLabel?: string;
+    onFocus?: NonCancelableEventHandler<null>;
     /**
-     * When the property is set, screen readers announce the selected range when the absolute range gets selected.
+     * Fired when keyboard focus is removed from the UI control.
      */
-    renderSelectedAbsoluteRangeAriaLive?: (startDate: string, endDate: string) => string;
+    onBlur?: NonCancelableEventHandler<null>;
     /**
-     * Used as part of the `aria-label` for today's date in the calendar.
-     * @i18n
+     * A function that defines whether a particular range is valid or not.
+     *
+     * Ensure that your function checks for missing fields in the value.
      */
-    todayAriaLabel?: string;
+    isValidRange: DateRangePickerProps.ValidationFunction;
     /**
-     * Specifies an `aria-label` for the 'next month' button.
-     * @i18n
+     * Specifies whether the component should show a button that
+     * allows the user to clear the selected value.
      */
-    nextMonthAriaLabel?: string;
+    showClearButton?: boolean;
     /**
-     * Specifies an `aria-label` for the 'previous month' button.
-     * @i18n
+     * Specifies an additional control displayed in the dropdown, located below the range calendar.
      */
-    previousMonthAriaLabel?: string;
+    customAbsoluteRangeControl?: DateRangePickerProps.AbsoluteRangeControl;
     /**
-     * Used as part of the `aria-label` for the current month in the calendar.
-     * @i18n
+     * Specifies which time units to allow in the custom relative range control.
      */
-    currentMonthAriaLabel?: string;
+    customRelativeRangeUnits?: DateRangePickerProps.TimeUnit[];
     /**
-     * Specifies an `aria-label` for the 'next year' button.
-     * @i18n
+     * Specifies the time format to use for displaying the absolute time range.
+     *
+     * It can take the following values:
+     * * `iso`: ISO 8601 format, e.g.: 2024-01-30T13:32:32+01:00 (or 2024-01-30 when `dateOnly` is true)
+     * * `long-localized`: a more human-readable, localized format, e.g.: January 30, 2024, 13:32:32 (UTC+1) (or January 30, 2024 when `dateOnly` is true)
+     *
+     * Defaults to `iso`.
      */
-    nextYearAriaLabel?: string;
+    absoluteFormat?: DateRangePickerProps.AbsoluteFormat;
     /**
-     * Specifies an `aria-label` for the 'previous year' button.
-     * @i18n
+     * Specifies whether to hide the time offset in the displayed absolute time range.
+     * Defaults to `false`.
      */
-    previousYearAriaLabel?: string;
-  }
-  type AbsoluteFormat = 'iso' | 'long-localized';
+    hideTimeOffset?: boolean;
+}
+export declare namespace DateRangePickerProps {
+    type Value = AbsoluteValue | RelativeValue;
+    interface AbsoluteValue {
+        /**
+         * In ISO8601 format, e.g.: 2021-04-06T17:23:50+02:00 (or 2021-04-06 when `dateOnly` is true)
+         */
+        startDate: string;
+        /**
+         * In ISO8601 format, e.g.: 2021-04-06T17:23:50+02:00 (or 2021-04-06 when `dateOnly` is true)
+         */
+        endDate: string;
+        type: 'absolute';
+    }
+    interface RelativeValue {
+        /**
+         * If provided, used to match this value
+         * to a provided relative option.
+         */
+        key?: string;
+        amount: number;
+        unit: TimeUnit;
+        type: 'relative';
+    }
+    interface RelativeOption {
+        /**
+         * Used to uniquely identify this relative option.
+         */
+        key: string;
+        amount: number;
+        unit: TimeUnit;
+        type: 'relative';
+    }
+    type TimeUnit = 'second' | 'minute' | 'hour' | 'day' | 'week' | 'month' | 'year';
+    type ValidationFunction = (value: Value | null) => ValidationResult;
+    type ValidationResult = ValidRangeResult | InvalidRangeResult;
+    interface ValidRangeResult {
+        valid: true;
+    }
+    interface InvalidRangeResult {
+        valid: false;
+        errorMessage: string;
+    }
+    interface ChangeDetail {
+        /**
+         * The newly selected range of this date range picker.
+         */
+        value: null | Value;
+    }
+    interface IsDateEnabledFunction {
+        (date: Date): boolean;
+    }
+    interface DateDisabledReasonFunction {
+        (date: Date): string;
+    }
+    interface GetTimeOffsetFunction {
+        (date: Date): number;
+    }
+    interface DateTimeStrings {
+        date: string;
+        time: string;
+    }
+    interface PendingAbsoluteValue {
+        start: DateTimeStrings;
+        end: DateTimeStrings;
+    }
+    type AbsoluteRangeControl = (selectedRange: PendingAbsoluteValue, setSelectedRange: React.Dispatch<React.SetStateAction<PendingAbsoluteValue>>) => React.ReactNode;
+    type RangeSelectorMode = 'default' | 'absolute-only' | 'relative-only';
+    interface Ref {
+        /**
+         * Sets the browser focus on the UI control
+         */
+        focus(): void;
+    }
+    interface I18nStrings {
+        /**
+         * Adds `aria-label` to the trigger and dropdown.
+         */
+        ariaLabel?: string;
+        /**
+         * Adds `aria-labelledby` to the trigger and dropdown.
+         */
+        ariaLabelledby?: string;
+        /**
+         * Adds `aria-describedby` to the trigger and dropdown.
+         */
+        ariaDescribedby?: string;
+        /**
+         * Label of the mode selection group. In the standard view, it adds 'aria-label' to the group of segments.
+         * In a narrow container the label is visible and attached to the select component.
+         * @i18n
+         */
+        modeSelectionLabel?: string;
+        /**
+         * Segment title of the relative range selection mode
+         * @i18n
+         */
+        relativeModeTitle?: string;
+        /**
+         * Segment title of the absolute range selection mode
+         * @i18n
+         */
+        absoluteModeTitle?: string;
+        /**
+         * Heading for the relative range selection area
+         * @i18n
+         */
+        relativeRangeSelectionHeading?: string;
+        /**
+         * Description for the relative range selection area
+         * @i18n
+         */
+        relativeRangeSelectionMonthlyDescription?: string;
+        /**
+         * Visible label of the Cancel button
+         * @i18n
+         */
+        cancelButtonLabel?: string;
+        /**
+         * Visible label of the Clear and dismiss button
+         * @i18n
+         */
+        clearButtonLabel?: string;
+        /**
+         * Visible label of the Apply button
+         * @i18n
+         */
+        applyButtonLabel?: string;
+        /**
+         * Formatting function for relative ranges.
+         * This function must convert a relative range to a human-readable string.
+         * @i18n
+         */
+        formatRelativeRange?: (value: RelativeValue) => string;
+        /**
+         * Formatting function for time units.
+         *
+         * This function must return a localized form of the unit that fits the provided time value.
+         * @i18n
+         */
+        formatUnit?: (unit: TimeUnit, value: number) => string;
+        /**
+         * Visible label for the option for selecting
+         * a custom relative range.
+         * @i18n
+         */
+        customRelativeRangeOptionLabel?: string;
+        /**
+         * Visible description for the option for selecting
+         * a custom relative range.
+         * @i18n
+         */
+        customRelativeRangeOptionDescription?: string;
+        /**
+         * Visible label for the duration selector for
+         * the custom relative range.
+         * @i18n
+         */
+        customRelativeRangeDurationLabel?: string;
+        /**
+         * Placeholder for the duration selector for
+         * the custom relative range.
+         * @i18n
+         */
+        customRelativeRangeDurationPlaceholder?: string;
+        /**
+         * Visible label for the unit selector for the
+         * custom relative range.
+         * @i18n
+         */
+        customRelativeRangeUnitLabel?: string;
+        /**
+         * Visible label for the Start Month input for the
+         * absolute range.
+         * @i18n
+         */
+        startMonthLabel?: string;
+        /**
+         * Visible label for the Start Date input for the
+         * absolute range.
+         * @i18n
+         */
+        startDateLabel?: string;
+        /**
+         * Visible label for the Start Time input for the
+         * absolute range.
+         * @i18n
+         */
+        startTimeLabel?: string;
+        /**
+         * Visible label for the End Month input for the
+         * absolute range.
+         * @i18n
+         */
+        endMonthLabel?: string;
+        /**
+         * Visible label for the End Date input for the
+         * absolute range.
+         * @i18n
+         */
+        endDateLabel?: string;
+        /**
+         * Visible label for the End Time input for the
+         * absolute range.
+         * @i18n
+         */
+        endTimeLabel?: string;
+        /**
+         * Constraint text for the date input field for the
+         * absolute range with no time option.
+         * @i18n
+         */
+        dateConstraintText?: string;
+        /**
+         * Constraint text for the input fields for the
+         * absolute range.
+         * @i18n
+         */
+        dateTimeConstraintText?: string;
+        /**
+         * Constraint text for the month input fields for the
+         * absolute range.
+         * @i18n
+         */
+        monthConstraintText?: string;
+        /**
+         * Provides a text alternative for the error icon in the error alert.
+         * @i18n
+         */
+        errorIconAriaLabel?: string;
+        /**
+         * When the property is set, screen readers announce the selected range when the absolute range gets selected.
+         */
+        renderSelectedAbsoluteRangeAriaLive?: (startDate: string, endDate: string) => string;
+        /**
+         * Used as part of the `aria-label` for today's date in the calendar.
+         * @i18n
+         */
+        todayAriaLabel?: string;
+        /**
+         * Specifies an `aria-label` for the 'next month' button.
+         * @i18n
+         */
+        nextMonthAriaLabel?: string;
+        /**
+         * Specifies an `aria-label` for the 'previous month' button.
+         * @i18n
+         */
+        previousMonthAriaLabel?: string;
+        /**
+         * Used as part of the `aria-label` for the current month in the calendar.
+         * @i18n
+         */
+        currentMonthAriaLabel?: string;
+        /**
+         * Specifies an `aria-label` for the 'next year' button.
+         * @i18n
+         */
+        nextYearAriaLabel?: string;
+        /**
+         * Specifies an `aria-label` for the 'previous year' button.
+         * @i18n
+         */
+        previousYearAriaLabel?: string;
+    }
+    type AbsoluteFormat = 'iso' | 'long-localized';
 }
 export type DayIndex = 0 | 1 | 2 | 3 | 4 | 5 | 6;
 export type QuarterIndex = 0 | 1 | 2;
-export type RangeCalendarI18nStrings = Pick<DateRangePickerProps.I18nStrings, 'todayAriaLabel' | 'nextMonthAriaLabel' | 'previousMonthAriaLabel' | 'currentMonthAriaLabel' | 'nextYearAriaLabel' | 'previousYearAriaLabel' | 'startMonthLabel' | 'startDateLabel' | 'startTimeLabel' | 'endMonthLabel' | 'endDateLabel' | 'endTimeLabel' | 'dateConstraintText' | 'dateTimeConstraintText' | 'monthConstraintText' | 'renderSelectedAbsoluteRangeAriaLive'>;
+export type RangeCalendarI18nStrings = Pick<DateRangePickerProps.I18nStrings, 'todayAriaLabel' | 'nextMonthAriaLabel' | 'previousMonthAriaLabel' | 'currentMonthAriaLabel' | 'nextYearAriaLabel' | 'previousYearAriaLabel' | 'startMonthLabel' | 'startDateLabel' | 'startTimeLabel' | 'endMonthLabel' | 'endDateLabel' | 'endTimeLabel' | 'dateConstraintText' | 'dateTimeConstraintText' | 'monthConstraintText' | 'renderSelectedAbsoluteRangeAriaLive'>;
+//# sourceMappingURL=interfaces.d.ts.map