@meadown/logger 1.8.11 → 1.9.0

package/dist/domain/write/writeLog.js

@@ -0,0 +1,21 @@
+/*
+ * writeLog.ts
+ * Created by Dewan Mobashirul
+ * Copyright (c) 2026 meadown
+ * All rights reserved
+ */
+import { renderMessage, buildContext, TAG_COLOR } from "./helpers/index.js";
+/**
+ * Renders and writes one log entry. The `caller` is resolved by the *caller* of
+ * this function (the log closure or `tap`) and passed in, so this helper never
+ * touches the stack — keeping {@link getCaller}'s frame depth correct no matter
+ * which user-facing function delegates here.
+ */
+export function writeLog(opts) {
+    const { channel, tag, args, caller } = opts;
+    const { useColor, paint, timeStamp, locOut, connector, connectorEnd, separator, } = buildContext(channel, caller);
+    const tagOut = paint(tag, TAG_COLOR[channel]);
+    const message = renderMessage(args, useColor);
+    const meta = `\n${connectorEnd} ${timeStamp} ${separator} ${locOut}`;
+    console[channel](`\n${tagOut} \n${connector} ${message}${meta}`);
+}

package/dist/features/logger/index.d.ts

@@ -0,0 +1 @@
+export default function log(...args: unknown[]): void;

package/dist/features/logger/index.js

@@ -0,0 +1,15 @@
+/*
+ * index.ts
+ * Created by Dewan Mobashirul
+ * Copyright (c) 2026 meadown
+ * All rights reserved
+ */
+import { isLogAllowed } from "../../config/index.js";
+import getCaller from "../../domain/caller/getCaller.js";
+import { writeLog } from "../../domain/write/writeLog.js";
+export default function log(...args) {
+    if (!isLogAllowed())
+        return;
+    const caller = getCaller();
+    writeLog({ channel: "log", tag: "[INFO]", args, caller });
+}

package/dist/features/logger-error/index.d.ts

@@ -0,0 +1 @@
+export default function logError(...args: unknown[]): void;

package/dist/features/logger-error/index.js

@@ -0,0 +1,15 @@
+/*
+ * index.ts
+ * Created by Dewan Mobashirul
+ * Copyright (c) 2026 meadown
+ * All rights reserved
+ */
+import { isLogAllowed } from "../../config/index.js";
+import getCaller from "../../domain/caller/getCaller.js";
+import { writeLog } from "../../domain/write/writeLog.js";
+export default function logError(...args) {
+    if (!isLogAllowed())
+        return;
+    const caller = getCaller();
+    writeLog({ channel: "error", tag: "[ERROR]", args, caller });
+}

package/dist/features/logger-group/createGroup.d.ts

@@ -0,0 +1,11 @@
+import { type LogChannel } from "../../types/index.js";
+export interface GroupOptions {
+    name: string;
+    type?: LogChannel;
+    logs: unknown[];
+}
+/** Type of `logger.group` — use this to annotate variables or parameters that accept it. */
+export interface Group {
+    (opts: GroupOptions): void;
+}
+export default function group({ name, type, logs, }: GroupOptions): void;

package/dist/features/logger-group/createGroup.js

@@ -0,0 +1,15 @@
+/*
+ * createGroup.ts
+ * Created by Dewan Mobashirul
+ * Copyright (c) 2026 meadown
+ * All rights reserved
+ */
+import { isLogAllowed } from "../../config/index.js";
+import getCaller from "../../domain/caller/getCaller.js";
+import { writeGroup } from "./writeGroup.js";
+export default function group({ name, type = "log", logs, }) {
+    if (!isLogAllowed())
+        return;
+    const caller = getCaller();
+    writeGroup({ name, channel: type, logs, caller });
+}

package/dist/features/logger-group/index.d.ts

@@ -0,0 +1 @@
+export { default, type Group, type GroupOptions } from "./createGroup.js";

package/dist/features/logger-group/index.js

@@ -0,0 +1,7 @@
+/*
+ * index.ts
+ * Created by Dewan Mobashirul
+ * Copyright (c) 2026 meadown
+ * All rights reserved
+ */
+export { default } from "./createGroup.js";

package/dist/features/logger-group/writeGroup.d.ts

@@ -0,0 +1,8 @@
+import { type LogChannel } from "../../types/index.js";
+import { type Caller } from "../../domain/caller/getCaller.js";
+export declare function writeGroup(opts: {
+    name: string;
+    channel: LogChannel;
+    logs: unknown[];
+    caller: Caller;
+}): void;

