@meadown/logger 1.2.0 → 1.3.0

package/README.md

@@ -5,9 +5,9 @@ remember _which file_ a message came from — and worse, forgetting to pull thos
 out before shipping. So I made this.
 
 It's basically `console.log` with the rough edges sanded off: every message gets a
-level tag, a timestamp, and a **clickable link** to the exact file and line it came
-from. And it stays quiet in production, so you can leave your logs where they are and
-not worry about them.
+**color-coded** level tag, a timestamp, and the file and line it came from — as a
+**clickable link** you can open straight from your terminal. And it stays quiet in
+production, so you can leave your logs where they are and not worry about them.
 
 No dependencies. No config. Import it and you're done.
 
@@ -39,21 +39,27 @@ Auth user logged in
 Each line is tagged by level — `[INFO]`, `[WARN]`, or `[ERROR]` — followed by the
 timestamp and the source location, with your arguments on the next line.
 
-## Click to jump to the source
+## Color-coded levels
 
-That `(server.ts:42)` at the end of every log isn't just text — in terminals that
-support it, it's a **clickable link** that opens the exact line that wrote the log.
-No more hunting for where a message came from.
+The level tag is colored so you can spot what matters at a glance — `[INFO]` in
+cyan, `[WARN]` in yellow, `[ERROR]` in red. The timestamp and location stay plain so
+the color draws your eye straight to the level.
 
-It works out of the box in editors and terminals like VS Code, iTerm2, WezTerm,
-Kitty, and Windows Terminal. Anywhere else, it quietly falls back to plain
-`(server.ts:42)` text — nothing to configure, never any garbled output.
+Colors appear automatically when you're in a terminal. When output is piped to a
+file or another program, the tag prints as plain `[INFO]` text — no stray color
+codes in your log files. Nothing to configure.
 
-If your terminal supports links but isn't auto-detected, you can force them on:
+## Click to open the source
 
-```bash
-FORCE_HYPERLINK=1 node app.js
-```
+That `(server.ts:42)` at the end of every log isn't just text — when you're in a
+terminal, it's a **clickable link** that opens the file the log came from. No more
+hunting for where a message came from, and the line number is right there in the
+label.
+
+There's nothing to configure. Links show up automatically when output goes to a
+terminal, and when it's piped to a file or another program they quietly drop to
+plain `(server.ts:42)` text — so your log files never get cluttered with escape
+codes.
 
 ## What about production?
 

package/dist/cjs/utils/color.d.ts

@@ -0,0 +1,23 @@
+/** ANSI SGR codes for the colors/styles the logger uses. */
+declare const CODES: {
+    readonly red: 31;
+    readonly yellow: 33;
+    readonly cyan: 36;
+    readonly dim: 2;
+};
+/** The named colors/styles {@link colorize} understands. */
+export type Color = keyof typeof CODES;
+/**
+ * Wraps `text` in the ANSI escape codes for `color`, resetting afterwards.
+ * Pure string work — deciding *whether* to colorize is {@link supportsColor}'s
+ * job, kept separate so callers control it per stream.
+ */
+export declare function colorize(text: string, color: Color): string;
+/**
+ * Whether to emit ANSI colors for the given stream. Driven solely by the stream
+ * being an interactive terminal (`isTTY`) — no env vars, no config. When output
+ * is piped or redirected, colors are skipped so escape codes never end up in
+ * files or logs.
+ */
+export declare function supportsColor(streamName: "stdout" | "stderr"): boolean;
+export {};

package/dist/cjs/utils/color.js

