@meadown/logger 1.8.9 → 1.8.10

package/dist/cjs/core/createLog.js

@@ -11,7 +11,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.default = createLog;
 const getCaller_js_1 = __importDefault(require("../caller/getCaller.js"));
-const writeLog_js_1 = require("./writeLog.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
@@ -24,6 +24,6 @@ function createLog(channel, tag) {
         if (!(0, config_js_1.isLogAllowed)())
             return;
         const caller = (0, getCaller_js_1.default)();
-        (0, writeLog_js_1.writeLog)({ channel, tag, args, caller });
+        (0, index_js_1.writeLog)({ channel, tag, args, caller });
     };
 }

package/dist/cjs/core/writeLog/formatLocation.d.ts

@@ -0,0 +1,6 @@
+import { type Caller } from "../../caller/getCaller.js";
+/**
+ * Renders a caller as a `(file:line)` location — a clickable OSC-8 link on a
+ * supporting terminal, plain text otherwise. Pure (no stack access).
+ */
+export declare function formatLocation(caller: Caller, interactive: boolean): string;

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

@@ -0,0 +1,19 @@
+"use strict";
+/*
+ * formatLocation.ts
+ * Created by Dewan Mobashirul
+ * Copyright (c) 2026 dewan-meadown
+ * All rights reserved
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatLocation = formatLocation;
+const link_js_1 = require("../../decorations/link.js");
+/**
+ * Renders a caller as a `(file:line)` location — a clickable OSC-8 link on a
+ * supporting terminal, plain text otherwise. Pure (no stack access).
+ */
+function formatLocation(caller, interactive) {
+    if (caller.file !== null && caller.line !== null && interactive)
+        return (0, link_js_1.hyperlink)(caller.label, (0, link_js_1.fileUrl)(caller.file));
+    return caller.label;
+}

package/dist/cjs/core/{writeLog.d.ts → writeLog/index.d.ts}

@@ -1,9 +1,6 @@
-import { type LogChannel } from "../constants.js";
-import { type Caller } from "../caller/getCaller.js";
-/** How many lines a long message shows before collapsing (0 = all). */
-export declare function getVisibleLines(): number;
-/** Set how many lines a long message shows before collapsing (0 = all). */
-export declare function setVisibleLines(value: number): void;
+import { type LogChannel } from "../../constants.js";
+import { type Caller } from "../../caller/getCaller.js";
+export { getVisibleLines, setVisibleLines } from "./visibleLines.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

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

@@ -0,0 +1,48 @@
+"use strict";
+/*
+ * index.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.setVisibleLines = exports.getVisibleLines = void 0;
+exports.writeLog = writeLog;
+const constants_js_1 = require("../../constants.js");
+const getTimeStamp_js_1 = __importDefault(require("../../time/getTimeStamp.js"));
+const color_js_1 = require("../../colors/color.js");
+const isTTY_js_1 = require("../../terminal/isTTY.js");
+const renderMessage_js_1 = require("./renderMessage.js");
+const formatLocation_js_1 = require("./formatLocation.js");
+var visibleLines_js_1 = require("./visibleLines.js");
+Object.defineProperty(exports, "getVisibleLines", { enumerable: true, get: function () { return visibleLines_js_1.getVisibleLines; } });
+Object.defineProperty(exports, "setVisibleLines", { enumerable: true, get: function () { return visibleLines_js_1.setVisibleLines; } });
+/**
+ * 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, formatLocation_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, renderMessage_js_1.renderMessage)(args, useColor);
+    const meta = `\n${connectorBottom} ${timeStamp} ${separator} ${locOut}`;
+    console[channel](`\n${tagOut}`, `\n${connector}`, message, meta);
+}

package/dist/cjs/core/writeLog/renderMessage.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Renders the args into a single message string exactly as console would —
+ * objects/errors via util.inspect, `%s`/`%d` format specifiers, and colors when
+ * on a terminal — then hang-indents every continuation line so multi-line
+ * output stays left-aligned under the branch, and collapses very long output.
+ */
+export declare function renderMessage(args: unknown[], useColor: boolean): string;

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

