@void.01/advanced-logger 0.0.0-stage → 0.4.0

package/dist/ansi.js

@@ -0,0 +1,219 @@
+"use strict";
+/**
+ * ANSI escape factory + named color catalog.
+ * Port of core.logging.ansi.AnsiEscape and AnsiColors.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RGB_BG = exports.RGB_FG = exports.BG_256 = exports.FG_256 = exports.BG_BRIGHT_WHITE = exports.BG_BRIGHT_CYAN = exports.BG_BRIGHT_MAGENTA = exports.BG_BRIGHT_BLUE = exports.BG_BRIGHT_YELLOW = exports.BG_BRIGHT_GREEN = exports.BG_BRIGHT_RED = exports.BG_BRIGHT_BLACK = exports.BG_WHITE = exports.BG_CYAN = exports.BG_MAGENTA = exports.BG_BLUE = exports.BG_YELLOW = exports.BG_GREEN = exports.BG_RED = exports.BG_BLACK = exports.FG_BRIGHT_WHITE = exports.FG_BRIGHT_CYAN = exports.FG_BRIGHT_MAGENTA = exports.FG_BRIGHT_BLUE = exports.FG_BRIGHT_YELLOW = exports.FG_BRIGHT_GREEN = exports.FG_BRIGHT_RED = exports.FG_BRIGHT_BLACK = exports.FG_WHITE = exports.FG_CYAN = exports.FG_MAGENTA = exports.FG_BLUE = exports.FG_YELLOW = exports.FG_GREEN = exports.FG_RED = exports.FG_BLACK = exports.colorize = exports.ITALIC = exports.DIM = exports.BOLD = exports.RESET = exports.bg256 = exports.fg256 = exports.rgbBgHex = exports.rgbFgHex = exports.rgbBg = exports.rgbFg = void 0;
+exports.sgr = sgr;
+exports.fg16 = fg16;
+exports.bg16 = bg16;
+exports.stripAnsi = stripAnsi;
+exports.fgFromStyle = fgFromStyle;
+const ESC = '\u001b[';
+// -- Escape factory ----------------------------------------------------------
+function sgr(...codes) {
+    if (codes.length === 0)
+        throw new RangeError('sgr() requires at least one code');
+    return `${ESC}${codes.join(';')}m`;
+}
+function fg16(code) {
+    if (!((code >= 30 && code <= 37) || (code >= 90 && code <= 97))) {
+        throw new RangeError(`16-color FG code must be in 30-37 or 90-97 (got ${code})`);
+    }
+    return sgr(code);
+}
+function bg16(code) {
+    if (!((code >= 40 && code <= 47) || (code >= 100 && code <= 107))) {
+        throw new RangeError(`16-color BG code must be in 40-47 or 100-107 (got ${code})`);
+    }
+    return sgr(code);
+}
+function validateRgb(r, g, b) {
+    for (const c of [r, g, b]) {
+        if (!Number.isInteger(c) || c < 0 || c > 255) {
+            throw new RangeError(`RGB components must be in 0-255 (got r=${r}, g=${g}, b=${b})`);
+        }
+    }
+}
+function validate256(code) {
+    if (!Number.isInteger(code) || code < 0 || code > 255) {
+        throw new RangeError(`256-color code must be in 0-255 (got ${code})`);
+    }
+}
+const rgbFg = (r, g, b) => {
+    validateRgb(r, g, b);
+    return `${ESC}38;2;${r};${g};${b}m`;
+};
+exports.rgbFg = rgbFg;
+const rgbBg = (r, g, b) => {
+    validateRgb(r, g, b);
+    return `${ESC}48;2;${r};${g};${b}m`;
+};
+exports.rgbBg = rgbBg;
+/** 0xRRGGBB overloads. */
+const rgbFgHex = (rgb) => (0, exports.rgbFg)((rgb >> 16) & 0xff, (rgb >> 8) & 0xff, rgb & 0xff);
+exports.rgbFgHex = rgbFgHex;
+const rgbBgHex = (rgb) => (0, exports.rgbBg)((rgb >> 16) & 0xff, (rgb >> 8) & 0xff, rgb & 0xff);
+exports.rgbBgHex = rgbBgHex;
+const fg256 = (code) => {
+    validate256(code);
+    return `${ESC}38;5;${code}m`;
+};
+exports.fg256 = fg256;
+const bg256 = (code) => {
+    validate256(code);
+    return `${ESC}48;5;${code}m`;
+};
+exports.bg256 = bg256;
+exports.RESET = sgr(0);
+exports.BOLD = sgr(1);
+exports.DIM = sgr(2);
+exports.ITALIC = sgr(3);
+const colorize = (text, ansi, bg = '') => `${ansi}${bg}${text}${exports.RESET}`;
+exports.colorize = colorize;
+// -- Strip / extract ---------------------------------------------------------
+const ANSI_RE = /\u001b\[[;\d]*m/g;
+function stripAnsi(str) {
+    return str == null ? '' : str.replace(ANSI_RE, '');
+}
+/** Derive a foreground escape from a style string (bg-only styles map to their matching fg). */
+function fgFromStyle(style) {
+    if (style == null)
+        return exports.FG_BRIGHT_WHITE;
+    const fg = /(\u001b\[3\d{1,2}(;\d{1,2})?m)/.exec(style);
+    if (fg)
+        return fg[1];
+    const m8 = /(\u001b\[4)(\d)(m)/.exec(style);
+    if (m8) {
+        const c = `\u001b[3${m8[2]}m`;
+        return c === exports.FG_BLACK ? exports.FG_BRIGHT_WHITE : c;
+    }
+    const m256 = /(\u001b\[48;5;)(\d+)(m)/.exec(style);
+    if (m256)
+        return `\u001b[38;5;${m256[2]}m`;
+    return exports.FG_BRIGHT_WHITE;
+}
+// -- Color catalog (data only) ----------------------------------------------
+exports.FG_BLACK = fg16(30);
+exports.FG_RED = fg16(31);
+exports.FG_GREEN = fg16(32);
+exports.FG_YELLOW = fg16(33);
+exports.FG_BLUE = fg16(34);
+exports.FG_MAGENTA = fg16(35);
+exports.FG_CYAN = fg16(36);
+exports.FG_WHITE = fg16(37);
+exports.FG_BRIGHT_BLACK = fg16(90);
+exports.FG_BRIGHT_RED = fg16(91);
+exports.FG_BRIGHT_GREEN = fg16(92);
+exports.FG_BRIGHT_YELLOW = fg16(93);
+exports.FG_BRIGHT_BLUE = fg16(94);
+exports.FG_BRIGHT_MAGENTA = fg16(95);
+exports.FG_BRIGHT_CYAN = fg16(96);
+exports.FG_BRIGHT_WHITE = fg16(97);
+exports.BG_BLACK = bg16(40);
+exports.BG_RED = bg16(41);
+exports.BG_GREEN = bg16(42);
+exports.BG_YELLOW = bg16(43);
+exports.BG_BLUE = bg16(44);
+exports.BG_MAGENTA = bg16(45);
+exports.BG_CYAN = bg16(46);
+exports.BG_WHITE = bg16(47);
+exports.BG_BRIGHT_BLACK = bg16(100);
+exports.BG_BRIGHT_RED = bg16(101);
+exports.BG_BRIGHT_GREEN = bg16(102);
+exports.BG_BRIGHT_YELLOW = bg16(103);
+exports.BG_BRIGHT_BLUE = bg16(104);
+exports.BG_BRIGHT_MAGENTA = bg16(105);
+exports.BG_BRIGHT_CYAN = bg16(106);
+exports.BG_BRIGHT_WHITE = bg16(107);
+exports.FG_256 = {
+    ORANGE: (0, exports.fg256)(208),
+    GOLD: (0, exports.fg256)(220),
+    LIME: (0, exports.fg256)(118),
+    SKY: (0, exports.fg256)(117),
+    VIOLET: (0, exports.fg256)(135),
+    PINK: (0, exports.fg256)(205),
+    TEAL: (0, exports.fg256)(80),
+    SALMON: (0, exports.fg256)(209),
+    GREY_DARK: (0, exports.fg256)(240),
+    GREY_MID: (0, exports.fg256)(246),
+    GREY_LIGHT: (0, exports.fg256)(252),
+    NAVY: (0, exports.fg256)(17),
+    MAROON: (0, exports.fg256)(88),
+    OLIVE: (0, exports.fg256)(100),
+    INDIGO: (0, exports.fg256)(54),
+};
+exports.BG_256 = {
+    ORANGE: (0, exports.bg256)(208),
+    DARK_GREY: (0, exports.bg256)(235),
+    MID_GREY: (0, exports.bg256)(238),
+    NAVY: (0, exports.bg256)(17),
+    DARK_GREEN: (0, exports.bg256)(22),
+    DARK_TEAL: (0, exports.bg256)(23),
+    DARK_PURPLE: (0, exports.bg256)(53),
+    DARK_OLIVE: (0, exports.bg256)(94),
+    DARK_RED: (0, exports.bg256)(52),
+    MAROON: (0, exports.bg256)(88),
+    INDIGO: (0, exports.bg256)(54),
+};
+exports.RGB_FG = {
+    SNOW_WHITE: (0, exports.rgbFg)(240, 242, 245),
+    SOFT_WHITE: (0, exports.rgbFg)(210, 215, 220),
+    COOL_GREY: (0, exports.rgbFg)(140, 150, 165),
+    WARM_GREY: (0, exports.rgbFg)(160, 158, 150),
+    DEEP_CHARCOAL: (0, exports.rgbFg)(28, 30, 38),
+    GOLD: (0, exports.rgbFg)(255, 200, 50),
+    AMBER: (0, exports.rgbFg)(255, 170, 0),
+    PEACH: (0, exports.rgbFg)(255, 185, 110),
+    CORAL: (0, exports.rgbFg)(255, 105, 85),
+    SALMON: (0, exports.rgbFg)(255, 140, 105),
+    HOT_PINK: (0, exports.rgbFg)(255, 75, 170),
+    SKY_BLUE: (0, exports.rgbFg)(80, 185, 255),
+    ELECTRIC_BLUE: (0, exports.rgbFg)(50, 140, 255),
+    STEEL_CYAN: (0, exports.rgbFg)(90, 220, 220),
+    MINT: (0, exports.rgbFg)(60, 220, 175),
+    LIME_GREEN: (0, exports.rgbFg)(100, 240, 120),
+    NEON_GREEN: (0, exports.rgbFg)(80, 255, 120),
+    LAVENDER: (0, exports.rgbFg)(185, 155, 255),
+    VIOLET: (0, exports.rgbFg)(160, 100, 255),
+    PURPLE: (0, exports.rgbFg)(155, 111, 224),
+    DARKER_PURPLE: (0, exports.rgbFg)(122, 79, 196),
+    DEEP_PURPLE: (0, exports.rgbFg)(90, 54, 163),
+    DEEP_RED: (0, exports.rgbFg)(210, 48, 48),
+    DEEP_GREEN: (0, exports.rgbFg)(38, 185, 72),
+    DEEP_CYAN: (0, exports.rgbFg)(28, 188, 196),
+    DEEP_AMBER: (0, exports.rgbFg)(200, 155, 20),
+    DEEP_VIOLET: (0, exports.rgbFg)(152, 88, 210),
+    DEEP_ORANGE: (0, exports.rgbFg)(205, 88, 18),
+    DEEP_PINK: (0, exports.rgbFg)(210, 40, 125),
+};
+exports.RGB_BG = {
+    CHARCOAL: (0, exports.rgbBg)(35, 38, 46),
+    DARK_SLATE: (0, exports.rgbBg)(28, 32, 42),
+    MIDNIGHT: (0, exports.rgbBg)(16, 18, 26),
+    NEAR_BLACK: (0, exports.rgbBg)(20, 22, 30),
+    CARBON: (0, exports.rgbBg)(28, 28, 32),
+    STEEL_DARK: (0, exports.rgbBg)(48, 52, 62),
+    DARK_AMBER: (0, exports.rgbBg)(95, 62, 0),
+    VIVID_AMBER: (0, exports.rgbBg)(170, 105, 0),
+    RUST: (0, exports.rgbBg)(110, 48, 20),
+    CRIMSON: (0, exports.rgbBg)(100, 20, 25),
+    DARK_WINE: (0, exports.rgbBg)(90, 16, 36),
+    MAROON: (0, exports.rgbBg)(110, 22, 22),
+    ORANGE_VIVID: (0, exports.rgbBg)(200, 100, 0),
+    DARK_FOREST: (0, exports.rgbBg)(18, 52, 28),
+    DARK_OCEAN: (0, exports.rgbBg)(14, 38, 72),
+    DARK_TEAL: (0, exports.rgbBg)(14, 66, 66),
+    DARK_INDIGO: (0, exports.rgbBg)(28, 24, 68),
+    DARK_PURPLE: (0, exports.rgbBg)(45, 22, 72),
+    DARK_CYAN: (0, exports.rgbBg)(0, 80, 100),
+    SOFT_WHITE: (0, exports.rgbBg)(238, 240, 245),
+    LIGHT_GREY: (0, exports.rgbBg)(205, 210, 218),
+    WARM_AMBER_LT: (0, exports.rgbBg)(190, 140, 15),
+    TOMATO_RED: (0, exports.rgbBg)(190, 45, 45),
+    HOT_PINK: (0, exports.rgbBg)(195, 38, 115),
+    NEON_PURPLE: (0, exports.rgbBg)(115, 18, 175),
+    ELECTRIC_TEAL: (0, exports.rgbBg)(0, 150, 170),
+};
+//# sourceMappingURL=ansi.js.map

package/dist/ansi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ansi.js","sourceRoot":"","sources":["../src/ansi.ts"],"names":[],"mappings":"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"}

package/dist/caller.d.ts

@@ -0,0 +1,21 @@
+import type { LogConfig } from './config';
+/**
+ * Stack-based caller resolution. Port of getCallerString / getProjectCallChain.
+ * Parses V8 stack text; the logger's own folder is always excluded, which replaces
+ * Java's name-prefix suppression (and avoids dropping user methods such as `login`).
+ */
+interface Frame {
+    display: string;
+    file: string;
+}
+export declare function parseStack(stack: string | undefined): Frame[];
+export interface CallerInfo {
+    /** "Callee.method <- Caller.method" (arrow is U+2190), plain text. Empty when unknown. */
+    caller: string;
+    /** Full in-project chain, leaf first, joined by " <- ". */
+    chain: string;
+}
+export declare const ARROW = " \u2190 ";
+export declare function resolveCaller(cfg: LogConfig): CallerInfo;
+export {};
+//# sourceMappingURL=caller.d.ts.map

package/dist/caller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"caller.d.ts","sourceRoot":"","sources":["../src/caller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C;;;;GAIG;AAEH,UAAU,KAAK;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAsCD,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,KAAK,EAAE,CAU7D;AAiCD,MAAM,WAAW,UAAU;IACzB,0FAA0F;IAC1F,MAAM,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,KAAK,EAAE,MAAM,CAAC;CACf;AAED,eAAO,MAAM,KAAK,aAAQ,CAAC;AAE3B,wBAAgB,aAAa,CAAC,GAAG,EAAE,SAAS,GAAG,UAAU,CAgCxD"}

package/dist/caller.js

@@ -0,0 +1,129 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ARROW = void 0;
+exports.parseStack = parseStack;
+exports.resolveCaller = resolveCaller;
+const FRAME_RE = /^\s*at\s+(?:(async)\s+)?(?:(new)\s+)?(?:(.+?)\s+\()?(.+?):(\d+):(\d+)\)?\s*$/;
+const PLAIN_OBJECT_TYPES = new Set(['Object', 'Module', 'Function', 'Promise', 'Array']);
+function normalizeFile(raw) {
+    let f = raw;
+    if (f.startsWith('file://')) {
+        f = f.slice('file://'.length);
+        if (/^\/[A-Za-z]:/.test(f))
+            f = f.slice(1);
+        try {
+            f = decodeURIComponent(f);
+        }
+        catch {
+            /* keep raw */
+        }
+    }
+    return f.replace(/\\/g, '/');
+}
+function fileBase(file) {
+    const name = file.slice(file.lastIndexOf('/') + 1);
+    const dot = name.lastIndexOf('.');
+    return dot > 0 ? name.slice(0, dot) : name;
+}
+function displayName(fn, file, isNew) {
+    const base = fileBase(file);
+    if (!fn)
+        return base;
+    const name = fn.replace(/\s*\[as [^\]]*\]$/, '');
+    if (isNew)
+        return `${name.split('.').pop()}.(constructor)`;
+    const dot = name.lastIndexOf('.');
+    if (dot < 0)
+        return name === '<anonymous>' ? base : `${base}.${name}`;
+    const type = name.slice(0, dot);
+    const method = name.slice(dot + 1);
+    const owner = PLAIN_OBJECT_TYPES.has(type) ? base : type;
+    return method === '<anonymous>' ? owner : `${owner}.${method}`;
+}
+function parseStack(stack) {
+    if (!stack)
+        return [];
+    const frames = [];
+    for (const line of stack.split('\n')) {
+        const m = FRAME_RE.exec(line);
+        if (!m)
+            continue;
+        const file = normalizeFile(m[4]);
+        frames.push({ display: displayName(m[3], file, m[2] === 'new'), file });
+    }
+    return frames;
+}
+// Folder holding this logger (src/ or dist/). Any frame inside it is logger-internal.
+const SELF_DIR = (() => {
+    const first = parseStack(new Error().stack)[0];
+    if (!first)
+        return '\u0000';
+    return first.file.slice(0, first.file.lastIndexOf('/') + 1);
+})();
+function filteredOut(f, cfg) {
+    if (f.file.startsWith(SELF_DIR))
+        return true;
+    const method = f.display.slice(f.display.lastIndexOf('.') + 1);
+    for (const p of cfg.suppressMethodPrefixes)
+        if (method.startsWith(p))
+            return true;
+    if (cfg.includeOnlyPrefixes.size > 0) {
+        let hit = false;
+        for (const p of cfg.includeOnlyPrefixes) {
+            if (f.file.includes(p) || f.display.startsWith(p)) {
+                hit = true;
+                break;
+            }
+        }
+        if (!hit)
+            return true;
+    }
+    for (const s of cfg.suppressContains)
+        if (f.display.includes(s) || f.file.includes(s))
+            return true;
+    return false;
+}
+function isProjectFrame(f, cfg) {
+    if (f.file.startsWith(SELF_DIR) || f.file.includes('node_modules') || f.file.startsWith('node:'))
+        return false;
+    const roots = cfg.projectRoots.map((r) => r.replace(/\\/g, '/'));
+    return roots.some((r) => f.file.startsWith(r));
+}
+exports.ARROW = ' ← ';
+function resolveCaller(cfg) {
+    const prev = Error.stackTraceLimit;
+    Error.stackTraceLimit = 60;
+    let frames;
+    try {
+        frames = parseStack(new Error().stack);
+    }
+    finally {
+        Error.stackTraceLimit = prev;
+    }
+    // caller: first surviving frame is the callee; next with a different display is the caller
+    let callee;
+    let caller;
+    for (const f of frames) {
+        if (filteredOut(f, cfg))
+            continue;
+        if (!callee) {
+            callee = f;
+            continue;
+        }
+        if (f.display === callee.display)
+            continue;
+        caller = f;
+        break;
+    }
+    const callerText = !callee ? '' : caller ? callee.display + exports.ARROW + caller.display : callee.display;
+    // chain: every project frame that survives filters, consecutive duplicates collapsed
+    const chain = [];
+    for (const f of frames) {
+        if (!isProjectFrame(f, cfg) || filteredOut(f, cfg))
+            continue;
+        if (chain[chain.length - 1] !== f.display)
+            chain.push(f.display);
+    }
+    return { caller: callerText, chain: chain.join(exports.ARROW) };
+}
+//# sourceMappingURL=caller.js.map

package/dist/caller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"caller.js","sourceRoot":"","sources":["../src/caller.ts"],"names":[],"mappings":"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"}

package/dist/config.d.ts

@@ -0,0 +1,152 @@
+import type { LevelName } from './theme';
+export type RootLevel = 'debug' | 'info' | 'warn' | 'error' | 'off';
+export type AttachPolicy = 'on-failure' | 'always' | 'never';
+export interface FileToggles {
+    /** Everything (all levels) plus caller suffix. */
+    debugTrace: boolean;
+    /** Console-visible lines only, no caller suffix. */
+    partialTrace: boolean;
+    /** Everything plus [CHAIN] suffix. */
+    fullTrace: boolean;
+    /** One structured JSON record per log call (QoL addition, off by default). */
+    jsonl: boolean;
+    /**
+     * For every rendered table, a CSV and a JSON copy at <logDir>/<date>/attachments/{csv,json}/<runId>-<worker>/
+     * <NNN>-<title>.{csv,json}: one folder per parent log. Full cell values (no tableCellLimit), redacted like the console.
+     */
+    tables: boolean;
+}
+export interface LogConfig {
+    /** Root threshold for console + partial-trace. Debug/full traces always capture everything. */
+    level: RootLevel;
+    /** ANSI output on/off. This is the theme toggle: on = HIGH_CONTRAST, off = plain text. Overrides fg and bg. */
+    ansi: boolean;
+    /** Intent-based foreground colors (plus the level foreground on BASE lines). Only matters when ansi is on. */
+    fg: boolean;
+    /** The theme background (one constant, BG_BLACK, for every level). Only matters when ansi is on. */
+    bg: boolean;
+    /**
+     * Max log files kept per trace kind (partial-trace, debug-trace, full-trace, jsonl); older ones are deleted by
+     * mtime. Files of the current run, and of any run written to in the last recentRunMinutes, are never deleted, so
+     * this is not a hard cap. null (or 0) keeps everything. Prefer maxRuns: a file count can keep part of a parallel run.
+     */
+    maxLogFiles: number | null;
+    /**
+     * Max runs kept per trace kind, the current run included. Older runs are deleted whole, oldest first. A run written
+     * to in the last recentRunMinutes is never deleted. null (or 0) keeps everything.
+     */
+    maxRuns: number | null;
+    /**
+     * Retention never deletes a run with a file modified this many minutes ago or less (another runner or CI shard may
+     * still be writing it). Default 60. 0 turns the guard off, so only the current run is protected.
+     */
+    recentRunMinutes: number;
+    /**
+     * Max chars for an INFO log (tables excluded). Longer ones print truncated with the total char count, followed by a
+     * WARN and a DEBUG line holding the full text. null (or 0) means no limit.
+     */
+    infoLogsCharLimit: number | null;
+    /** Console-only: prefix each line with the worker (w<N>, or main outside Playwright), as the trace files do. */
+    consoleWorker: boolean;
+    /** Console-only: prefix each line with the running test's title (set by the Playwright fixture), max 40 chars. */
+    consoleTest: boolean;
+    /** Console-only: color the caller suffix separately. Breaks one-ANSI-block-per-line. Independent of fg and bg. */
+    callerColor: boolean;
+    /** Java-style pattern (yyyy MM dd HH mm ss SSS) or a formatter function. */
+    tsFormat: string | ((d: Date) => string);
+    segmentDivider: string;
+    tableCellLimit: number;
+    tableCellLimitEnabled: boolean;
+    /** Frames whose class or file path contains any of these are dropped from caller/chain. */
+    suppressContains: Set<string>;
+    suppressMethodPrefixes: Set<string>;
+    /** When non-empty, only frames whose file path contains / class starts with one of these are kept. */
+    includeOnlyPrefixes: Set<string>;
+    /** Frames under these roots (and not in node_modules) form the [CHAIN]. */
+    projectRoots: string[];
+    console: boolean;
+    files: FileToggles;
+    logDir: string;
+    /** Emit ::error:: / ::warning:: workflow commands when running under GitHub Actions. */
+    githubAnnotations: boolean;
+    /** Mask values of these field keys (case-insensitive substring match) in tree/table/row output, at any depth. */
+    redactKeys: string[];
+    /**
+     * Also mask secrets written into message text: `key=value`, `key: value` and `"key":"value"` where the key contains
+     * one of redactKeys, plus `Bearer <token>` / `Basic <credentials>`. Applies to every sink.
+     */
+    redactText: boolean;
+    /** Playwright integration: when to attach the per-test log to the report. */
+    attach: AttachPolicy;
+}
+export declare const levelEnabled: (root: RootLevel, level: LevelName) => boolean;
+/** Explicit env wins, then NO_COLOR/FORCE_COLOR, then TTY/terminal hints, then CI renderers that show ANSI. */
+export declare function detectAnsiSupport(env?: NodeJS.ProcessEnv, isTTY?: boolean): boolean;
+/** Built lazily on first use, so the project config file is read once in every process (every Playwright worker included). */
+export declare const config: () => LogConfig;
+export type LogConfigPatch = Partial<Omit<LogConfig, 'files' | 'suppressContains' | 'suppressMethodPrefixes' | 'includeOnlyPrefixes'>> & {
+    files?: Partial<FileToggles>;
+    suppressContains?: Iterable<string>;
+    suppressMethodPrefixes?: Iterable<string>;
+    includeOnlyPrefixes?: Iterable<string>;
+};
+/**
+ * Merge a patch, or mutate in place with a callback. Set-typed fields accept arrays in a patch.
+ * Both forms are checked like a config file, but a problem never throws (a logger must not fail a test): an unknown
+ * option or a wrong-typed value prints one stderr warning and is skipped, and the rest still applies. For the
+ * callback, "skipped" means the bad option is put back to its value from before the call (an unknown one removed).
+ */
+export declare function configure(patch: LogConfigPatch | ((cfg: LogConfig) => void)): LogConfig;
+/** Print a warning to stderr once per process (reset by resetConfig()). Internal: used for misuse that must not throw. */
+export declare function warnOnce(msg: string): void;
+/** Tells the reader where to raise infoLogsCharLimit, based on which layer set the active value. */
+export declare function infoLimitHint(): string;
+/** Types a logger.config.* file. Returns its argument unchanged; the type is exactly LogConfigPatch. */
+export declare function defineConfig(patch: LogConfigPatch): LogConfigPatch;
+export declare function defineConfig(fn: (config: LogConfig) => LogConfigPatch): (config: LogConfig) => LogConfigPatch;
+/** Restore defaults and re-read env and the config file. Mainly for tests. */
+export declare function resetConfig(): LogConfig;
+export declare const enableAnsi: () => void;
+export declare const disableAnsi: () => void;
+export declare const isAnsiEnabled: () => boolean;
+export declare const enableFg: () => void;
+export declare const disableFg: () => void;
+export declare const isFgEnabled: () => boolean;
+export declare const enableBg: () => void;
+export declare const disableBg: () => void;
+export declare const isBgEnabled: () => boolean;
+export declare const enableCallerColor: () => void;
+export declare const disableCallerColor: () => void;
+export declare const isCallerColorEnabled: () => boolean;
+export declare const isDebugEnabled: () => boolean;
+export declare function includeOnlyPackages(...prefixes: string[]): void;
+export declare function suppressClassContains(...substrings: string[]): void;
+export declare function suppressMethodPrefix(...prefixes: string[]): void;
+export declare const clearIncludes: () => void;
+export declare const LINE_BREAKS: RegExp;
+export declare const LINE_BREAKS_NO_G: RegExp;
+export declare function truncateCell(s: unknown): string;
+/** Set a table cell limit (min 4) and enable it. */
+export declare function setTableCellLimit(limit: number): void;
+export declare const disableTableCellLimit: () => void;
+export declare function formatTs(cfg: LogConfig, d: Date): string;
+/**
+ * Set VOID_RUN_ID / VOID_RUN_DATE if absent so every Playwright worker (which inherits the runner's env)
+ * shares one run id. Call from globalSetup. Idempotent.
+ */
+export declare function initRun(): {
+    runId: string;
+    runDate: string;
+};
+export declare function getRun(): {
+    runId: string;
+    runDate: string;
+};
+/**
+ * True in a Playwright worker whose runner never called initRun(). Each such worker falls back to its own pid-based
+ * run id, so its files are split from its siblings' and retention would see their live files as an older run.
+ */
+export declare function runIdMissing(env?: NodeJS.ProcessEnv): boolean;
+/** Worker label for the thread column: w<TEST_WORKER_INDEX> under Playwright, else "main". */
+export declare function workerLabel(env?: NodeJS.ProcessEnv): string;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}