import type { AlwatrLogger } from './type.js';
/**
 * Create a logger function for fancy console debug with custom scope.
 *
 * - `color` is optional and automatically selected from an internal list.
 * - Debug methods (`logMethod`, `logMethodArgs`, …) exist **only in development builds**
 *   and are additionally gated at runtime by `ALWATR_DEBUG` (localStorage) or
 *   `process.env.ALWATR_DEBUG`.
 * - In production builds the debug methods are `undefined` AND their implementation is
 *   removed from the bundle, so `logger.logMethod?.(…)` call sites are no-ops.
 * - `name`, `banner`, `accident`, `error` are always available in all builds.
 * - All methods are pre-bound `console` functions, so DevTools reports the **caller's**
 *   file and line number, not the logger's.
 *
 * @param name Logger scope name.
 *
 * @example
 * ```ts
 * import {createLogger} from '@alwatr/logger';
 * const logger = createLogger('my-module');
 *
 * DEV_MODE && logger.logMethodArgs?.('myMethod', {a: 1}); // Ignored when debug is off; stripped in prod builds.
 * ```
 */
export declare function createLogger(name: string): AlwatrLogger;
//# sourceMappingURL=logger.d.ts.map