package/dist/features/logger-group/writeGroup.js

@@ -0,0 +1,17 @@
+/*
+ * writeGroup.ts
+ * Created by Dewan Mobashirul
+ * Copyright (c) 2026 meadown
+ * All rights reserved
+ */
+import { renderMessage, buildContext, TAG_COLOR, } from "../../domain/write/helpers/index.js";
+export function writeGroup(opts) {
+    const { name, channel, logs, caller } = opts;
+    const { useColor, paint, timeStamp, locOut, connector, connectorEnd, separator, } = buildContext(channel, caller);
+    const tagOut = paint(`[${name.toUpperCase()}]`, TAG_COLOR[channel]);
+    const itemLines = logs
+        .map((item) => `\n${connector} ${renderMessage([item], useColor)}`)
+        .join("");
+    const meta = `\n${connectorEnd} ${timeStamp} ${separator} ${locOut}`;
+    console[channel](`\n${tagOut} ${itemLines}${meta}`);
+}

package/dist/features/logger-max-lines/index.d.ts

@@ -0,0 +1 @@
+export { getVisibleLines, setVisibleLines } from "../../domain/write/index.js";

package/dist/features/logger-max-lines/index.js

@@ -0,0 +1,7 @@
+/*
+ * index.ts
+ * Created by Dewan Mobashirul
+ * Copyright (c) 2026 meadown
+ * All rights reserved
+ */
+export { getVisibleLines, setVisibleLines } from "../../domain/write/index.js";

package/dist/features/logger-tap/createTap.d.ts

@@ -0,0 +1,5 @@
+/** Type of `logger.tap` — use this to annotate variables or parameters that accept it. */
+export interface Tap {
+    <T>(value: T, label?: string): T;
+}
+export default function tap<T>(value: T, label?: string): T;

package/dist/features/logger-tap/createTap.js

@@ -0,0 +1,27 @@
+/*
+ * createTap.ts
+ * Created by Dewan Mobashirul
+ * Copyright (c) 2026 meadown
+ * All rights reserved
+ */
+import { isLogAllowed } from "../../config/index.js";
+import getCaller from "../../domain/caller/getCaller.js";
+import { writeLog } from "../../domain/write/writeLog.js";
+import { isThenable, tapAsync } from "./tapAsync/index.js";
+export default function tap(value, label) {
+    if (!isLogAllowed())
+        return value;
+    const caller = getCaller();
+    if (isThenable(value)) {
+        tapAsync(value, label, caller);
+    }
+    else {
+        writeLog({
+            channel: "log",
+            tag: "[TAP]",
+            args: label === undefined ? [value] : [label, value],
+            caller,
+        });
+    }
+    return value;
+}

package/dist/features/logger-tap/index.d.ts

@@ -0,0 +1 @@
+export { default, type Tap } from "./createTap.js";

package/dist/features/logger-tap/index.js

@@ -0,0 +1,7 @@
+/*
+ * index.ts
+ * Created by Dewan Mobashirul
+ * Copyright (c) 2026 meadown
+ * All rights reserved
+ */
+export { default } from "./createTap.js";

package/dist/{tap → features/logger-tap}/tapAsync/helpers/buildBlock.js

@@ -1,12 +1,12 @@
 /*
  * buildBlock.ts
  * Created by Dewan Mobashirul
- * Copyright (c) 2026 dewan-meadown
+ * Copyright (c) 2026 meadown
  * All rights reserved
  */
 import { formatWithOptions } from "node:util";
 import { formatDuration } from "./format.js";
-import { colorize } from "../../../colors/color.js";
+import { colorize } from "../../../../domain/colors/color.js";
 import { formatStatus } from "./response.js";
 /**
  * Renders the nested tree block:

package/dist/{tap → features/logger-tap}/tapAsync/helpers/format.js

@@ -1,10 +1,10 @@
 /*
  * format.ts
  * Created by Dewan Mobashirul
- * Copyright (c) 2026 dewan-meadown
+ * Copyright (c) 2026 meadown
  * All rights reserved
  */
