/**
 * autoTimeline — Chronological event feed with status dots and badges.
 *
 * Ported from mcp-generator-3.x display_tools.py → show_timeline.
 */
import { type ContainerComponent } from '../core/component.js';
import type { BadgeVariant } from '../components/data/index.js';
export interface AutoTimelineEvent {
    /** Event title. */
    title: string;
    /** Timestamp string. */
    timestamp: string;
    /** Optional description. */
    description?: string;
    /** Status string — mapped to dot color. */
    status?: string;
    /** Badge text. */
    badge?: string;
    /** Badge variant. */
    badgeVariant?: BadgeVariant;
}
export interface AutoTimelineOptions {
    /** Timeline heading. */
    title?: string;
    /** Optional subtitle. */
    subtitle?: string;
}
/**
 * Auto-generate a chronological timeline.
 *
 * @example
 * ```ts
 * autoTimeline([
 *   { title: 'Order placed', timestamp: '2026-04-20 10:30', status: 'completed', badge: 'Done', badgeVariant: 'success' },
 *   { title: 'Processing', timestamp: '2026-04-20 11:00', status: 'active' },
 *   { title: 'Shipped', timestamp: '', status: 'pending' },
 * ], { title: 'Order Timeline' })
 * ```
 */
export declare function autoTimeline(events: AutoTimelineEvent[], options?: AutoTimelineOptions): ContainerComponent;
//# sourceMappingURL=timeline.d.ts.map