/**
 * logger.ts — pino 封装 VextLogger
 *
 * 基于 pino 实现框架日志接口，支持：
 *   - pretty / JSON 双模式（开发环境可读、生产环境结构化）
 *   - requestId 自动注入（通过 pino mixin hook + AsyncLocalStorage，无需手动传入）
 *   - child logger（携带额外上下文字段，如 service 名称）
 *   - 日志级别动态控制（config.logger.level）
 *
 * 设计说明：
 *   pino 的 mixin 钩子在每条日志写入前调用，从 requestContext（AsyncLocalStorage）
 *   中读取当前请求的 requestId 并附加到日志字段。这样所有日志自动携带 requestId，
 *   无论是在 handler、service 还是中间件中调用 app.logger。
 *
 *   child logger 通过 pino.child(bindings) 实现，子 logger 继承父 logger 的
 *   mixin/level/transport 配置，并额外携带 bindings 中的字段。
 *
 * @module lib/logger
 * @see 06a-logger.md（VextLogger 接口 + 使用方式）
 * @see IMPLEMENTATION-PLAN.md 任务 1.7
 */
import type { VextLogger, VextLoggerConfig } from "../types/app.js";
export declare function createLogger(config?: VextLoggerConfig, options?: {
    requestContextEnabled?: boolean;
}): VextLogger;
