@johly/bits-ui 2.18.1

package/dist/internal/date-time/field/time-helpers.d.ts

@@ -0,0 +1,83 @@
+import type { EditableTimeSegmentPart, HourCycle, TimeGranularity, TimeSegmentContentObj, TimeSegmentStateMap, TimeSegmentValueObj, TimeValue } from "../../../shared/date/types.js";
+import { CalendarDateTime, Time, ZonedDateTime } from "@internationalized/date";
+import type { TimeFormatter } from "../formatter.js";
+import type { TimeSegmentPart } from "./types.js";
+export declare function initializeSegmentValues(): TimeSegmentValueObj;
+type SharedTimeContentProps = {
+    granularity: TimeGranularity;
+    timeRef: TimeValue;
+    formatter: TimeFormatter;
+    hideTimeZone: boolean;
+    hourCycle: HourCycle | undefined;
+};
+type CreateTimeContentObjProps = SharedTimeContentProps & {
+    segmentValues: TimeSegmentValueObj;
+    locale: string;
+};
+type CreateTimeContentProps = CreateTimeContentObjProps;
+export declare function createTimeContent(props: CreateTimeContentProps): {
+    obj: TimeSegmentContentObj;
+    arr: {
+        part: TimeSegmentPart;
+        value: string;
+    }[];
+};
+export declare function initTimeSegmentStates(): TimeSegmentStateMap;
+export declare function initTimeSegmentIds(): any;
+export declare function isEditableTimeSegmentPart(part: unknown): part is EditableTimeSegmentPart;
+export declare function isAnyTimeSegmentPart(part: unknown): part is TimeSegmentPart;
+type GetTimeValueFromSegments<T extends TimeValue = Time> = {
+    segmentObj: TimeSegmentValueObj;
+    fieldNode: HTMLElement | null;
+    timeRef: T;
+};
+export declare function getTimeValueFromSegments<T extends TimeValue = Time>(props: GetTimeValueFromSegments<T>): T;
+/**
+ * Check if all the segments being used have been filled.
+ * We use this to determine when we should set the value
+ * store of the date field(s).
+ *
+ * @param segmentValues - The current `SegmentValueObj`
+ * @param fieldNode  - The id of the date field
+ */
+export declare function areAllTimeSegmentsFilled(segmentValues: TimeSegmentValueObj, fieldNode: HTMLElement | null): boolean;
+/**
+ * Infer the granularity to use based on the
+ * value and granularity props.
+ */
+export declare function inferTimeGranularity(granularity: TimeGranularity | undefined): TimeGranularity;
+/**
+ * Determines if the element with the provided id is the first focusable
+ * segment in the date field with the provided fieldId.
+ *
+ * @param id - The id of the element to check if it's the first segment
+ * @param fieldNode - The id of the date field associated with the segment
+ */
+export declare function isFirstTimeSegment(id: string, fieldNode: HTMLElement | null): boolean;
+type SetTimeDescriptionProps = {
+    id: string;
+    formatter: TimeFormatter;
+    value: TimeValue;
+    doc: Document;
+};
+/**
+ * Creates or updates a description element for a date field
+ * which enables screen readers to read the date field's value.
+ *
+ * This element is hidden from view, and is portalled to the body
+ * so it can be associated via `aria-describedby` and read by
+ * screen readers as the user interacts with the date field.
+ */
+export declare function setTimeDescription(props: SetTimeDescriptionProps): void;
+/**
+ * Removes the description element for the date field with
+ * the provided ID. This function should be called when the
+ * date field is unmounted.
+ */
+export declare function removeTimeDescriptionElement(id: string, doc: Document): void;
+export declare function convertTimeValueToDateValue(time: TimeValue): CalendarDateTime | ZonedDateTime;
+export declare function convertTimeValueToTime(time: TimeValue): Time;
+export declare function isTimeBefore(timeToCompare: Time, referenceTime: Time): boolean;
+export declare function isTimeAfter(timeToCompare: Time, referenceTime: Time): boolean;
+export declare function getISOTimeValue(time: TimeValue): string;
+export {};

package/dist/internal/date-time/field/time-helpers.js

