import type { DateInput } from '../utils/date-value.js'; import type { PrimitivePropsWithRef } from '../utils/primitive.js'; /** Props for a readable timestamp element. */ export interface TimeProps extends Omit, 'dateTime'> { /** Instant to render: `Date`, ISO-8601 string, or date-only string as local date. */ value: DateInput; /** * Relative label ("3 hours ago") measured from `now`; `datetime` keeps the instant. * @default false */ relative?: boolean | undefined; /** * When `relative`, put absolute formatted date in `title` (relative labels are lossy). * @default true */ absoluteTitle?: boolean | undefined; /** * BCP-47 locale for the formatted text. * @default undefined — runtime locale */ locale?: string | undefined; /** * Reference instant for relative labels; supply to control re-renders. * @default undefined — read once at render */ now?: Date | number | undefined; }