/**
 * 把调用文件格式化为稳定且紧凑的展示路径，供 Plain 与 JSON 日志共享。
 *
 * @param file 栈帧中的原始文件标识。
 * @param projectRoot Logger 初始化时固定的项目目录。
 * @returns 依赖相对路径、项目相对路径或规范化后的原始路径，必要时折叠中间目录。
 * @throws 不主动抛出异常。
 */
export declare function formatLogPositionPath(file: string, projectRoot: string): string;
/**
 * 从 V8 栈文本中选择首个外部调用帧，并生成不含列号的稳定调用位置。
 *
 * @param stack V8 Error stack 文本。
 * @param projectRoot Logger 初始化时固定的项目目录。
 * @returns `path:line` 格式的位置；无法解析有效调用帧时返回 undefined。
 * @throws 不主动抛出异常。
 */
export declare function parseLogPositionStack(stack: string | undefined, projectRoot: string): string | undefined;
/**
 * 捕获首个业务调用栈帧，帮助日志使用者定位调用点，同时隐藏日志库自身实现栈。
 *
 * @param projectRoot Logger 初始化时固定的项目目录。
 * @returns `path:line` 格式的位置；无法解析调用栈时返回 undefined。
 * @throws 不主动抛出异常。
 */
export declare function captureLogPosition(projectRoot?: string): string | undefined;
//# sourceMappingURL=LogPosition.d.ts.map