@@ -0,0 +1,38 @@
+"use strict";
+/*
+ * color.ts
+ * Created by Dewan Mobashirul
+ * Copyright (c) 2026 dewan-meadown
+ * All rights reserved
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.colorize = colorize;
+exports.supportsColor = supportsColor;
+/** ANSI SGR codes for the colors/styles the logger uses. */
+const CODES = {
+    red: 31,
+    yellow: 33,
+    cyan: 36,
+    dim: 2,
+};
+const RESET = "\x1b[0m";
+/**
+ * Wraps `text` in the ANSI escape codes for `color`, resetting afterwards.
+ * Pure string work — deciding *whether* to colorize is {@link supportsColor}'s
+ * job, kept separate so callers control it per stream.
+ */
+function colorize(text, color) {
+    return `\x1b[${CODES[color]}m${text}${RESET}`;
+}
+/**
+ * Whether to emit ANSI colors for the given stream. Driven solely by the stream
+ * being an interactive terminal (`isTTY`) — no env vars, no config. When output
+ * is piped or redirected, colors are skipped so escape codes never end up in
+ * files or logs.
+ */
+function supportsColor(streamName) {
+    if (typeof process === "undefined")
+        return false;
+    const stream = streamName === "stdout" ? process.stdout : process.stderr;
+    return Boolean(stream?.isTTY);
+}

package/dist/cjs/utils/createLog.js

@@ -13,7 +13,14 @@ exports.default = createLog;
 const getCaller_js_1 = __importDefault(require("./getCaller.js"));
 const getTimeStamp_js_1 = __importDefault(require("./getTimeStamp.js"));
 const link_js_1 = require("./link.js");
+const color_js_1 = require("./color.js");
 const config_js_1 = require("../config.js");
+/** The tag color for each channel: info → cyan, warn → yellow, error → red. */
+const TAG_COLOR = {
+    log: "cyan",
+    warn: "yellow",
+    error: "red",
+};
 /**
  * Renders a caller as a `(file:line)` location. When the terminal supports
  * OSC-8 hyperlinks, the location is a clickable link to the exact source line;
@@ -24,7 +31,7 @@ function formatLocation(caller, streamName) {
     if (caller.file !== null &&
         caller.line !== null &&
         (0, link_js_1.supportsHyperlinks)(streamName))
-        return (0, link_js_1.hyperlink)(caller.label, (0, link_js_1.fileUrl)(caller.file, caller.line));
+        return (0, link_js_1.hyperlink)(caller.label, (0, link_js_1.fileUrl)(caller.file));
     return caller.label;
 }
 /**
@@ -41,6 +48,10 @@ function createLog(channel, tag) {
             return;
         const caller = (0, getCaller_js_1.default)();
         const location = formatLocation(caller, streamName);
-        console[channel](tag, (0, getTimeStamp_js_1.default)(), `(${location})`, `\n`, ...args, `\n`);
+        // Color only the level tag, and only on a real terminal.
+        const tagOut = (0, color_js_1.supportsColor)(streamName)
+            ? (0, color_js_1.colorize)(tag, TAG_COLOR[channel])
+            : tag;
+        console[channel](tagOut, (0, getTimeStamp_js_1.default)(), `(${location})`, `\n`, ...args, `\n`);
     };
 }

package/dist/cjs/utils/index.d.ts

@@ -2,3 +2,4 @@ export { default as createLog, type LogChannel } from "./createLog.js";
 export { default as getCaller, type Caller } from "./getCaller.js";
 export { default as getTimeStamp } from "./getTimeStamp.js";
 export { fileUrl, hyperlink, supportsHyperlinks } from "./link.js";
+export { colorize, supportsColor, type Color } from "./color.js";

package/dist/cjs/utils/index.js

@@ -9,7 +9,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.supportsHyperlinks = exports.hyperlink = exports.fileUrl = exports.getTimeStamp = exports.getCaller = exports.createLog = void 0;
+exports.supportsColor = exports.colorize = exports.supportsHyperlinks = exports.hyperlink = exports.fileUrl = exports.getTimeStamp = exports.getCaller = exports.createLog = void 0;
 var createLog_js_1 = require("./createLog.js");
 Object.defineProperty(exports, "createLog", { enumerable: true, get: function () { return __importDefault(createLog_js_1).default; } });
 var getCaller_js_1 = require("./getCaller.js");
@@ -20,3 +20,6 @@ var link_js_1 = require("./link.js");
 Object.defineProperty(exports, "fileUrl", { enumerable: true, get: function () { return link_js_1.fileUrl; } });
 Object.defineProperty(exports, "hyperlink", { enumerable: true, get: function () { return link_js_1.hyperlink; } });
 Object.defineProperty(exports, "supportsHyperlinks", { enumerable: true, get: function () { return link_js_1.supportsHyperlinks; } });
+var color_js_1 = require("./color.js");
+Object.defineProperty(exports, "colorize", { enumerable: true, get: function () { return color_js_1.colorize; } });
+Object.defineProperty(exports, "supportsColor", { enumerable: true, get: function () { return color_js_1.supportsColor; } });

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

@@ -1,17 +1,21 @@
 /**
- * Builds a `file://` URL with a trailing `:line` so terminals can jump to the
- * exact line. Paths already in `file://` form are used as-is.
+ * Builds a valid `file://` URL for a path so terminals can open it on click.
+ * Paths already in `file://` form are used as-is. We intentionally do NOT append
+ * `:line` — that isn't a valid URI and breaks file openers (e.g. GNOME/`gio`,
+ * which would look for a file literally named `foo.ts:42`). The line number
+ * stays visible in the link's display text instead.
  */
