import { LightSpanRecord } from '@mastra/core/storage';
/**
 * Derives previous/next span navigation handlers from a trace's lightweight spans.
 * Returns undefined for handlers that are out of bounds so the consumer can render disabled UI.
 */
export declare function useTraceSpanNavigation(lightSpans: LightSpanRecord[] | undefined, featuredSpanId: string | null | undefined, onSpanChange: (spanId: string) => void): {
    handlePreviousSpan: (() => void) | undefined;
    handleNextSpan: (() => void) | undefined;
    timelineSpanIds: string[];
};
