/**
 * 跨层复用的诊断辅助函数。
 *
 * 从 v0.x 起散落在 parse/index.ts / transpile.ts / index.ts 三处，逐字节相同。
 * P0 抽到此处统一来源，避免改动重复。
 */
import type { SourceAdapterContext } from "./schema.js";
/** 把 unknown error 序列化成可读字符串。 */
export declare function errMsg(e: unknown): string;
/** 三通道 fallback: log → notify → console（pt-quality #9 + 自定义细节）。
 *  顺序：log 优先（持久 trace），再 notify（UI 瞬时），最后 console（debug 兜底）。
 *  v10.x：增 details 参数，让 log/UI 用户能看到 structured 上下文。 */
export declare function reportWarn(adapterCtx: SourceAdapterContext | undefined, msg: string, details?: Record<string, unknown>): void;
export declare function reportError(adapterCtx: SourceAdapterContext | undefined, msg: string, details?: Record<string, unknown>): void;