-export declare function fileUrl(file: string, line: number): string;
+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 simply show `text`.
+ * support OSC-8 render `text` as a clickable link; others ignore the escape and
+ * simply show `text`.
  */
 export declare function hyperlink(text: string, url: string): string;
 /**
- * Conservative detection of OSC-8 hyperlink support for the given stream.
- * Honors `FORCE_HYPERLINK` (set to a falsy value to force off), requires a TTY,
- * and otherwise allow-lists terminals known to support hyperlinks. Unknown
- * terminals get plain text so output is never garbled.
+ * Whether to emit OSC-8 hyperlinks for the given stream. Driven solely by the
+ * stream being an interactive terminal (`isTTY`) — no env vars, no config. When
+ * output is piped or redirected, links are skipped so escapes never end up in
+ * files or logs. Terminals that don't understand OSC-8 just show the plain text.
  */
 export declare function supportsHyperlinks(streamName: "stdout" | "stderr"): boolean;

package/dist/cjs/utils/link.js

@@ -11,16 +11,19 @@ exports.hyperlink = hyperlink;
 exports.supportsHyperlinks = supportsHyperlinks;
 const node_url_1 = require("node:url");
 /**
- * Builds a `file://` URL with a trailing `:line` so terminals can jump to the
- * exact line. Paths already in `file://` form are used as-is.
+ * Builds a valid `file://` URL for a path so terminals can open it on click.
+ * Paths already in `file://` form are used as-is. We intentionally do NOT append
+ * `:line` — that isn't a valid URI and breaks file openers (e.g. GNOME/`gio`,
+ * which would look for a file literally named `foo.ts:42`). The line number
+ * stays visible in the link's display text instead.
  */
