/**
 * @fileoverview Vertical timeline with scroll-driven beam animation.
 * @author Saasflare™
 * A chronological timeline where a beam progresses as the user scrolls.
 * Ideal for changelogs, roadmaps, and process steps.
 * @module packages/ui/components/ui/timeline
 * @package ui
 *
 * @component
 * @example
 * import { Timeline, TimelineItem } from '@saasflare/ui';
 * <Timeline>
 *   <TimelineItem title="v2.0 Released" date="March 2026">
 *     Major redesign with new dashboard.
 *   </TimelineItem>
 *   <TimelineItem title="v1.5 Released" date="January 2026">
 *     Added billing module.
 *   </TimelineItem>
 * </Timeline>
 */
import { type ReactNode } from "react";
import { type SaasflareComponentProps } from "../../providers";
/** Props for the Timeline container. */
export interface TimelineProps extends SaasflareComponentProps {
    /** TimelineItem children. */
    children: ReactNode;
    /** Additional class names. */
    className?: string;
}
/**
 * Vertical timeline with a scroll-driven progress beam.
 *
 * - Beam fills as the user scrolls through the timeline
 * - Each item fades in on scroll intersection
 * - Falls back to a static timeline when motion is disabled (reduced-motion or `animated={false}`)
 *
 * @component
 * @package ui
 */
export declare function Timeline({ children, className, surface, radius, animated, iconWeight, }: TimelineProps): import("react/jsx-runtime").JSX.Element;
/** Props for a TimelineItem. */
export interface TimelineItemProps extends SaasflareComponentProps {
    /** Item title. */
    title: string;
    /** Date or time label. */
    date?: string;
    /** Item content/description. */
    children: ReactNode;
    /** Additional class names. */
    className?: string;
}
/**
 * Individual item within a Timeline.
 *
 * - Content sits to the right of the track on desktop, left-aligned on mobile
 * - Dot indicator on the timeline track
 * - Fades in when scrolled into view (disabled when motion is off)
 *
 * @component
 * @package ui
 */
export declare function TimelineItem({ title, date, children, className, surface, radius, animated, iconWeight, }: TimelineItemProps): import("react/jsx-runtime").JSX.Element;