@@ -0,0 +1,301 @@
+import { isBrowser, isNull } from "../../is.js";
+import { CalendarDateTime, Time, ZonedDateTime } from "@internationalized/date";
+import { ALL_TIME_SEGMENT_PARTS, EDITABLE_TIME_SEGMENT_PARTS } from "./parts.js";
+import { getTimeSegments } from "./segments.js";
+import { styleToString } from "svelte-toolbelt";
+import { useId } from "../../use-id.js";
+import { getPlaceholder } from "../placeholders.js";
+import { isZonedDateTime } from "../utils.js";
+import { getDefaultHourCycle } from "./helpers.js";
+export function initializeSegmentValues() {
+    const initialParts = EDITABLE_TIME_SEGMENT_PARTS.map((part) => {
+        if (part === "dayPeriod") {
+            return [part, "AM"];
+        }
+        return [part, null];
+    }).filter(([key]) => {
+        if (key === "literal" || key === null)
+            return false;
+        return true;
+    });
+    return Object.fromEntries(initialParts);
+}
+function createTimeContentObj(props) {
+    const { segmentValues, formatter, locale, timeRef } = props;
+    const content = Object.keys(segmentValues).reduce((obj, part) => {
+        if (!isEditableTimeSegmentPart(part))
+            return obj;
+        if (part === "dayPeriod") {
+            const value = segmentValues[part];
+            if (!isNull(value)) {
+                obj[part] = value;
+            }
+            else {
+                obj[part] = getPlaceholder(part, "AM", locale);
+            }
+        }
+        else {
+            obj[part] = getPartContent(part);
+        }
+        return obj;
+    }, {});
+    function getPartContent(part) {
+        const value = segmentValues[part];
+        const leadingZero = typeof value === "string" && value?.startsWith("0");
+        const intValue = value !== null ? Number.parseInt(value) : null;
+        if (!isNull(value) && !isNull(intValue)) {
+            const formatted = formatter.part(timeRef.set({ [part]: value }), part, {
+                hourCycle: props.hourCycle === 24 ? "h23" : undefined,
+            });
+            /**
+             * If we're operating in a 12 hour clock and the part is an hour, we handle
+             * the conversion to 12 hour format with 2 digit hours and leading zeros here.
+             */
+            const is12HourMode = props.hourCycle === 12 ||
+                (props.hourCycle === undefined && getDefaultHourCycle(locale) === 12);
+            if (part === "hour" && is12HourMode) {
+                /**
+                 * If the value is over 12, we convert to 12 hour format and add leading
+                 * zeroes if the value is less than 10.
+                 */
+                if (intValue > 12) {
+                    const hour = intValue - 12;
+                    if (hour === 0) {
+                        return "12";
+                    }
+                    else if (hour < 10) {
+                        return `0${hour}`;
+                    }
+                    else {
+                        return `${hour}`;
+                    }
+                }
+                /**
+                 * If the value is 0, we convert to 12, since 0 is not a valid 12 hour time.
+                 */
+                if (intValue === 0) {
+                    return "12";
+                }
+                /**
+                 * If the value is less than 10, we add a leading zero to the value.
+                 */
+                if (intValue < 10) {
+                    return `0${intValue}`;
+                }
+                /**
+                 * Otherwise, we don't need to do anything to the value.
+                 */
+                return `${intValue}`;
+            }
+            if (leadingZero && formatted.length === 1) {
+                return `0${formatted}`;
+            }
+            return formatted;
+        }
+        else {
+            return getPlaceholder(part, "", locale);
+        }
+    }
+    return content;
+}
+function createTimeContentArr(props) {
+    const { granularity, timeRef, formatter, contentObj, hideTimeZone, hourCycle } = props;
+    const parts = formatter.toParts(timeRef, getOptsByGranularity(granularity, hourCycle));
+    const timeSegmentContentArr = parts
+        .map((part) => {
+        const defaultParts = ["literal", "timeZoneName", null];
+        if (defaultParts.includes(part.type) || !isEditableTimeSegmentPart(part.type)) {
+            return {
+                part: part.type,
+                value: part.value,
+            };
+        }
+        return {
+            part: part.type,
+            value: contentObj[part.type],
+        };
+    })
+        .filter((segment) => {
+        if (isNull(segment.part) || isNull(segment.value))
+            return false;
+        if (segment.part === "timeZoneName" && (!isZonedDateTime(timeRef) || hideTimeZone)) {
+            return false;
+        }
+        return true;
+    });
+    return timeSegmentContentArr;
+}
+export function createTimeContent(props) {
+    const contentObj = createTimeContentObj(props);
+    const contentArr = createTimeContentArr({
+        contentObj,
+        ...props,
+    });
+    return {
+        obj: contentObj,
+        arr: contentArr,
+    };
+}
+function getOptsByGranularity(granularity, hourCycle) {
+    const opts = {
+        hour: "2-digit",
+        minute: "2-digit",
+        second: "2-digit",
+        timeZoneName: "short",
+        hourCycle: hourCycle === 24 ? "h23" : undefined,
+        hour12: hourCycle === 24 ? false : undefined,
+    };
+    if (granularity === "hour") {
+        delete opts.minute;
+        delete opts.second;
+    }
+    if (granularity === "minute") {
+        delete opts.second;
+    }
+    return opts;
+}
+export function initTimeSegmentStates() {
+    return EDITABLE_TIME_SEGMENT_PARTS.reduce((acc, key) => {
+        acc[key] = {
+            lastKeyZero: false,
+            hasLeftFocus: true,
+            updating: null,
+        };
+        return acc;
+    }, {});
+}
+export function initTimeSegmentIds() {
+    return Object.fromEntries(ALL_TIME_SEGMENT_PARTS.map((part) => {
+        return [part, useId()];
+    }).filter(([key]) => key !== "literal"));
+}
+export function isEditableTimeSegmentPart(part) {
+    return EDITABLE_TIME_SEGMENT_PARTS.includes(part);
+}
+export function isAnyTimeSegmentPart(part) {
+    return ALL_TIME_SEGMENT_PARTS.includes(part);
+}
+/**
+ * Get the segments being used/ are rendered in the DOM.
+ * We're using this to determine when to set the value of
+ * the date picker, which is when all the segments have
+ * been filled.
+ */
+function getUsedTimeSegments(fieldNode) {
+    if (!isBrowser || !fieldNode)
+        return [];
+    const usedSegments = getTimeSegments(fieldNode)
+        .map((el) => el.dataset.segment)
+        .filter((part) => {
+        return EDITABLE_TIME_SEGMENT_PARTS.includes(part);
+    });
+    return usedSegments;
+}
+export function getTimeValueFromSegments(props) {
+    const usedSegments = getUsedTimeSegments(props.fieldNode);
+    for (const part of usedSegments) {
+        const value = props.segmentObj[part];
+        if (isNull(value))
+            continue;
+        // @ts-expect-error shhh
+        props.timeRef = props.timeRef.set({ [part]: props.segmentObj[part] });
+    }
+    return props.timeRef;
+}
+/**
+ * Check if all the segments being used have been filled.
+ * We use this to determine when we should set the value
+ * store of the date field(s).
+ *
+ * @param segmentValues - The current `SegmentValueObj`
+ * @param fieldNode  - The id of the date field
+ */
+export function areAllTimeSegmentsFilled(segmentValues, fieldNode) {
+    const usedSegments = getUsedTimeSegments(fieldNode);
+    for (const part of usedSegments) {
+        if (segmentValues[part] === null)
+            return false;
+    }
+    return true;
+}
+/**
+ * Infer the granularity to use based on the
+ * value and granularity props.
+ */
+export function inferTimeGranularity(granularity) {
+    if (granularity)
+        return granularity;
+    return "minute";
+}
+/**
+ * Determines if the element with the provided id is the first focusable
+ * segment in the date field with the provided fieldId.
+ *
+ * @param id - The id of the element to check if it's the first segment
+ * @param fieldNode - The id of the date field associated with the segment
+ */
+export function isFirstTimeSegment(id, fieldNode) {
+    if (!isBrowser)
+        return false;
+    const segments = getTimeSegments(fieldNode);
+    return segments.length ? segments[0].id === id : false;
+}
+/**
+ * Creates or updates a description element for a date field
+ * which enables screen readers to read the date field's value.
+ *
+ * This element is hidden from view, and is portalled to the body
+ * so it can be associated via `aria-describedby` and read by
+ * screen readers as the user interacts with the date field.
+ */
+export function setTimeDescription(props) {
+    if (!isBrowser)
+        return;
+    const valueString = props.formatter.selectedTime(props.value);
+    const el = props.doc.getElementById(props.id);
+    if (!el) {
+        const div = props.doc.createElement("div");
+        div.style.cssText = styleToString({
+            display: "none",
+        });
+        div.id = props.id;
+        div.innerText = `Selected Time: ${valueString}`;
+        props.doc.body.appendChild(div);
+    }
+    else {
+        el.innerText = `Selected Time: ${valueString}`;
+    }
+}
+/**
+ * Removes the description element for the date field with
+ * the provided ID. This function should be called when the
+ * date field is unmounted.
+ */
+export function removeTimeDescriptionElement(id, doc) {
+    if (!isBrowser)
+        return;
+    const el = doc.getElementById(id);
+    if (!el)
+        return;
+    doc.body.removeChild(el);
+}
+export function convertTimeValueToDateValue(time) {
+    if (time instanceof Time) {
+        return new CalendarDateTime(2020, 1, 1, time.hour, time.minute, time.second, time.millisecond);
+    }
+    return time;
+}
+export function convertTimeValueToTime(time) {
+    if (time instanceof Time)
+        return time;
+    return new Time(time.hour, time.minute, time.second, time.millisecond);
+}
+export function isTimeBefore(timeToCompare, referenceTime) {
+    return timeToCompare.compare(referenceTime) < 0;
+}
+export function isTimeAfter(timeToCompare, referenceTime) {
+    return timeToCompare.compare(referenceTime) > 0;
+}
+export function getISOTimeValue(time) {
+    return convertTimeValueToTime(time).toString();
+}