-function fileUrl(file, line) {
-    const base = file.startsWith("file://") ? file : (0, node_url_1.pathToFileURL)(file).href;
-    return `${base}:${line}`;
+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
- * support OSC-8 render `text` as a clickable link; others simply show `text`.
+ * support OSC-8 render `text` as a clickable link; others ignore the escape and
+ * simply show `text`.
  */
 function hyperlink(text, url) {
     const OSC = "\x1b]8;;";
@@ -28,36 +31,14 @@ function hyperlink(text, url) {
     return `${OSC}${url}${BEL}${text}${OSC}${BEL}`;
 }
 /**
- * Conservative detection of OSC-8 hyperlink support for the given stream.
- * Honors `FORCE_HYPERLINK` (set to a falsy value to force off), requires a TTY,
- * and otherwise allow-lists terminals known to support hyperlinks. Unknown
- * terminals get plain text so output is never garbled.
+ * Whether to emit OSC-8 hyperlinks for the given stream. Driven solely by the
+ * stream being an interactive terminal (`isTTY`) — no env vars, no config. When
+ * output is piped or redirected, links are skipped so escapes never end up in
+ * files or logs. Terminals that don't understand OSC-8 just show the plain text.
  */
 function supportsHyperlinks(streamName) {
     if (typeof process === "undefined")
         return false;
-    const env = process.env;
-    const force = env.FORCE_HYPERLINK;
-    if (force !== undefined && force !== "")
-        return force !== "0" && force.toLowerCase() !== "false";
     const stream = streamName === "stdout" ? process.stdout : process.stderr;
-    if (!stream || !stream.isTTY)
-        return false;
-    if (env.TERM === "dumb")
-        return false;
-    if (env.CI !== undefined && env.CI !== "")
-        return false;
-    const program = env.TERM_PROGRAM;
-    if (program === "vscode" ||
-        program === "iTerm.app" ||
-        program === "Hyper" ||
-        program === "WezTerm")
-        return true;
-    if (env.WT_SESSION)
-        return true; // Windows Terminal
-    if (env.KITTY_WINDOW_ID)
-        return true;
-    if (env.VTE_VERSION !== undefined && Number(env.VTE_VERSION) >= 5000)
-        return true; // GNOME, etc.
-    return false;
+    return Boolean(stream?.isTTY);
 }

package/dist/utils/color.d.ts

@@ -0,0 +1,24 @@
+/** ANSI SGR codes for the colors/styles the logger uses. */
+declare const CODES: {
+    readonly red: 31;
+    readonly yellow: 33;
+    readonly cyan: 36;
+    readonly dim: 2;
+};
+/** The named colors/styles {@link colorize} understands. */
+export type Color = keyof typeof CODES;
+/**
+ * Wraps `text` in the ANSI escape codes for `color`, resetting afterwards.
+ * Pure string work — deciding *whether* to colorize is {@link supportsColor}'s
+ * job, kept separate so callers control it per stream.
+ */
+export declare function colorize(text: string, color: Color): string;
+/**
+ * Whether to emit ANSI colors for the given stream. Driven solely by the stream
+ * being an interactive terminal (`isTTY`) — no env vars, no config. When output
+ * is piped or redirected, colors are skipped so escape codes never end up in
+ * files or logs.
+ */
+export declare function supportsColor(streamName: "stdout" | "stderr"): boolean;
+export {};
+//# sourceMappingURL=color.d.ts.map

package/dist/utils/color.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color.d.ts","sourceRoot":"","sources":["../../src/utils/color.ts"],"names":[],"mappings":"AAOA,4DAA4D;AAC5D,QAAA,MAAM,KAAK;;;;;CAKD,CAAA;AAEV,4DAA4D;AAC5D,MAAM,MAAM,KAAK,GAAG,MAAM,OAAO,KAAK,CAAA;AAItC;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM,CAE3D;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAItE"}

package/dist/utils/color.js

@@ -0,0 +1,35 @@
+/*
+ * color.ts
+ * Created by Dewan Mobashirul
+ * Copyright (c) 2026 dewan-meadown
+ * All rights reserved
+ */
+/** ANSI SGR codes for the colors/styles the logger uses. */
+const CODES = {
+    red: 31,
+    yellow: 33,
+    cyan: 36,
+    dim: 2,
+};
+const RESET = "\x1b[0m";
+/**
+ * Wraps `text` in the ANSI escape codes for `color`, resetting afterwards.
+ * Pure string work — deciding *whether* to colorize is {@link supportsColor}'s
+ * job, kept separate so callers control it per stream.
+ */
+export function colorize(text, color) {
+    return `\x1b[${CODES[color]}m${text}${RESET}`;
+}
+/**
+ * Whether to emit ANSI colors for the given stream. Driven solely by the stream
+ * being an interactive terminal (`isTTY`) — no env vars, no config. When output
+ * is piped or redirected, colors are skipped so escape codes never end up in
+ * files or logs.
+ */
+export function supportsColor(streamName) {
+    if (typeof process === "undefined")
+        return false;
+    const stream = streamName === "stdout" ? process.stdout : process.stderr;
+    return Boolean(stream?.isTTY);
+}
+//# sourceMappingURL=color.js.map

package/dist/utils/color.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"color.js","sourceRoot":"","sources":["../../src/utils/color.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,4DAA4D;AAC5D,MAAM,KAAK,GAAG;IACZ,GAAG,EAAE,EAAE;IACP,MAAM,EAAE,EAAE;IACV,IAAI,EAAE,EAAE;IACR,GAAG,EAAE,CAAC;CACE,CAAA;AAKV,MAAM,KAAK,GAAG,SAAS,CAAA;AAEvB;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAE,KAAY;IACjD,OAAO,QAAQ,KAAK,CAAC,KAAK,CAAC,IAAI,IAAI,GAAG,KAAK,EAAE,CAAA;AAC/C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,UAA+B;IAC3D,IAAI,OAAO,OAAO,KAAK,WAAW;QAAE,OAAO,KAAK,CAAA;IAChD,MAAM,MAAM,GAAG,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAA;IACxE,OAAO,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;AAC/B,CAAC"}

package/dist/utils/createLog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createLog.d.ts","sourceRoot":"","sources":["../../src/utils/createLog.ts"],"names":[],"mappings":"AAYA,iDAAiD;AACjD,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,OAAO,GAAG,MAAM,CAAA;AAqBjD;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,SAAS,CAC/B,OAAO,EAAE,UAAU,EACnB,GAAG,EAAE,MAAM,GACV,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAQ9B"}
+{"version":3,"file":"createLog.d.ts","sourceRoot":"","sources":["../../src/utils/createLog.ts"],"names":[],"mappings":"AAaA,iDAAiD;AACjD,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,OAAO,GAAG,MAAM,CAAA;AA4BjD;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,SAAS,CAC/B,OAAO,EAAE,UAAU,EACnB,GAAG,EAAE,MAAM,GACV,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAc9B"}

package/dist/utils/createLog.js

@@ -7,7 +7,14 @@
 import getCaller from "./getCaller.js";
 import getTimeStamp from "./getTimeStamp.js";
 import { fileUrl, hyperlink, supportsHyperlinks } from "./link.js";
+import { colorize, supportsColor } from "./color.js";
 import { isLogAllowed } from "../config.js";
+/** The tag color for each channel: info → cyan, warn → yellow, error → red. */
+const TAG_COLOR = {
+    log: "cyan",
+    warn: "yellow",
+    error: "red",
+};
 /**
  * Renders a caller as a `(file:line)` location. When the terminal supports
  * OSC-8 hyperlinks, the location is a clickable link to the exact source line;
@@ -18,7 +25,7 @@ function formatLocation(caller, streamName) {
     if (caller.file !== null &&
         caller.line !== null &&
         supportsHyperlinks(streamName))
-        return hyperlink(caller.label, fileUrl(caller.file, caller.line));
+        return hyperlink(caller.label, fileUrl(caller.file));
     return caller.label;
 }
 /**
@@ -35,7 +42,11 @@ export default function createLog(channel, tag) {
             return;
         const caller = getCaller();
         const location = formatLocation(caller, streamName);
-        console[channel](tag, getTimeStamp(), `(${location})`, `\n`, ...args, `\n`);
+        // Color only the level tag, and only on a real terminal.
+        const tagOut = supportsColor(streamName)
+            ? colorize(tag, TAG_COLOR[channel])
+            : tag;
+        console[channel](tagOut, getTimeStamp(), `(${location})`, `\n`, ...args, `\n`);
     };
 }
 //# sourceMappingURL=createLog.js.map

package/dist/utils/createLog.js.map

@@ -1 +1 @@
-{"version":3,"file":"createLog.js","sourceRoot":"","sources":["../../src/utils/createLog.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,SAA0B,MAAM,gBAAgB,CAAA;AACvD,OAAO,YAAY,MAAM,mBAAmB,CAAA;AAC5C,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAA;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAK3C;;;;;GAKG;AACH,SAAS,cAAc,CACrB,MAAc,EACd,UAA+B;IAE/B,IACE,MAAM,CAAC,IAAI,KAAK,IAAI;QACpB,MAAM,CAAC,IAAI,KAAK,IAAI;QACpB,kBAAkB,CAAC,UAAU,CAAC;QAE9B,OAAO,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAA;IACnE,OAAO,MAAM,CAAC,KAAK,CAAA;AACrB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,SAAS,CAC/B,OAAmB,EACnB,GAAW;IAEX,MAAM,UAAU,GAAG,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAA;IAC1D,OAAO,CAAC,GAAG,IAAe,EAAQ,EAAE;QAClC,IAAI,CAAC,YAAY,EAAE;YAAE,OAAM;QAC3B,MAAM,MAAM,GAAG,SAAS,EAAE,CAAA;QAC1B,MAAM,QAAQ,GAAG,cAAc,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;QACnD,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,YAAY,EAAE,EAAE,IAAI,QAAQ,GAAG,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,IAAI,CAAC,CAAA;IAC7E,CAAC,CAAA;AACH,CAAC"}
+{"version":3,"file":"createLog.js","sourceRoot":"","sources":["../../src/utils/createLog.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,SAA0B,MAAM,gBAAgB,CAAA;AACvD,OAAO,YAAY,MAAM,mBAAmB,CAAA;AAC5C,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAA;AAClE,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAc,MAAM,YAAY,CAAA;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAK3C,+EAA+E;AAC/E,MAAM,SAAS,GAA8B;IAC3C,GAAG,EAAE,MAAM;IACX,IAAI,EAAE,QAAQ;IACd,KAAK,EAAE,KAAK;CACb,CAAA;AAED;;;;;GAKG;AACH,SAAS,cAAc,CACrB,MAAc,EACd,UAA+B;IAE/B,IACE,MAAM,CAAC,IAAI,KAAK,IAAI;QACpB,MAAM,CAAC,IAAI,KAAK,IAAI;QACpB,kBAAkB,CAAC,UAAU,CAAC;QAE9B,OAAO,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAA;IACtD,OAAO,MAAM,CAAC,KAAK,CAAA;AACrB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,SAAS,CAC/B,OAAmB,EACnB,GAAW;IAEX,MAAM,UAAU,GAAG,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAA;IAC1D,OAAO,CAAC,GAAG,IAAe,EAAQ,EAAE;QAClC,IAAI,CAAC,YAAY,EAAE;YAAE,OAAM;QAC3B,MAAM,MAAM,GAAG,SAAS,EAAE,CAAA;QAC1B,MAAM,QAAQ,GAAG,cAAc,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;QAEnD,yDAAyD;QACzD,MAAM,MAAM,GAAG,aAAa,CAAC,UAAU,CAAC;YACtC,CAAC,CAAC,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;YACnC,CAAC,CAAC,GAAG,CAAA;QAEP,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,YAAY,EAAE,EAAE,IAAI,QAAQ,GAAG,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,IAAI,CAAC,CAAA;IAChF,CAAC,CAAA;AACH,CAAC"}

package/dist/utils/index.d.ts

@@ -2,4 +2,5 @@ export { default as createLog, type LogChannel } from "./createLog.js";
 export { default as getCaller, type Caller } from "./getCaller.js";
 export { default as getTimeStamp } from "./getTimeStamp.js";
 export { fileUrl, hyperlink, supportsHyperlinks } from "./link.js";
+export { colorize, supportsColor, type Color } from "./color.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAA;AACtE,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,KAAK,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAClE,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAC3D,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAA;AACtE,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,KAAK,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAClE,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAC3D,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAA;AAClE,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,KAAK,KAAK,EAAE,MAAM,YAAY,CAAA"}

package/dist/utils/index.js

@@ -8,4 +8,5 @@ export { default as createLog } from "./createLog.js";
 export { default as getCaller } from "./getCaller.js";
 export { default as getTimeStamp } from "./getTimeStamp.js";
 export { fileUrl, hyperlink, supportsHyperlinks } from "./link.js";
+export { colorize, supportsColor } from "./color.js";
 //# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,IAAI,SAAS,EAAmB,MAAM,gBAAgB,CAAA;AACtE,OAAO,EAAE,OAAO,IAAI,SAAS,EAAe,MAAM,gBAAgB,CAAA;AAClE,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAC3D,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,IAAI,SAAS,EAAmB,MAAM,gBAAgB,CAAA;AACtE,OAAO,EAAE,OAAO,IAAI,SAAS,EAAe,MAAM,gBAAgB,CAAA;AAClE,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAC3D,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAA;AAClE,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAc,MAAM,YAAY,CAAA"}

package/dist/utils/link.d.ts

@@ -1,18 +1,22 @@
 /**
- * Builds a `file://` URL with a trailing `:line` so terminals can jump to the
- * exact line. Paths already in `file://` form are used as-is.
+ * Builds a valid `file://` URL for a path so terminals can open it on click.
+ * Paths already in `file://` form are used as-is. We intentionally do NOT append
+ * `:line` — that isn't a valid URI and breaks file openers (e.g. GNOME/`gio`,
+ * which would look for a file literally named `foo.ts:42`). The line number
+ * stays visible in the link's display text instead.
  */
-export declare function fileUrl(file: string, line: number): string;
+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 simply show `text`.
+ * support OSC-8 render `text` as a clickable link; others ignore the escape and
+ * simply show `text`.
  */
 export declare function hyperlink(text: string, url: string): string;
 /**
- * Conservative detection of OSC-8 hyperlink support for the given stream.
- * Honors `FORCE_HYPERLINK` (set to a falsy value to force off), requires a TTY,
- * and otherwise allow-lists terminals known to support hyperlinks. Unknown
- * terminals get plain text so output is never garbled.
+ * Whether to emit OSC-8 hyperlinks for the given stream. Driven solely by the
+ * stream being an interactive terminal (`isTTY`) — no env vars, no config. When
+ * output is piped or redirected, links are skipped so escapes never end up in
+ * files or logs. Terminals that don't understand OSC-8 just show the plain text.
  */
 export declare function supportsHyperlinks(streamName: "stdout" | "stderr"): boolean;
 //# sourceMappingURL=link.d.ts.map

package/dist/utils/link.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"link.d.ts","sourceRoot":"","sources":["../../src/utils/link.ts"],"names":[],"mappings":"AASA;;;GAGG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAG1D;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAI3D;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,CA2B3E"}
+{"version":3,"file":"link.d.ts","sourceRoot":"","sources":["../../src/utils/link.ts"],"names":[],"mappings":"AASA;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAI3D;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAI3E"}

package/dist/utils/link.js

@@ -6,16 +6,19 @@
  */
 import { pathToFileURL } from "node:url";
 /**
- * Builds a `file://` URL with a trailing `:line` so terminals can jump to the
- * exact line. Paths already in `file://` form are used as-is.
+ * Builds a valid `file://` URL for a path so terminals can open it on click.
+ * Paths already in `file://` form are used as-is. We intentionally do NOT append
+ * `:line` — that isn't a valid URI and breaks file openers (e.g. GNOME/`gio`,
+ * which would look for a file literally named `foo.ts:42`). The line number
+ * stays visible in the link's display text instead.
  */
-export function fileUrl(file, line) {
-    const base = file.startsWith("file://") ? file : pathToFileURL(file).href;
-    return `${base}:${line}`;
+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
- * support OSC-8 render `text` as a clickable link; others simply show `text`.
+ * support OSC-8 render `text` as a clickable link; others ignore the escape and
+ * simply show `text`.
  */
 export function hyperlink(text, url) {
     const OSC = "\x1b]8;;";
@@ -23,37 +26,15 @@ export function hyperlink(text, url) {
     return `${OSC}${url}${BEL}${text}${OSC}${BEL}`;
 }
 /**
- * Conservative detection of OSC-8 hyperlink support for the given stream.
- * Honors `FORCE_HYPERLINK` (set to a falsy value to force off), requires a TTY,
- * and otherwise allow-lists terminals known to support hyperlinks. Unknown
- * terminals get plain text so output is never garbled.
+ * Whether to emit OSC-8 hyperlinks for the given stream. Driven solely by the
+ * stream being an interactive terminal (`isTTY`) — no env vars, no config. When
+ * output is piped or redirected, links are skipped so escapes never end up in
+ * files or logs. Terminals that don't understand OSC-8 just show the plain text.
  */
 export function supportsHyperlinks(streamName) {
     if (typeof process === "undefined")
         return false;
-    const env = process.env;
-    const force = env.FORCE_HYPERLINK;
-    if (force !== undefined && force !== "")
-        return force !== "0" && force.toLowerCase() !== "false";
     const stream = streamName === "stdout" ? process.stdout : process.stderr;
-    if (!stream || !stream.isTTY)
-        return false;
-    if (env.TERM === "dumb")
-        return false;
-    if (env.CI !== undefined && env.CI !== "")
-        return false;
-    const program = env.TERM_PROGRAM;
-    if (program === "vscode" ||
-        program === "iTerm.app" ||
-        program === "Hyper" ||
-        program === "WezTerm")
-        return true;
-    if (env.WT_SESSION)
-        return true; // Windows Terminal
-    if (env.KITTY_WINDOW_ID)
-        return true;
-    if (env.VTE_VERSION !== undefined && Number(env.VTE_VERSION) >= 5000)
-        return true; // GNOME, etc.
-    return false;
+    return Boolean(stream?.isTTY);
 }
 //# sourceMappingURL=link.js.map

package/dist/utils/link.js.map

@@ -1 +1 @@
-{"version":3,"file":"link.js","sourceRoot":"","sources":["../../src/utils/link.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAExC;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,IAAY,EAAE,IAAY;IAChD,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,IAAI,CAAA;IACzE,OAAO,GAAG,IAAI,IAAI,IAAI,EAAE,CAAA;AAC1B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,GAAW;IACjD,MAAM,GAAG,GAAG,UAAU,CAAA;IACtB,MAAM,GAAG,GAAG,MAAM,CAAA;IAClB,OAAO,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,IAAI,GAAG,GAAG,GAAG,GAAG,EAAE,CAAA;AAChD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,UAA+B;IAChE,IAAI,OAAO,OAAO,KAAK,WAAW;QAAE,OAAO,KAAK,CAAA;IAChD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAA;IAEvB,MAAM,KAAK,GAAG,GAAG,CAAC,eAAe,CAAA;IACjC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE;QACrC,OAAO,KAAK,KAAK,GAAG,IAAI,KAAK,CAAC,WAAW,EAAE,KAAK,OAAO,CAAA;IAEzD,MAAM,MAAM,GAAG,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAA;IACxE,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK;QAAE,OAAO,KAAK,CAAA;IAC1C,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM;QAAE,OAAO,KAAK,CAAA;IACrC,IAAI,GAAG,CAAC,EAAE,KAAK,SAAS,IAAI,GAAG,CAAC,EAAE,KAAK,EAAE;QAAE,OAAO,KAAK,CAAA;IAEvD,MAAM,OAAO,GAAG,GAAG,CAAC,YAAY,CAAA;IAChC,IACE,OAAO,KAAK,QAAQ;QACpB,OAAO,KAAK,WAAW;QACvB,OAAO,KAAK,OAAO;QACnB,OAAO,KAAK,SAAS;QAErB,OAAO,IAAI,CAAA;IACb,IAAI,GAAG,CAAC,UAAU;QAAE,OAAO,IAAI,CAAA,CAAC,mBAAmB;IACnD,IAAI,GAAG,CAAC,eAAe;QAAE,OAAO,IAAI,CAAA;IACpC,IAAI,GAAG,CAAC,WAAW,KAAK,SAAS,IAAI,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,IAAI;QAClE,OAAO,IAAI,CAAA,CAAC,cAAc;IAE5B,OAAO,KAAK,CAAA;AACd,CAAC"}
+{"version":3,"file":"link.js","sourceRoot":"","sources":["../../src/utils/link.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAExC;;;;;;GAMG;AACH,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,OAAO,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,IAAI,CAAA;AACrE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,GAAW;IACjD,MAAM,GAAG,GAAG,UAAU,CAAA;IACtB,MAAM,GAAG,GAAG,MAAM,CAAA;IAClB,OAAO,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,IAAI,GAAG,GAAG,GAAG,GAAG,EAAE,CAAA;AAChD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,UAA+B;IAChE,IAAI,OAAO,OAAO,KAAK,WAAW;QAAE,OAAO,KAAK,CAAA;IAChD,MAAM,MAAM,GAAG,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAA;IACxE,OAAO,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;AAC/B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meadown/logger",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "A tiny, zero-dependency logger for Node.js and TypeScript that tags each line, timestamps it, shows the source file and line, and goes quiet in production.",
   "keywords": [
     "logger",