@@ -0,0 +1,40 @@
+"use strict";
+/*
+ * renderMessage.ts
+ * Created by Dewan Mobashirul
+ * Copyright (c) 2026 dewan-meadown
+ * All rights reserved
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderMessage = renderMessage;
+const node_util_1 = require("node:util");
+const constants_js_1 = require("../../constants.js");
+const color_js_1 = require("../../colors/color.js");
+const visibleLines_js_1 = require("./visibleLines.js");
+/**
+ * Collapses a long multi-line message to {@link visibleLines} lines, replacing
+ * the rest with a dimmed `… N more lines` summary. When `visibleLines` is 0
+ * (the default) nothing is collapsed — the full message is shown.
+ */
+function collapse(text, useColor) {
+    if (visibleLines_js_1.visibleLines < 1)
+        return text;
+    const lines = text.split("\n");
+    if (lines.length <= visibleLines_js_1.visibleLines)
+        return text;
+    const hidden = lines.length - visibleLines_js_1.visibleLines;
+    const summary = `${constants_js_1.MESSAGE_INDENT}... ${hidden} more line${hidden === 1 ? "" : "s"}`;
+    const visible = lines.slice(0, visibleLines_js_1.visibleLines);
+    visible.push(useColor ? (0, color_js_1.colorize)(summary, "gray") : summary);
+    return visible.join("\n");
+}
+/**
+ * Renders the args into a single message string exactly as console would —
+ * objects/errors via util.inspect, `%s`/`%d` format specifiers, and colors when
+ * on a terminal — then hang-indents every continuation line so multi-line
+ * output stays left-aligned under the branch, and collapses very long output.
+ */
+function renderMessage(args, useColor) {
+    const text = (0, node_util_1.formatWithOptions)({ colors: useColor }, ...args);
+    return collapse(text.replace(/\n/g, `\n${(0, color_js_1.colorize)(constants_js_1.MESSAGE_INDENT, "gray")}`), useColor);
+}

package/dist/cjs/core/writeLog/visibleLines.d.ts

@@ -0,0 +1,6 @@
+/** Max message lines to show before collapsing the rest; 0 (default) shows all. */
+export declare let visibleLines: number;
+/** How many lines a long message shows before collapsing (0 = all). */
+export declare function getVisibleLines(): number;
+/** Set how many lines a long message shows before collapsing (0 = all). */
+export declare function setVisibleLines(value: number): void;

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

@@ -0,0 +1,22 @@
+"use strict";
+/*
+ * visibleLines.ts
+ * Created by Dewan Mobashirul
+ * Copyright (c) 2026 dewan-meadown
+ * All rights reserved
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.visibleLines = void 0;
+exports.getVisibleLines = getVisibleLines;
+exports.setVisibleLines = setVisibleLines;
+const constants_js_1 = require("../../constants.js");
+/** Max message lines to show before collapsing the rest; 0 (default) shows all. */
+exports.visibleLines = constants_js_1.DEFAULT_MAX_LINES;
+/** How many lines a long message shows before collapsing (0 = all). */
+function getVisibleLines() {
+    return exports.visibleLines;
+}
+/** Set how many lines a long message shows before collapsing (0 = all). */
+function setVisibleLines(value) {
+    exports.visibleLines = Number.isFinite(value) && value > 0 ? Math.floor(value) : 0;
+}

package/dist/cjs/decorations/link.d.ts