package/dist/internal/date-time/field/types.d.ts

@@ -0,0 +1,25 @@
+import type { DATE_SEGMENT_PARTS, EDITABLE_SEGMENT_PARTS, NON_EDITABLE_SEGMENT_PARTS, EDITABLE_TIME_SEGMENT_PARTS } from "./parts.js";
+export type DateSegmentPart = (typeof DATE_SEGMENT_PARTS)[number];
+export type TimeSegmentPart = (typeof EDITABLE_TIME_SEGMENT_PARTS)[number];
+export type EditableSegmentPart = (typeof EDITABLE_SEGMENT_PARTS)[number];
+export type NonEditableSegmentPart = (typeof NON_EDITABLE_SEGMENT_PARTS)[number];
+export type SegmentPart = EditableSegmentPart | NonEditableSegmentPart;
+export type AnyExceptLiteral = Exclude<SegmentPart, "literal">;
+export type DayPeriod = "AM" | "PM" | null;
+export type DateSegmentObj = {
+    [K in DateSegmentPart]: string | null;
+};
+export type TimeSegmentObj = {
+    [K in TimeSegmentPart]: K extends "dayPeriod" ? DayPeriod : string | null;
+};
+export type DateAndTimeSegmentObj = DateSegmentObj & TimeSegmentObj;
+export type SegmentValueObj = DateSegmentObj | DateAndTimeSegmentObj;
+export type SegmentContentObj = Record<EditableSegmentPart, string>;
+export type SegmentState = {
+    lastKeyZero: boolean;
+    hasLeftFocus: boolean;
+    updating: string | null;
+};
+export type SegmentStateMap = {
+    [K in EditableSegmentPart]: SegmentState;
+};

