import { ExternalStore } from "@snort/shared";
import { type QueryTraceEvent } from "./query";
export interface TimelineEntry {
    event: QueryTraceEvent;
    queryName?: string;
    runtime?: number;
}
export interface TraceTimelineSnapshot {
    entries: ReadonlyArray<TimelineEntry>;
    enabled: boolean;
}
/**
 * Collects and manages trace reports in a timeline
 */
export declare class TraceTimeline extends ExternalStore<TraceTimelineSnapshot> {
    #private;
    constructor();
    /**
     * Enable/disable timeline collection
     */
    setEnabled(enabled: boolean): void;
    get enabled(): boolean;
    takeSnapshot(): TraceTimelineSnapshot;
    /**
     * Add a trace event to the timeline
     */
    addTrace(event: QueryTraceEvent, queryName?: string): void;
    /**
     * Get all timeline entries
     */
    getEntries(): ReadonlyArray<TimelineEntry>;
    /**
     * Get entries within a time range
     */
    getEntriesInRange(startTime: number, endTime: number): Array<TimelineEntry>;
    /**
     * Get entries for a specific relay
     */
    getEntriesForRelay(relayAddress: string): Array<TimelineEntry>;
    /**
     * Get entries for a specific query
     */
    getEntriesForQuery(queryId: string): Array<TimelineEntry>;
    /**
     * Clear all timeline entries
     */
    clear(): void;
    /**
     * Export timeline to Google Trace Event Format (for Chrome tracing / Perfetto)
     * https://docs.google.com/document/d/1CvAClvFfyA5R-PhYUmn5OOQtYMH4h6I0nSsKchNAySU/preview
     */
    exportGoogleTrace(): {
        traceEvents: Record<string, unknown>[];
        displayTimeUnit: string;
        metadata: {
            "trace-type": string;
        };
    };
}
//# sourceMappingURL=trace-timeline.d.ts.map