@@ -1,9 +1,5 @@
-/**
- * Builds a `file://` URL for a path so terminals can open it on click.
- * When `line` is provided, appends `:line` so supporting terminals (VS Code,
- * iTerm2, WezTerm) jump straight to that line.
- */
-export declare function fileUrl(file: string, line?: number): string;
+/** Builds a `file://` URL for a path so terminals can open it on click. */
+export declare function fileUrl(file: string): string;
 /**
  * Wraps `text` in an OSC-8 terminal hyperlink pointing at `url`. Terminals that
  * support OSC-8 render `text` as a clickable link; others ignore the escape and

package/dist/cjs/decorations/link.js

@@ -9,14 +9,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.fileUrl = fileUrl;
 exports.hyperlink = hyperlink;
 const node_url_1 = require("node:url");
-/**
- * Builds a `file://` URL for a path so terminals can open it on click.
- * When `line` is provided, appends `:line` so supporting terminals (VS Code,
- * iTerm2, WezTerm) jump straight to that line.
- */
-function fileUrl(file, line) {
-    const base = file.startsWith("file://") ? file : (0, node_url_1.pathToFileURL)(file).href;
-    return line != null ? `${base}:${line}` : base;
+/** Builds a `file://` URL for a path so terminals can open it on click. */
+function fileUrl(file) {
+    return file.startsWith("file://") ? file : (0, node_url_1.pathToFileURL)(file).href;
 }
 /**
  * Wraps `text` in an OSC-8 terminal hyperlink pointing at `url`. Terminals that

package/dist/cjs/index.js

@@ -12,7 +12,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.logger = void 0;
 const createLog_js_1 = __importDefault(require("./core/createLog.js"));
 const createTap_js_1 = __importDefault(require("./tap/createTap.js"));
-const writeLog_js_1 = require("./core/writeLog.js");
+const index_js_1 = require("./core/writeLog/index.js");
 /**
  * Logs to the console, but only outside production. Each line is prefixed with
  * a level tag, a short local timestamp, and a clickable link to the file it was
@@ -32,8 +32,8 @@ exports.logger = logger;
 // `maxLines` is a live getter/setter backed by the shared collapse setting, so
 // setting it once affects info, error, and warn alike.
 Object.defineProperty(logger, "maxLines", {
-    get: writeLog_js_1.getVisibleLines,
-    set: writeLog_js_1.setVisibleLines,
+    get: index_js_1.getVisibleLines,
+    set: index_js_1.setVisibleLines,
     enumerable: true,
     configurable: true,
 });

package/dist/cjs/tap/createTap.js

@@ -11,7 +11,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.default = createTap;
 const getCaller_js_1 = __importDefault(require("../caller/getCaller.js"));
-const writeLog_js_1 = require("../core/writeLog.js");
+const index_js_1 = require("../core/writeLog/index.js");
 const config_js_1 = require("../config.js");
 const tapAsync_js_1 = require("./tapAsync.js");
 /**
@@ -38,7 +38,7 @@ function createTap() {
             (0, tapAsync_js_1.tapAsync)(value, label, caller);
         }
         else {
-            (0, writeLog_js_1.writeLog)({
+            (0, index_js_1.writeLog)({
                 channel: "log",
                 tag: "[TAP]",
                 args: label === undefined ? [value] : [label, value],

package/dist/cjs/tap/tapAsync.js

@@ -14,7 +14,7 @@ exports.isThenable = isThenable;
 exports.tapAsync = tapAsync;
 const node_perf_hooks_1 = require("node:perf_hooks");
 const node_util_1 = require("node:util");
-const writeLog_js_1 = require("../core/writeLog.js");
+const index_js_1 = require("../core/writeLog/index.js");
 const color_js_1 = require("../colors/color.js");
 const isTTY_js_1 = require("../terminal/isTTY.js");
 /** Whether `value` is thenable (a promise we can await + time). */
@@ -151,7 +151,7 @@ function tapAsync(promise, label, caller) {
                 clone = null;
             }
             if (clone === null) {
-                (0, writeLog_js_1.writeLog)({
+                (0, index_js_1.writeLog)({
                     channel: "log", tag: "[TAP]",
                     args: buildBlock(label, ms, resolved, { data: undefined, size: "unknown" }, useColor),
                     caller,
@@ -161,7 +161,7 @@ function tapAsync(promise, label, caller) {
             const cl = resolved.headers?.get?.("content-length");
             const tooLarge = cl != null && cl !== "" && Number(cl) > 512 * 1024;
             if (tooLarge) {
-                (0, writeLog_js_1.writeLog)({
+                (0, index_js_1.writeLog)({
                     channel: "log", tag: "[TAP]",
                     args: buildBlock(label, ms, resolved, { data: "(body too large to display)", size: formatBytes(Number(cl)) }, useColor),
                     caller,
@@ -169,13 +169,13 @@ function tapAsync(promise, label, caller) {
                 return;
             }
             void readBody(clone).then((body) => {
-                (0, writeLog_js_1.writeLog)({ channel: "log", tag: "[TAP]", args: buildBlock(label, ms, resolved, body, useColor), caller });
+                (0, index_js_1.writeLog)({ channel: "log", tag: "[TAP]", args: buildBlock(label, ms, resolved, body, useColor), caller });
             });
             return;
         }
         // Non-Response promise — plain value with elapsed time.
         const elapsed = formatDuration(ms, useColor);
-        (0, writeLog_js_1.writeLog)({
+        (0, index_js_1.writeLog)({
             channel: "log", tag: "[TAP]",
             args: label === undefined ? [elapsed, resolved] : [`${label} ${elapsed}`, resolved],
             caller,
@@ -183,7 +183,7 @@ function tapAsync(promise, label, caller) {
     }, (err) => {
         const ms = Math.round(node_perf_hooks_1.performance.now() - start);
         const elapsed = formatDuration(ms, useColor);
-        (0, writeLog_js_1.writeLog)({
+        (0, index_js_1.writeLog)({
             channel: "error", tag: "[TAP]",
             args: [label === undefined ? `rejected after ${elapsed}` : `${label} rejected after ${elapsed}`, err],
             caller,

package/dist/core/createLog.js

@@ -5,7 +5,7 @@
  * All rights reserved
  */
 import getCaller from "../caller/getCaller.js";
-import { writeLog } from "./writeLog.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

package/dist/core/writeLog/formatLocation.d.ts

@@ -0,0 +1,6 @@
+import { type Caller } from "../../caller/getCaller.js";
+/**
+ * Renders a caller as a `(file:line)` location — a clickable OSC-8 link on a
+ * supporting terminal, plain text otherwise. Pure (no stack access).
+ */
+export declare function formatLocation(caller: Caller, interactive: boolean): string;

package/dist/core/writeLog/formatLocation.js

@@ -0,0 +1,16 @@
+/*
+ * formatLocation.ts
+ * Created by Dewan Mobashirul
+ * Copyright (c) 2026 dewan-meadown
+ * All rights reserved
+ */
+import { fileUrl, hyperlink } from "../../decorations/link.js";
+/**
+ * Renders a caller as a `(file:line)` location — a clickable OSC-8 link on a
+ * supporting terminal, plain text otherwise. Pure (no stack access).
+ */
+export function formatLocation(caller, interactive) {
+    if (caller.file !== null && caller.line !== null && interactive)
+        return hyperlink(caller.label, fileUrl(caller.file));
+    return caller.label;
+}

package/dist/core/{writeLog.d.ts → writeLog/index.d.ts}

@@ -1,9 +1,6 @@
-import { type LogChannel } from "../constants.js";
-import { type Caller } from "../caller/getCaller.js";
-/** How many lines a long message shows before collapsing (0 = all). */
-export declare function getVisibleLines(): number;
-/** Set how many lines a long message shows before collapsing (0 = all). */
-export declare function setVisibleLines(value: number): void;
+import { type LogChannel } from "../../constants.js";
+import { type Caller } from "../../caller/getCaller.js";
+export { getVisibleLines, setVisibleLines } from "./visibleLines.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

package/dist/core/writeLog/index.js

@@ -0,0 +1,39 @@
+/*
+ * index.ts
+ * Created by Dewan Mobashirul
+ * Copyright (c) 2026 dewan-meadown
+ * All rights reserved
+ */
+import { TAG_COLOR, BRANCH, BRANCH_END, SEPARATOR, } from "../../constants.js";
+import getTimeStamp from "../../time/getTimeStamp.js";
+import { colorize } from "../../colors/color.js";
+import { isTTY } from "../../terminal/isTTY.js";
+import { renderMessage } from "./renderMessage.js";
+import { formatLocation } from "./formatLocation.js";
+export { getVisibleLines, setVisibleLines } from "./visibleLines.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);
+}

package/dist/core/writeLog/renderMessage.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Renders the args into a single message string exactly as console would —
+ * objects/errors via util.inspect, `%s`/`%d` format specifiers, and colors when
+ * on a terminal — then hang-indents every continuation line so multi-line
+ * output stays left-aligned under the branch, and collapses very long output.
+ */
+export declare function renderMessage(args: unknown[], useColor: boolean): string;

package/dist/core/writeLog/renderMessage.js

@@ -0,0 +1,37 @@
+/*
+ * renderMessage.ts
+ * Created by Dewan Mobashirul
+ * Copyright (c) 2026 dewan-meadown
+ * All rights reserved
+ */
+import { formatWithOptions } from "node:util";
+import { MESSAGE_INDENT } from "../../constants.js";
+import { colorize } from "../../colors/color.js";
+import { visibleLines } from "./visibleLines.js";
+/**
+ * Collapses a long multi-line message to {@link visibleLines} lines, replacing
+ * the rest with a dimmed `… N more lines` summary. When `visibleLines` is 0
+ * (the default) nothing is collapsed — the full message is shown.
+ */
+function collapse(text, useColor) {
+    if (visibleLines < 1)
+        return text;
+    const lines = text.split("\n");
+    if (lines.length <= visibleLines)
+        return text;
+    const hidden = lines.length - visibleLines;
+    const summary = `${MESSAGE_INDENT}... ${hidden} more line${hidden === 1 ? "" : "s"}`;
+    const visible = lines.slice(0, visibleLines);
+    visible.push(useColor ? colorize(summary, "gray") : summary);
+    return visible.join("\n");
+}
+/**
+ * Renders the args into a single message string exactly as console would —
+ * objects/errors via util.inspect, `%s`/`%d` format specifiers, and colors when
+ * on a terminal — then hang-indents every continuation line so multi-line
+ * output stays left-aligned under the branch, and collapses very long output.
+ */
+export function renderMessage(args, useColor) {
+    const text = formatWithOptions({ colors: useColor }, ...args);
+    return collapse(text.replace(/\n/g, `\n${colorize(MESSAGE_INDENT, "gray")}`), useColor);
+}

package/dist/core/writeLog/visibleLines.d.ts

@@ -0,0 +1,6 @@
+/** Max message lines to show before collapsing the rest; 0 (default) shows all. */
+export declare let visibleLines: number;
+/** How many lines a long message shows before collapsing (0 = all). */
+export declare function getVisibleLines(): number;
+/** Set how many lines a long message shows before collapsing (0 = all). */
+export declare function setVisibleLines(value: number): void;

package/dist/core/writeLog/visibleLines.js

@@ -0,0 +1,17 @@
+/*
+ * visibleLines.ts
+ * Created by Dewan Mobashirul
+ * Copyright (c) 2026 dewan-meadown
+ * All rights reserved
+ */
+import { DEFAULT_MAX_LINES } from "../../constants.js";
+/** Max message lines to show before collapsing the rest; 0 (default) shows all. */
+export let visibleLines = DEFAULT_MAX_LINES;
+/** How many lines a long message shows before collapsing (0 = all). */
+export function getVisibleLines() {
+    return visibleLines;
+}
+/** Set how many lines a long message shows before collapsing (0 = all). */
+export function setVisibleLines(value) {
+    visibleLines = Number.isFinite(value) && value > 0 ? Math.floor(value) : 0;
+}

package/dist/decorations/link.d.ts

@@ -1,9 +1,5 @@
-/**
- * Builds a `file://` URL for a path so terminals can open it on click.
- * When `line` is provided, appends `:line` so supporting terminals (VS Code,
- * iTerm2, WezTerm) jump straight to that line.
- */
-export declare function fileUrl(file: string, line?: number): string;
+/** Builds a `file://` URL for a path so terminals can open it on click. */
+export declare function fileUrl(file: string): string;
 /**
  * Wraps `text` in an OSC-8 terminal hyperlink pointing at `url`. Terminals that
  * support OSC-8 render `text` as a clickable link; others ignore the escape and

package/dist/decorations/link.js

@@ -5,14 +5,9 @@
  * All rights reserved
  */
 import { pathToFileURL } from "node:url";
-/**
- * Builds a `file://` URL for a path so terminals can open it on click.
- * When `line` is provided, appends `:line` so supporting terminals (VS Code,
- * iTerm2, WezTerm) jump straight to that line.
- */
-export function fileUrl(file, line) {
-    const base = file.startsWith("file://") ? file : pathToFileURL(file).href;
-    return line != null ? `${base}:${line}` : base;
+/** Builds a `file://` URL for a path so terminals can open it on click. */
+export function fileUrl(file) {
+    return file.startsWith("file://") ? file : pathToFileURL(file).href;
 }
 /**
  * Wraps `text` in an OSC-8 terminal hyperlink pointing at `url`. Terminals that

package/dist/index.js

@@ -6,7 +6,7 @@
  */
 import createLog from "./core/createLog.js";
 import createTap from "./tap/createTap.js";
-import { getVisibleLines, setVisibleLines } from "./core/writeLog.js";
+import { getVisibleLines, setVisibleLines } from "./core/writeLog/index.js";
 /**
  * Logs to the console, but only outside production. Each line is prefixed with
  * a level tag, a short local timestamp, and a clickable link to the file it was

package/dist/tap/createTap.js

@@ -5,7 +5,7 @@
  * All rights reserved
  */
 import getCaller from "../caller/getCaller.js";
-import { writeLog } from "../core/writeLog.js";
+import { writeLog } from "../core/writeLog/index.js";
 import { isLogAllowed } from "../config.js";
 import { isThenable, tapAsync } from "./tapAsync.js";
 /**

package/dist/tap/tapAsync.js

@@ -10,7 +10,7 @@
  */
 import { performance } from "node:perf_hooks";
 import { formatWithOptions } from "node:util";
-import { writeLog } from "../core/writeLog.js";
+import { writeLog } from "../core/writeLog/index.js";
 import { colorize } from "../colors/color.js";
 import { isTTY } from "../terminal/isTTY.js";
 /** Whether `value` is thenable (a promise we can await + time). */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meadown/logger",
-  "version": "1.8.9",
+  "version": "1.8.10",
   "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/writeLog.js

@@ -1,92 +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.getVisibleLines = getVisibleLines;
-exports.setVisibleLines = setVisibleLines;
-exports.writeLog = writeLog;
-const node_util_1 = require("node:util");
-const constants_js_1 = require("../constants.js");
-const getTimeStamp_js_1 = __importDefault(require("../time/getTimeStamp.js"));
-const link_js_1 = require("../decorations/link.js");
-const color_js_1 = require("../colors/color.js");
-const isTTY_js_1 = require("../terminal/isTTY.js");
-/** Max message lines to show before collapsing the rest; 0 (default) shows all. */
-let visibleLines = constants_js_1.DEFAULT_MAX_LINES;
-/** How many lines a long message shows before collapsing (0 = all). */
-function getVisibleLines() {
-    return visibleLines;
-}
-/** Set how many lines a long message shows before collapsing (0 = all). */
-function setVisibleLines(value) {
-    visibleLines = Number.isFinite(value) && value > 0 ? Math.floor(value) : 0;
-}
-/**
- * Collapses a long multi-line message to {@link visibleLines} lines, replacing
- * the rest with a dimmed `… N more lines` summary. When `visibleLines` is 0
- * (the default) nothing is collapsed — the full message is shown.
- */
-function collapse(text, useColor) {
-    if (visibleLines < 1)
-        return text;
-    const lines = text.split("\n");
-    if (lines.length <= visibleLines)
-        return text;
-    const hidden = lines.length - visibleLines;
-    const summary = `${constants_js_1.MESSAGE_INDENT}... ${hidden} more line${hidden === 1 ? "" : "s"}`;
-    const visible = lines.slice(0, visibleLines);
-    visible.push(useColor ? (0, color_js_1.colorize)(summary, "gray") : summary);
-    return visible.join("\n");
-}
-/**
- * Renders the args into a single message string exactly as console would —
- * objects/errors via util.inspect, `%s`/`%d` format specifiers, and colors when
- * on a terminal — then hang-indents every continuation line so multi-line
- * output stays left-aligned under the branch, and collapses very long output.
- */
-function renderMessage(args, useColor) {
-    const text = (0, node_util_1.formatWithOptions)({ colors: useColor }, ...args);
-    return collapse(text.replace(/\n/g, `\n${(0, color_js_1.colorize)(constants_js_1.MESSAGE_INDENT, "gray")}`), useColor);
-}
-/**
- * Renders a caller as a `(file:line)` location — a clickable OSC-8 link on a
- * supporting terminal, plain text otherwise. Pure (no stack access).
- */
-function formatLocation(caller, interactive) {
-    if (caller.file !== null && caller.line !== null && interactive)
-        return (0, link_js_1.hyperlink)(caller.label, (0, link_js_1.fileUrl)(caller.file, caller.line));
-    return caller.label;
-}
-/**
- * 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 = 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 = renderMessage(args, useColor);
-    const meta = `\n${connectorBottom} ${timeStamp} ${separator} ${locOut}`;
-    console[channel](`\n${tagOut}`, `\n${connector}`, message, meta);
-}

package/dist/core/writeLog.js

@@ -1,84 +0,0 @@
-/*
- * writeLog.ts
- * Created by Dewan Mobashirul
- * Copyright (c) 2026 dewan-meadown
- * All rights reserved
- */
-import { formatWithOptions } from "node:util";
-import { TAG_COLOR, BRANCH, BRANCH_END, SEPARATOR, MESSAGE_INDENT, DEFAULT_MAX_LINES, } from "../constants.js";
-import getTimeStamp from "../time/getTimeStamp.js";
-import { fileUrl, hyperlink } from "../decorations/link.js";
-import { colorize } from "../colors/color.js";
-import { isTTY } from "../terminal/isTTY.js";
-/** Max message lines to show before collapsing the rest; 0 (default) shows all. */
-let visibleLines = DEFAULT_MAX_LINES;
-/** How many lines a long message shows before collapsing (0 = all). */
-export function getVisibleLines() {
-    return visibleLines;
-}
-/** Set how many lines a long message shows before collapsing (0 = all). */
-export function setVisibleLines(value) {
-    visibleLines = Number.isFinite(value) && value > 0 ? Math.floor(value) : 0;
-}
-/**
- * Collapses a long multi-line message to {@link visibleLines} lines, replacing
- * the rest with a dimmed `… N more lines` summary. When `visibleLines` is 0
- * (the default) nothing is collapsed — the full message is shown.
- */
-function collapse(text, useColor) {
-    if (visibleLines < 1)
-        return text;
-    const lines = text.split("\n");
-    if (lines.length <= visibleLines)
-        return text;
-    const hidden = lines.length - visibleLines;
-    const summary = `${MESSAGE_INDENT}... ${hidden} more line${hidden === 1 ? "" : "s"}`;
-    const visible = lines.slice(0, visibleLines);
-    visible.push(useColor ? colorize(summary, "gray") : summary);
-    return visible.join("\n");
-}
-/**
- * Renders the args into a single message string exactly as console would —
- * objects/errors via util.inspect, `%s`/`%d` format specifiers, and colors when
- * on a terminal — then hang-indents every continuation line so multi-line
- * output stays left-aligned under the branch, and collapses very long output.
- */
-function renderMessage(args, useColor) {
-    const text = formatWithOptions({ colors: useColor }, ...args);
-    return collapse(text.replace(/\n/g, `\n${colorize(MESSAGE_INDENT, "gray")}`), useColor);
-}
-/**
- * Renders a caller as a `(file:line)` location — a clickable OSC-8 link on a
- * supporting terminal, plain text otherwise. Pure (no stack access).
- */
-function formatLocation(caller, interactive) {
-    if (caller.file !== null && caller.line !== null && interactive)
-        return hyperlink(caller.label, fileUrl(caller.file, caller.line));
-    return caller.label;
-}
-/**
- * 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);
-}