package/dist/internal/date-time/field/types.js

@@ -0,0 +1 @@
+export {};

package/dist/internal/date-time/formatter.d.ts

@@ -0,0 +1,41 @@
+import { type DateValue } from "@internationalized/date";
+import type { HourCycle, TimeValue } from "../../shared/date/types.js";
+import type { ReadableBox } from "svelte-toolbelt";
+export type Formatter = ReturnType<typeof createFormatter>;
+export type TimeFormatter = ReturnType<typeof createTimeFormatter>;
+type CreateFormatterOptions = {
+    initialLocale: string;
+    monthFormat: ReadableBox<Intl.DateTimeFormatOptions["month"] | ((month: number) => string)>;
+    yearFormat: ReadableBox<Intl.DateTimeFormatOptions["year"] | ((year: number) => string)>;
+};
+/**
+ * Creates a wrapper around the `DateFormatter`, which is
+ * an improved version of the {@link Intl.DateTimeFormat} API,
+ * that is used internally by the various date builders to
+ * easily format dates in a consistent way.
+ *
+ * @see [DateFormatter](https://react-spectrum.adobe.com/internationalized/date/DateFormatter.html)
+ */
+export declare function createFormatter(opts: CreateFormatterOptions): {
+    setLocale: (newLocale: string) => void;
+    getLocale: () => string;
+    fullMonth: (date: Date) => string;
+    fullYear: (date: Date) => string;
+    fullMonthAndYear: (date: Date) => string;
+    toParts: (date: DateValue, options?: Intl.DateTimeFormatOptions) => Intl.DateTimeFormatPart[];
+    custom: (date: Date, options: Intl.DateTimeFormatOptions) => string;
+    part: (dateObj: DateValue, type: Intl.DateTimeFormatPartTypes, options?: Intl.DateTimeFormatOptions) => string;
+    dayPeriod: (date: Date, hourCycle?: HourCycle | undefined) => "AM" | "PM";
+    selectedDate: (date: DateValue, includeTime?: boolean) => string;
+    dayOfWeek: (date: Date, length?: Intl.DateTimeFormatOptions["weekday"]) => string;
+};
+export declare function createTimeFormatter(initialLocale: string): {
+    setLocale: (newLocale: string) => void;
+    getLocale: () => string;
+    toParts: (timeValue: TimeValue, options?: Intl.DateTimeFormatOptions) => Intl.DateTimeFormatPart[];
+    custom: (date: Date, options: Intl.DateTimeFormatOptions) => string;
+    part: (dateObj: TimeValue, type: Intl.DateTimeFormatPartTypes, options?: Intl.DateTimeFormatOptions) => string;
+    dayPeriod: (date: Date, hourCycle?: HourCycle | undefined) => "AM" | "PM";
+    selectedTime: (date: TimeValue) => string;
+};
+export {};

