/**
 * ProcessTimeline — a domain-neutral process-status component: an ordered set
 * of lifecycle steps, each `complete`, `current`, `upcoming`, `blocked`, or
 * `skipped`. It generalizes the app-local "how it works" / progress-tracker /
 * run-lifecycle markup found across products into one shared primitive.
 *
 * Data in via `items`, selection out via `onItemSelect` — the component fetches
 * nothing and knows no routes, statuses, or labels beyond the five generic
 * lifecycle positions. Callers map their own domain state to these.
 *
 * Choosing: ProcessTimeline is for a fixed, ordered process whose steps carry a
 * lifecycle status. For a chronological stream of past events use ActivityFeed
 * (or Timeline for a styled event rail); for a navigable wizard/pipeline with
 * per-step content and click-through use Stepper.
 *
 * Accessibility:
 *   - semantic `<ol>` / `<li>` ordering
 *   - the current step carries `aria-current="step"`
 *   - status is never color-only: every marker has a default icon (shape) and
 *     each item a visually-hidden status label (overridable via `statusLabels`)
 *   - interactive items are real `<button>`s (keyboard-operable, `aria-pressed`)
 *
 * Responsive: the root is a `@container` scope. Vertical timelines are narrow-
 * friendly as-is; horizontal timelines hide per-step labels below `@2xl` and
 * show a compact "Step x of n" summary instead (mirrors Stepper).
 *
 * Motion: marker/connector color changes transition on the token duration and
 * collapse to instant under `prefers-reduced-motion`. No JS-driven animation.
 */
import type { ReactNode } from "react";
import { type ProcessTimelineDensity, type ProcessTimelineItemStatus, type ProcessTimelineOrientation } from "./variants.js";
export * from "./variants.js";
export type ProcessTimelineItem = {
    id: string;
    label: ReactNode;
    description?: ReactNode;
    /** Extra context under the label (badges, source markers, counts …). */
    metadata?: ReactNode;
    /** Timestamp or other secondary meta, shown beside/under the label. */
    timestamp?: ReactNode;
    status: ProcessTimelineItemStatus;
    /** Overrides the status default marker icon. */
    icon?: ReactNode;
};
export type ProcessTimelineProps = {
    items: readonly ProcessTimelineItem[];
    orientation?: ProcessTimelineOrientation;
    density?: ProcessTimelineDensity;
    /** Draw connector lines between markers. Defaults to `true`. */
    showConnectors?: boolean;
    /** When provided, items become keyboard-operable buttons. */
    onItemSelect?: (id: string) => void;
    selectedItemId?: string;
    /** Accessible name for the list. */
    ariaLabel?: string;
    /** English by default; override to localize the visually-hidden status text. */
    statusLabels?: Partial<Record<ProcessTimelineItemStatus, string>>;
    /**
     * Formats the compact "current step" summary shown below a horizontal
     * timeline in narrow containers. Defaults to English
     * "Step {step} of {total} — {label}".
     */
    summaryLabel?: (step: number, total: number, label: ReactNode) => ReactNode;
};
export declare function ProcessTimeline({ items, orientation, density, showConnectors, onItemSelect, selectedItemId, ariaLabel, statusLabels, summaryLabel, }: ProcessTimelineProps): import("react").JSX.Element;
//# sourceMappingURL=index.d.ts.map