-import { colorize } from "../../../colors/color.js";
+import { colorize } from "../../../../domain/colors/color.js";
 /** `65ms` (green) · `1.2s` (yellow) · `5.8s` (red). */
 export function formatDuration(ms, useColor) {
     const text = ms >= 1000 ? `${(ms / 1000).toFixed(2)}s` : `${ms}ms`;

package/dist/{tap → features/logger-tap}/tapAsync/helpers/index.js

@@ -1,7 +1,7 @@
 /*
  * index.ts
  * Created by Dewan Mobashirul
- * Copyright (c) 2026 dewan-meadown
+ * Copyright (c) 2026 meadown
  * All rights reserved
  */
 export { readBody, isResponse, formatStatus, } from "./response.js";

package/dist/{tap → features/logger-tap}/tapAsync/helpers/isThenable.js

@@ -1,7 +1,7 @@
 /*
  * isThenable.ts
  * Created by Dewan Mobashirul
- * Copyright (c) 2026 dewan-meadown
+ * Copyright (c) 2026 meadown
  * All rights reserved
  */
 /** Whether `value` is thenable (a promise we can await + time). */

package/dist/{tap → features/logger-tap}/tapAsync/helpers/response.js

@@ -1,11 +1,11 @@
 /*
  * response.ts
  * Created by Dewan Mobashirul
- * Copyright (c) 2026 dewan-meadown
+ * Copyright (c) 2026 meadown
  * All rights reserved
  */
 import { formatBytes } from "./format.js";
-import { colorize } from "../../../colors/color.js";
+import { colorize } from "../../../../domain/colors/color.js";
 /** Whether the resolved value is a fetch `Response` we can read. */
 export function isResponse(value) {
     const v = value;

package/dist/{tap → features/logger-tap}/tapAsync/index.js

@@ -1,7 +1,7 @@
 /*
  * index.ts
  * Created by Dewan Mobashirul
- * Copyright (c) 2026 dewan-meadown
+ * Copyright (c) 2026 meadown
  * All rights reserved
  */
 export { tapAsync } from "./tapAsync.js";

package/dist/{tap → features/logger-tap}/tapAsync/tapAsync.d.ts

@@ -1,4 +1,4 @@
-import { type Caller } from "../../caller/getCaller.js";
+import { type Caller } from "../../../domain/caller/getCaller.js";
 /**
  * The async tap. Fire-and-forget: returns `promise` immediately (unchanged),
  * and logs a rich block once it resolves. For a `Response`, reads the body from

package/dist/{tap → features/logger-tap}/tapAsync/tapAsync.js

@@ -1,13 +1,14 @@
 /*
  * tapAsync.ts
  * Created by Dewan Mobashirul
- * Copyright (c) 2026 dewan-meadown
+ * Copyright (c) 2026 meadown
  * All rights reserved
  */
 import { performance } from "node:perf_hooks";
 import { formatDuration, formatBytes, isResponse, readBody, buildBlock, } from "./helpers/index.js";
-import { isTTY } from "../../terminal/isTTY.js";
-import { writeLog } from "../../core/writeLog/index.js";
+import { isTTY } from "../../../domain/terminal/isTTY.js";
+import { writeLog } from "../../../domain/write/index.js";
+import { isLogAllowed } from "../../../config/index.js";
 /**
  * The async tap. Fire-and-forget: returns `promise` immediately (unchanged),
  * and logs a rich block once it resolves. For a `Response`, reads the body from
@@ -16,6 +17,8 @@ import { writeLog } from "../../core/writeLog/index.js";
  * the logged location points at the user's file.
  */
 export function tapAsync(promise, label, caller) {
+    if (!isLogAllowed())
+        return;
     const useColor = isTTY("stdout");
     const start = performance.now();
     void promise.then((resolved) => {

package/dist/features/logger-warn/index.d.ts

@@ -0,0 +1 @@
+export default function logWarn(...args: unknown[]): void;

package/dist/features/logger-warn/index.js

@@ -0,0 +1,15 @@
+/*
+ * index.ts
+ * Created by Dewan Mobashirul
+ * Copyright (c) 2026 meadown
+ * All rights reserved
+ */
+import { isLogAllowed } from "../../config/index.js";
+import getCaller from "../../domain/caller/getCaller.js";
+import { writeLog } from "../../domain/write/writeLog.js";
+export default function logWarn(...args) {
+    if (!isLogAllowed())
+        return;
+    const caller = getCaller();
+    writeLog({ channel: "warn", tag: "[WARN]", args, caller });
+}

package/dist/index.d.ts

@@ -1,3 +1,5 @@
+import { type Tap } from "./features/logger-tap/index.js";
+import { type Group } from "./features/logger-group/index.js";
 /** Type of the logger — use this to annotate variables or parameters that accept it. */
 export interface Logger {
     /** Log at info level — `stdout`, cyan `[INFO]` tag. */
@@ -26,7 +28,21 @@ export interface Logger {
      * @param value  Any value or promise — always returned as-is.
      * @param label  Optional label shown next to the value in the log line.
      */
-    tap<T>(value: T, label?: string): T;
+    tap: Tap;
+    /**
+     * Log multiple related items as one block under a shared name and single
+     * timestamp. Each item in `logs` renders on its own `├──` branch — any value
+     * is accepted (string, object, function, Promise, …).
+     *
+     * `type` sets the channel and tag color: `"info"` (default), `"warn"`, `"error"`.
+     *
+     * @example
+     * ```ts
+     * logger.group({ name: "Server setup", logs: [`port: ${port}`, `env: ${env}`] })
+     * logger.group({ name: "Validation failed", type: "error", logs: ["email invalid"] })
+     * ```
+     */
+    group: Group;
     /**
      * How many lines to show before the rest collapses into a
      * `… N more lines` summary. `0` (default) shows everything.

package/dist/index.js

@@ -1,12 +1,15 @@
 /*
  * index.ts
  * Created by Dewan Mobashirul
- * Copyright (c) 2026 dewan-meadown
+ * Copyright (c) 2026 meadown
  * All rights reserved
  */
-import createLog from "./core/createLog.js";
-import createTap from "./tap/createTap.js";
-import { getVisibleLines, setVisibleLines } from "./core/writeLog/index.js";
+import { getVisibleLines, setVisibleLines, } from "./features/logger-max-lines/index.js";
+import logInfo from "./features/logger/index.js";
+import logWarn from "./features/logger-warn/index.js";
+import logError from "./features/logger-error/index.js";
+import tap from "./features/logger-tap/index.js";
+import group from "./features/logger-group/index.js";
 /**
  * A logger built for development — colored tags, a local timestamp, and a
  * clickable `(file:line)` link on every line so you always know where a
@@ -27,10 +30,11 @@ import { getVisibleLines, setVisibleLines } from "./core/writeLog/index.js";
  * const res  = await logger.tap(fetch(url), "GET /users")
  * ```
  */
-const logger = Object.assign(createLog("log", "[INFO]"), {
-    error: createLog("error", "[ERROR]"),
-    warn: createLog("warn", "[WARN]"),
-    tap: createTap(),
+const logger = Object.assign(logInfo, {
+    error: logError,
+    warn: logWarn,
+    tap,
+    group,
 });
 // `maxLines` is a live getter/setter backed by the shared collapse setting, so
 // setting it once affects info, error, and warn alike.

package/dist/types/index.d.ts

@@ -0,0 +1,2 @@
+/** The console channels the logger writes to. */
+export type LogChannel = "log" | "error" | "warn";

package/dist/types/index.js

@@ -0,0 +1,7 @@
+/*
+ * index.ts
+ * Created by Dewan Mobashirul
+ * Copyright (c) 2026 meadown
+ * All rights reserved
+ */
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meadown/logger",
-  "version": "1.8.11",
+  "version": "1.9.0",
   "description": "A development-focused logger for Node.js and TypeScript — zero dependencies, clickable source links, and API response logging built in.",
   "keywords": [
     "logger",

package/dist/cjs/core/createLog.d.ts

@@ -1,8 +0,0 @@
-import { type LogChannel } from "../constants.js";
-/**
- * Builds a log function bound to a console channel and tag. The returned closure
- * is what the caller invokes directly, so {@link getCaller} resolves the caller's
- * own frame; the resolved caller is then handed to {@link writeLog}, which never
- * touches the stack. Logs only outside production — see {@link isLogAllowed}.
- */
-export default function createLog(channel: LogChannel, tag: string): (...args: unknown[]) => void;

package/dist/cjs/core/createLog.js

@@ -1,29 +0,0 @@
-"use strict";
-/*
- * createLog.ts
- * Created by Dewan Mobashirul
- * Copyright (c) 2026 dewan-meadown
- * All rights reserved
- */
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = createLog;
-const getCaller_js_1 = __importDefault(require("../caller/getCaller.js"));
-const index_js_1 = require("./writeLog/index.js");
-const config_js_1 = require("../config.js");
-/**
- * Builds a log function bound to a console channel and tag. The returned closure
- * is what the caller invokes directly, so {@link getCaller} resolves the caller's
- * own frame; the resolved caller is then handed to {@link writeLog}, which never
- * touches the stack. Logs only outside production — see {@link isLogAllowed}.
- */
-function createLog(channel, tag) {
-    return (...args) => {
-        if (!(0, config_js_1.isLogAllowed)())
-            return;
-        const caller = (0, getCaller_js_1.default)();
-        (0, index_js_1.writeLog)({ channel, tag, args, caller });
-    };
-}

package/dist/cjs/core/writeLog/writeLog.js

@@ -1,43 +0,0 @@
-"use strict";
-/*
- * writeLog.ts
- * Created by Dewan Mobashirul
- * Copyright (c) 2026 dewan-meadown
- * All rights reserved
- */
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.writeLog = writeLog;
-const constants_js_1 = require("../../constants.js");
-const isTTY_js_1 = require("../../terminal/isTTY.js");
-const getTimeStamp_js_1 = __importDefault(require("../../time/getTimeStamp.js"));
-const color_js_1 = require("../../colors/color.js");
-const index_js_1 = require("./helpers/index.js");
-/**
- * Renders and writes one log entry. The `caller` is resolved by the *caller* of
- * this function (the log closure or `tap`) and passed in, so this helper never
- * touches the stack — keeping {@link getCaller}'s frame depth correct no matter
- * which user-facing function delegates here.
- */
-function writeLog(opts) {
-    const { channel, tag, args, caller } = opts;
-    const streamName = channel === "log" ? "stdout" : "stderr";
-    // One terminal check drives both color and clickable links — `isTTY` is the
-    // single source of truth (DRY). Off when output is piped/redirected.
-    const useColor = (0, isTTY_js_1.isTTY)(streamName);
-    const paint = (s, c) => (useColor ? (0, color_js_1.colorize)(s, c) : s);
-    const location = (0, index_js_1.formatLocation)(caller, useColor);
-    const tagOut = paint(tag, constants_js_1.TAG_COLOR[channel]);
-    const timeStamp = paint((0, getTimeStamp_js_1.default)(), "teal");
-    const locOut = paint(`(${location})`, "dimTeal");
-    const connector = paint(constants_js_1.BRANCH, "gray");
-    const connectorBottom = paint(constants_js_1.BRANCH_END, "gray");
-    const separator = paint(constants_js_1.SEPARATOR, "gray");
-    // Layout: the tag, the message hanging off a `├──` branch, then the timestamp
-    // and location on a `└──` branch below. Leading `\n` spaces entries apart.
-    const message = (0, index_js_1.renderMessage)(args, useColor);
-    const meta = `\n${connectorBottom} ${timeStamp} ${separator} ${locOut}`;
-    console[channel](`\n${tagOut}`, `\n${connector}`, message, meta);
-}

package/dist/cjs/tap/createTap.d.ts

@@ -1,18 +0,0 @@
-/** Logs a value and returns it unchanged. Promises route to the timed path. */
-export interface Tap {
-    <T>(value: T, label?: string): T;
-}
-/**
- * Builds `tap` — logs a value and returns it **unchanged**, so it drops into any
- * expression (`const u = logger.tap(getUser(), "user")`). The consumer always
- * gets back exactly what they passed; the only effect is a clean log.
- *
- * - A plain value is logged synchronously and returned.
- * - A **promise** is returned as-is (same object, never awaited or wrapped), and
- *   its elapsed time — plus the HTTP status if it resolves to a `Response` — is
- *   logged in the background (fire-and-forget, non-blocking).
- *
- * The returned closure is what the caller invokes directly, so {@link getCaller}
- * resolves the caller's own frame. Silent in production; the value still flows.
- */
-export default function createTap(): Tap;

package/dist/cjs/tap/createTap.js

@@ -1,51 +0,0 @@
-"use strict";
-/*
- * createTap.ts
- * Created by Dewan Mobashirul
- * Copyright (c) 2026 dewan-meadown
- * All rights reserved
- */
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = createTap;
-const config_js_1 = require("../config.js");
-const getCaller_js_1 = __importDefault(require("../caller/getCaller.js"));
-const index_js_1 = require("../core/writeLog/index.js");
-const index_js_2 = require("./tapAsync/index.js");
-/**
- * Builds `tap` — logs a value and returns it **unchanged**, so it drops into any
- * expression (`const u = logger.tap(getUser(), "user")`). The consumer always
- * gets back exactly what they passed; the only effect is a clean log.
- *
- * - A plain value is logged synchronously and returned.
- * - A **promise** is returned as-is (same object, never awaited or wrapped), and
- *   its elapsed time — plus the HTTP status if it resolves to a `Response` — is
- *   logged in the background (fire-and-forget, non-blocking).
- *
- * The returned closure is what the caller invokes directly, so {@link getCaller}
- * resolves the caller's own frame. Silent in production; the value still flows.
- */
-function createTap() {
-    const tap = (value, label) => {
-        if (!(0, config_js_1.isLogAllowed)())
-            return value;
-        const caller = (0, getCaller_js_1.default)();
-        if ((0, index_js_2.isThenable)(value)) {
-            // value is a promise → hand off to the async tap (caller passed in so the
-            // location stays on the user's file, not on this helper).
-            (0, index_js_2.tapAsync)(value, label, caller);
-        }
-        else {
-            (0, index_js_1.writeLog)({
-                channel: "log",
-                tag: "[TAP]",
-                args: label === undefined ? [value] : [label, value],
-                caller,
-            });
-        }
-        return value;
-    };
-    return tap;
-}

package/dist/core/createLog.d.ts

@@ -1,8 +0,0 @@
-import { type LogChannel } from "../constants.js";
-/**
- * Builds a log function bound to a console channel and tag. The returned closure
- * is what the caller invokes directly, so {@link getCaller} resolves the caller's
- * own frame; the resolved caller is then handed to {@link writeLog}, which never
- * touches the stack. Logs only outside production — see {@link isLogAllowed}.
- */
-export default function createLog(channel: LogChannel, tag: string): (...args: unknown[]) => void;

package/dist/core/createLog.js

@@ -1,23 +0,0 @@
-/*
- * createLog.ts
- * Created by Dewan Mobashirul
- * Copyright (c) 2026 dewan-meadown
- * All rights reserved
- */
-import getCaller from "../caller/getCaller.js";
-import { writeLog } from "./writeLog/index.js";
-import { isLogAllowed } from "../config.js";
-/**
- * Builds a log function bound to a console channel and tag. The returned closure
- * is what the caller invokes directly, so {@link getCaller} resolves the caller's
- * own frame; the resolved caller is then handed to {@link writeLog}, which never
- * touches the stack. Logs only outside production — see {@link isLogAllowed}.
- */
-export default function createLog(channel, tag) {
-    return (...args) => {
-        if (!isLogAllowed())
-            return;
-        const caller = getCaller();
-        writeLog({ channel, tag, args, caller });
-    };
-}

package/dist/core/writeLog/writeLog.js

@@ -1,37 +0,0 @@
-/*
- * writeLog.ts
- * Created by Dewan Mobashirul
- * Copyright (c) 2026 dewan-meadown
- * All rights reserved
- */
-import { TAG_COLOR, BRANCH, BRANCH_END, SEPARATOR, } from "../../constants.js";
-import { isTTY } from "../../terminal/isTTY.js";
-import getTimeStamp from "../../time/getTimeStamp.js";
-import { colorize } from "../../colors/color.js";
-import { renderMessage, formatLocation } from "./helpers/index.js";
-/**
- * Renders and writes one log entry. The `caller` is resolved by the *caller* of
- * this function (the log closure or `tap`) and passed in, so this helper never
- * touches the stack — keeping {@link getCaller}'s frame depth correct no matter
- * which user-facing function delegates here.
- */
-export function writeLog(opts) {
-    const { channel, tag, args, caller } = opts;
-    const streamName = channel === "log" ? "stdout" : "stderr";
-    // One terminal check drives both color and clickable links — `isTTY` is the
-    // single source of truth (DRY). Off when output is piped/redirected.
-    const useColor = isTTY(streamName);
-    const paint = (s, c) => (useColor ? colorize(s, c) : s);
-    const location = formatLocation(caller, useColor);
-    const tagOut = paint(tag, TAG_COLOR[channel]);
-    const timeStamp = paint(getTimeStamp(), "teal");
-    const locOut = paint(`(${location})`, "dimTeal");
-    const connector = paint(BRANCH, "gray");
-    const connectorBottom = paint(BRANCH_END, "gray");
-    const separator = paint(SEPARATOR, "gray");
-    // Layout: the tag, the message hanging off a `├──` branch, then the timestamp
-    // and location on a `└──` branch below. Leading `\n` spaces entries apart.
-    const message = renderMessage(args, useColor);
-    const meta = `\n${connectorBottom} ${timeStamp} ${separator} ${locOut}`;
-    console[channel](`\n${tagOut}`, `\n${connector}`, message, meta);
-}