package/dist/internal/date-time/formatter.js

@@ -0,0 +1,166 @@
+import { DateFormatter } from "@internationalized/date";
+import { hasTime, isZonedDateTime, toDate } from "./utils.js";
+import { convertTimeValueToDateValue } from "./field/time-helpers.js";
+const defaultPartOptions = {
+    year: "numeric",
+    month: "numeric",
+    day: "numeric",
+    hour: "numeric",
+    minute: "numeric",
+    second: "numeric",
+};
+/**
+ * Creates a wrapper around the `DateFormatter`, which is
+ * an improved version of the {@link Intl.DateTimeFormat} API,
+ * that is used internally by the various date builders to
+ * easily format dates in a consistent way.
+ *
+ * @see [DateFormatter](https://react-spectrum.adobe.com/internationalized/date/DateFormatter.html)
+ */
+export function createFormatter(opts) {
+    let locale = opts.initialLocale;
+    function setLocale(newLocale) {
+        locale = newLocale;
+    }
+    function getLocale() {
+        return locale;
+    }
+    function custom(date, options) {
+        return new DateFormatter(locale, options).format(date);
+    }
+    function selectedDate(date, includeTime = true) {
+        if (hasTime(date) && includeTime) {
+            return custom(toDate(date), {
+                dateStyle: "long",
+                timeStyle: "long",
+            });
+        }
+        else {
+            return custom(toDate(date), {
+                dateStyle: "long",
+            });
+        }
+    }
+    function fullMonthAndYear(date) {
+        if (typeof opts.monthFormat.current !== "function" &&
+            typeof opts.yearFormat.current !== "function") {
+            return new DateFormatter(locale, {
+                month: opts.monthFormat.current,
+                year: opts.yearFormat.current,
+            }).format(date);
+        }
+        const formattedMonth = typeof opts.monthFormat.current === "function"
+            ? opts.monthFormat.current(date.getMonth() + 1)
+            : new DateFormatter(locale, { month: opts.monthFormat.current }).format(date);
+        const formattedYear = typeof opts.yearFormat.current === "function"
+            ? opts.yearFormat.current(date.getFullYear())
+            : new DateFormatter(locale, { year: opts.yearFormat.current }).format(date);
+        return `${formattedMonth} ${formattedYear}`;
+    }
+    function fullMonth(date) {
+        return new DateFormatter(locale, { month: "long" }).format(date);
+    }
+    function fullYear(date) {
+        return new DateFormatter(locale, { year: "numeric" }).format(date);
+    }
+    function toParts(date, options) {
+        if (isZonedDateTime(date)) {
+            return new DateFormatter(locale, {
+                ...options,
+                timeZone: date.timeZone,
+            }).formatToParts(toDate(date));
+        }
+        else {
+            return new DateFormatter(locale, options).formatToParts(toDate(date));
+        }
+    }
+    function dayOfWeek(date, length = "narrow") {
+        return new DateFormatter(locale, { weekday: length }).format(date);
+    }
+    function dayPeriod(date, hourCycle = undefined) {
+        const parts = new DateFormatter(locale, {
+            hour: "numeric",
+            minute: "numeric",
+            hourCycle: hourCycle === 24 ? "h23" : undefined,
+        }).formatToParts(date);
+        const value = parts.find((p) => p.type === "dayPeriod")?.value;
+        if (value === "PM") {
+            return "PM";
+        }
+        return "AM";
+    }
+    function part(dateObj, type, options = {}) {
+        const opts = { ...defaultPartOptions, ...options };
+        const parts = toParts(dateObj, opts);
+        const part = parts.find((p) => p.type === type);
+        return part ? part.value : "";
+    }
+    return {
+        setLocale,
+        getLocale,
+        fullMonth,
+        fullYear,
+        fullMonthAndYear,
+        toParts,
+        custom,
+        part,
+        dayPeriod,
+        selectedDate,
+        dayOfWeek,
+    };
+}
+export function createTimeFormatter(initialLocale) {
+    let locale = initialLocale;
+    function setLocale(newLocale) {
+        locale = newLocale;
+    }
+    function getLocale() {
+        return locale;
+    }
+    function custom(date, options) {
+        return new DateFormatter(locale, options).format(date);
+    }
+    function selectedTime(date) {
+        return custom(toDate(convertTimeValueToDateValue(date)), {
+            timeStyle: "long",
+        });
+    }
+    function toParts(timeValue, options) {
+        const dateValue = convertTimeValueToDateValue(timeValue);
+        if (isZonedDateTime(dateValue)) {
+            return new DateFormatter(locale, {
+                ...options,
+                timeZone: dateValue.timeZone,
+            }).formatToParts(toDate(dateValue));
+        }
+        else {
+            return new DateFormatter(locale, options).formatToParts(toDate(dateValue));
+        }
+    }
+    function dayPeriod(date, hourCycle = undefined) {
+        const parts = new DateFormatter(locale, {
+            hour: "numeric",
+            minute: "numeric",
+            hourCycle: hourCycle === 24 ? "h23" : undefined,
+        }).formatToParts(date);
+        const value = parts.find((p) => p.type === "dayPeriod")?.value;
+        if (value === "PM")
+            return "PM";
+        return "AM";
+    }
+    function part(dateObj, type, options = {}) {
+        const opts = { ...defaultPartOptions, ...options };
+        const parts = toParts(dateObj, opts);
+        const part = parts.find((p) => p.type === type);
+        return part ? part.value : "";
+    }
+    return {
+        setLocale,
+        getLocale,
+        toParts,
+        custom,
+        part,
+        dayPeriod,
+        selectedTime,
+    };
+}

