import type { GenericFunction } from "./logger.js";
import "./setup.js";
/**
 * Log at the debug level.
 *
 * This function is a pass-through to the default logger's `debug` method. By
 * default, this function is a no-op. To enable debug logging, set call
 * {@linkcode https://jsr.io/@std/log/doc/setup/~/setup | setup} and set the
 * default level to `DEBUG`.
 *
 * @template T The type of the message to log.
 * @param msg The message to log.
 * @param args Arguments to be formatted into the message.
 * @returns The message that was logged.
 *
 * @example Usage without setup
 * ```ts
 * import { debug } from "@std/log/debug";
 * import { assertEquals } from "@std/assert/equals";
 *
 * assertEquals(debug("This is a debug message."), "This is a debug message.");
 * // Prints: ""
 *
 * assertEquals(debug(() => "This is a debug message."), undefined);
 * // Prints: ""
 * ```
 *
 * @example Usage with setup
 * ```ts
 * import { ConsoleHandler, debug, setup } from "@std/log";
 * import { assertEquals } from "@std/assert/equals";
 *
 * setup({
 *   handlers: {
 *     default: new ConsoleHandler("DEBUG"),
 *   },
 *   loggers: {
 *     default: {
 *       level: "DEBUG",
 *       handlers: ["default"],
 *     },
 *   },
 * });
 *
 * assertEquals(debug("This is a debug message."), "This is a debug message.");
 *
 * assertEquals(
 *   debug(() => "This is a debug message."),
 *   "This is a debug message.",
 * );
 * ```
 */
export declare function debug<T>(msg: () => T, ...args: unknown[]): T | undefined;
/**
 * Log at the debug level.
 *
 * This function is a pass-through to the default logger's `debug` method. By
 * default, this function is a no-op. To enable debug logging, set call
 * {@linkcode https://jsr.io/@std/log/doc/setup/~/setup | setup} and set the
 * default level to `DEBUG`.
 *
 * @template T The type of the message to log.
 * @param msg The message to log.
 * @param args Arguments to be formatted into the message.
 * @returns The message that was logged.
 *
 * @example Usage without setup
 * ```ts
 * import { debug } from "@std/log/debug";
 * import { assertEquals } from "@std/assert/equals";
 *
 * assertEquals(debug("This is a debug message."), "This is a debug message.");
 * // Prints: ""
 *
 * assertEquals(debug(() => "This is a debug message."), undefined);
 * // Prints: ""
 * ```
 *
 * @example Usage with setup
 * ```ts
 * import { ConsoleHandler, debug, setup } from "@std/log";
 * import { assertEquals } from "@std/assert/equals";
 *
 * setup({
 *   handlers: {
 *     default: new ConsoleHandler("DEBUG"),
 *   },
 *   loggers: {
 *     default: {
 *       level: "DEBUG",
 *       handlers: ["default"],
 *     },
 *   },
 * });
 *
 * assertEquals(debug("This is a debug message."), "This is a debug message.");
 *
 * assertEquals(
 *   debug(() => "This is a debug message."),
 *   "This is a debug message.",
 * );
 * ```
 */
export declare function debug<T>(msg: T extends GenericFunction ? never : T, ...args: unknown[]): T;
//# sourceMappingURL=debug.d.ts.map