import { FixtureAtom, SourceFormat, CoreOpt, Fmt, LoopDir, Step, Artifact, NodeMark, LoopReport } from "../types/diagnostics.types.js";
import { HsonNode } from "../core/types.js";
export declare function coerce_entry(atom: FixtureAtom, entry: SourceFormat, opt: Pick<CoreOpt, "trace" | "failures" | "verbose" | "stopOnFirstFail">): {
    fmt: Fmt;
    text: string;
} | undefined;
export declare function safe_emit(fmt: Fmt, node: HsonNode, stepName: string, opt: CoreOpt, mark?: {
    lap: number;
    dir?: "cw" | "ccw";
    phase: "emit";
}): string | undefined;
export declare function safe_parse(fmt: Fmt, text: string, stepName: string, opt: CoreOpt, mark?: {
    lap: number;
    fmt: Fmt;
    phase: "parse" | "closure";
}): HsonNode | undefined;
export declare function rotate_ring(ring: readonly Fmt[], entry: Fmt): readonly Fmt[];
export declare function step_ok(opt: Pick<CoreOpt, "trace" | "failures" | "verbose" | "stopOnFirstFail">, step: string): void;
export declare function step_meh(opt: Pick<CoreOpt, "trace" | "failures" | "verbose" | "stopOnFirstFail">, step: string): void;
export declare function step_fail(opt: Pick<CoreOpt, "trace" | "failures" | "verbose" | "stopOnFirstFail">, step: string, error: string): void;
export declare function finalize(ok: boolean, times: number, dir: LoopDir | "dual", entry: SourceFormat, trace: Step[], failures: Step[], artifacts?: Artifact[], marks?: NodeMark[], final?: {
    fmt: Fmt;
    text: string;
}, dualFinals?: {
    cw: {
        fmt: Fmt;
        text: string;
    };
    ccw: {
        fmt: Fmt;
        text: string;
    };
}): LoopReport;
export declare function clamp_int(n: number, min: number, max: number): number;
export declare function err_to_string(err: unknown): string;
export declare function is_html_element(x: unknown): x is HTMLElement;
//# sourceMappingURL=diagnostics-helpers.d.ts.map