/**
 * @fileoverview Numbered step indicator with connector lines.
 * @author Saasflare™
 * A horizontal or vertical step sequence showing progress through stages.
 * Pure visual — no form/wizard logic.
 * @module packages/ui/components/ui/steps
 * @package ui
 *
 * @component
 * @example
 * import { Steps, Step } from '@saasflare/ui';
 * <Steps current={1}>
 *   <Step title="Sign Up" />
 *   <Step title="Configure" />
 *   <Step title="Deploy" />
 * </Steps>
 */
import { type ReactNode } from "react";
import { type SaasflareComponentProps } from "../../providers";
/** Props for the Steps container. */
export interface StepsProps extends SaasflareComponentProps {
    /** Step children. */
    children: ReactNode;
    /** Index of the current active step (0-based). Default: `0` */
    current?: number;
    /** Layout direction. Default: `"horizontal"` */
    direction?: "horizontal" | "vertical";
    /** Additional class names. */
    className?: string;
}
/** Props for an individual Step. */
export interface StepProps {
    /** Step title text. */
    title: string;
    /** Optional description below the title. */
    description?: string;
    /** Optional icon to replace the step number. */
    icon?: ReactNode;
    /**
     * Marks the step as skippable. Purely cosmetic here — renders a small
     * "Optional" sub-label beneath the title. Consumed by `Stepper` to infer its
     * `optional` step indices. Default: `false`
     */
    optional?: boolean;
    /** Additional class names. */
    className?: string;
}
/**
 * Step sequence indicator with numbered circles and connector lines.
 *
 * @component
 * @package ui
 */
export declare function Steps({ children, current, direction, className, surface, radius, animated, iconWeight, }: StepsProps): import("react/jsx-runtime").JSX.Element;
/**
 * Individual step within a Steps container.
 * This component is a data carrier — it renders nothing on its own.
 *
 * @component
 * @package ui
 */
export declare function Step(_props: StepProps): null;