package/dist/internal/date-time/placeholders.d.ts

@@ -0,0 +1,8 @@
+declare const supportedLocales: readonly ["ach", "af", "am", "an", "ar", "ast", "az", "be", "bg", "bn", "br", "bs", "ca", "cak", "ckb", "cs", "cy", "da", "de", "dsb", "el", "en", "eo", "es", "et", "eu", "fa", "ff", "fi", "fr", "fy", "ga", "gd", "gl", "he", "hr", "hsb", "hu", "ia", "id", "it", "ja", "ka", "kk", "kn", "ko", "lb", "lo", "lt", "lv", "meh", "ml", "ms", "nl", "nn", "no", "oc", "pl", "pt", "rm", "ro", "ru", "sc", "scn", "sk", "sl", "sr", "sv", "szl", "tg", "th", "tr", "uk", "zh-CN", "zh-TW"];
+declare const placeholderFields: readonly ["year", "month", "day"];
+type SupportedLocale = (typeof supportedLocales)[number];
+type PlaceholderField = (typeof placeholderFields)[number];
+export type PlaceholderMap = Record<SupportedLocale, Record<PlaceholderField, string>>;
+type Field = "era" | "year" | "month" | "day" | "hour" | "minute" | "second" | "dayPeriod";
+export declare function getPlaceholder(field: Field, value: string, locale: SupportedLocale | (string & {})): string;
+export {};