import type { CandleGap, CandleGapKind, CandlePoint } from "../types";
/** Built-in, overridable copy for gap bands and scrub tooltips. */
export declare function candleGapDefaultLabel(kind: CandleGapKind): string;
/** Find the explicit half-open gap containing `time`. Input must be start-sorted. */
export declare function pickCandleGapAtTime(gaps: CandleGap[], time: number): CandleGap | null;
/** Latest real candle strictly before `time`, preferring a newer live candle. */
export declare function previousCandleAtTime(candles: CandlePoint[], liveCandle: CandlePoint | null, time: number): CandlePoint | null;
/** Previous observed close for a bridged gap; `null` when no anchor exists. */
export declare function previousCandleCloseAtTime(candles: CandlePoint[], liveCandle: CandlePoint | null, time: number): number | null;
/** Whether a real candle starts in the bucket beginning at `bucketTime`. */
export declare function candleAtBucketTime(candles: CandlePoint[], liveCandle: CandlePoint | null, bucketTime: number, candleWidthSecs: number): CandlePoint | null;
/**
 * Bucket start under `time`, aligned to the nearest preceding real candle.
 * Returns `null` for a partial edge bucket, a bucket with real OHLC, or a gap
 * without a previous-close anchor.
 */
export declare function candleGapBucketStartAtTime(gap: CandleGap, time: number, candles: CandlePoint[], liveCandle: CandlePoint | null, candleWidthSecs: number): number | null;
//# sourceMappingURL=candleGaps.d.ts.map