/**
 * Record onsets to segments and gaps.
 *
 * Layer 4. Pure and synchronous, and structural only: it reports the shape the onsets actually
 * have and judges none of it. Monotonicity and the spacing rules belong to `time/timeline.ts`,
 * which is their sole owner — run `assertMonotonicOnsetArray` on the same array first, and every
 * segment then starts at or after the one before it.
 *
 * That is all monotonicity buys. It requires `onset[r] >= onset[r - 1]`, which an OVERLAP
 * satisfies: `onset[r]` can be at or after its predecessor and still before
 * `onset[r - 1] + recordDurationTicks`, and `buildSegmentation` then closes the earlier segment
 * past where the next one begins. The gap between them is negative, which is exactly what the
 * comment on `durationTicks` below says and what `index.gaps` reports for a real overlapping file.
 * This docblock claimed a gap "can then only have a non-negative duration" until 0.3.82, ninety
 * lines above the line saying otherwise.
 *
 * Only `buildRecordIndex` calls this, because only a complete traversal has every onset. The
 * boundary rule is the one edfcore states everywhere else: a new segment starts wherever
 * `onset[r] !== onset[r - 1] + recordDurationTicks`, in exact ticks. Not "differs by more than an
 * epsilon" — a float tolerance is how a one-sample overlap becomes invisible.
 *
 * Every second here is elapsed recording time, measured from record 0's start (see
 * `time/timeline.ts`), so `segment.startTicks` is the rebased value and
 * `ticksToSeconds(segment.startTicks) === segment.startSeconds` holds by construction.
 */
import type { EdfGap, EdfSegment } from '../types.js';
/**
 * A recording partitioned into contiguous runs and the gaps between them. Segments and gaps are
 * derived together and returned together on purpose: computed apart they can disagree about a
 * boundary, and a gap that no segment pair brackets describes a discontinuity nothing else sees.
 */
export interface Segmentation {
    /** In time order, contiguous within each entry, and covering every record exactly once. */
    readonly segments: readonly EdfSegment[];
    /** One per adjacent pair of segments, so `gaps.length === segments.length - 1` (or 0). */
    readonly gaps: readonly EdfGap[];
}
/**
 * `onsetTicks` holds one entry per record, record 0 first — the `BigInt64Array` that
 * `decodeAnnotations` returns for a full-file range fits directly.
 *
 * `originTicks` is the tick value that maps to `0` seconds. It defaults to `onsetTicks[0]`,
 * which is record 0's own onset and therefore the recording's sub-second start offset.
 */
export declare function buildSegmentation(onsetTicks: ArrayLike<bigint>, recordDurationTicks: bigint, originTicks?: bigint): Segmentation;
//# sourceMappingURL=segments.d.ts.map