/**
 * Header-only triage that does not throw.
 *
 * Layer 6. This is the path that has to work when every other path has failed, which makes it the
 * one place in edfcore where `try`/`catch` is the right tool rather than a way of losing
 * information. Everywhere else a malformed file throws or records a diagnostic; here a malformed
 * file becomes `ok: false` plus the diagnostic that would have been thrown, so a caller can
 * triage a directory of unknown files without wrapping each call.
 *
 * Two boundaries keep that promise honest:
 *
 * - Only an `EdfError` is converted. Anything else is a bug in edfcore and is rethrown, because
 *   swallowing it would turn "this file is broken" into a claim we cannot support.
 * - The reads happen OUTSIDE the catch, so a source-level failure — a dead socket, a file that
 *   vanished — still rejects. `inspectEdf` promises not to throw about CONTENT; it never promised
 *   to hide I/O.
 *
 * At most 128 KiB is read, which is the full header of a file with up to 511 signals. A header
 * larger than that is reported as such instead of being half-parsed.
 */
import type { ByteSource, EdfInspection, ReadOptions } from './types.js';
/**
 * Read at most 128 KiB and say what the file is.
 *
 * `ok` is true only when the header parsed AND carried no error-severity diagnostic — a signal
 * whose scale edfcore refuses is an error even though the header itself is readable, because
 * physical units are unavailable for it. Warnings leave `ok` true: the file is impolite, and what
 * it reports is still true.
 *
 * The one case where `ok` is false without an error-severity diagnostic is a header above the
 * ceiling: nothing was parsed, so there is nothing to be right or wrong about, and
 * `HEADER_EXCEEDS_INSPECTION_BUDGET` says so and names the call that will read it.
 */
export declare function inspectEdf(source: ByteSource, options?: ReadOptions): Promise<EdfInspection>;
//# sourceMappingURL=inspect.d.ts.map