import { default as React } from 'react';
import { Status } from '../../tokens/colors';
export interface TimelineProps {
    children: React.ReactNode;
    className?: string;
    testId?: string;
}
export interface TimelineItemProps {
    children?: React.ReactNode;
    className?: string;
    /** Timestamp — callers format it (e.g. via Intl.DateTimeFormat). */
    timestamp: React.ReactNode;
    /** Main line describing the event. */
    title: React.ReactNode;
    /** Optional "who did it" — rendered inline next to the timestamp. */
    actor?: React.ReactNode;
    /** Dot color — defaults to neutral. */
    status?: Status;
    /**
     * Optional custom dot content. Replaces the solid dot entirely. Useful for
     * small icons (e.g. Lucide) sized at h-3 w-3.
     */
    icon?: React.ReactNode;
    testId?: string;
}
/**
 * Vertical timeline for chronological event lists (audit logs, order history,
 * registration activity, business events).
 *
 * @beta This component is experimental. The prop shape and visual design may
 * change before release.
 *
 * @example
 * <Timeline>
 *   <Timeline.Item timestamp="2026-04-19 10:22" title="Order created" status="success" />
 *   <Timeline.Item timestamp="2026-04-19 10:25" title="Payment method updated" actor="Ada">
 *     <pre>{JSON.stringify(metadata, null, 2)}</pre>
 *   </Timeline.Item>
 * </Timeline>
 */
export declare const Timeline: React.FC<TimelineProps> & {
    Item: React.FC<TimelineItemProps>;
};
//# sourceMappingURL=Timeline.d.ts.map