@meadown/logger 1.3.1 → 1.5.0

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 Dewan Mobashirul
+Copyright (c) 2026 meadown
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -32,13 +32,14 @@ customLog.error("Something went wrong")
 You'll see something like:
 
 ```text
-[INFO] 2026-05-30T10:00:00.000Z (server.ts:42)
-  Auth user logged in
+[INFO] 05-30 04:00:00 PM (server.ts:42)
+└── Auth user logged in
 ```
 
-The first line carries the level tag — `[INFO]`, `[WARN]`, or `[ERROR]` — the
-timestamp, and the source location. Your message sits on the line below, indented so
-it's easy to scan down a busy terminal.
+The first line carries the level tag — `[INFO]`, `[WARN]`, or `[ERROR]` — a short
+local timestamp (month-day and 12-hour time), and the source location. Your message
+hangs off a `└──` branch on the line below (colored to match the level), so it's easy
+to scan down a busy terminal.
 
 ### One thing if you re-export it
 
@@ -58,8 +59,8 @@ export const customLog = (...args) => log(...args)
 ## Color-coded levels
 
 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.
+cyan, `[WARN]` in yellow, `[ERROR]` in red. The `(file:line)` location is dimmed to
+light gray so it stays out of the way, and the timestamp is left plain.
 
 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
@@ -77,6 +78,22 @@ 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.
 
+## Trimming long messages
+
+By default you see everything you log, however long. But if a big object or a
+chatty multi-line message is drowning out your terminal, you can cap how many
+lines each message shows:
+
+```ts
+import customLog from "@meadown/logger"
+
+customLog.maxLines = 5 // show the first 5 lines, then "... N more lines"
+customLog.maxLines = 0 // back to the default — show everything
+```
+
+It only trims the _message_, never the tag, timestamp, or location, and the setting
+applies to `customLog`, `.error`, and `.warn` alike.
+
 ## What about production?
 
 Here's the nice part: you don't have to do anything. Logs show up while you're
@@ -93,4 +110,4 @@ quietly step aside.
 
 ## License
 
-MIT © Dewan Mobashirul
+MIT © meadown

package/dist/cjs/index.d.ts

@@ -3,15 +3,12 @@ export interface LogFN {
     (...args: unknown[]): void;
     error(...args: unknown[]): void;
     warn(...args: unknown[]): void;
+    /**
+     * How many lines of a multi-line message to show before collapsing the rest
+     * into a `… N more lines` summary. `0` (the default) shows everything.
+     */
+    maxLines: number;
 }
-/**
- * Logs to the console, but only outside production. Each line is prefixed with
- * a level tag, an ISO timestamp, and a clickable link to the file and line it
- * was called from; all arguments are then printed as-is.
- * @example
- * customLog("Auth", "user logged in")
- * // [INFO] 2026-05-30T10:00:00.000Z (server.ts:42) Auth user logged in
- */
 declare const customLog: LogFN;
 export { customLog };
 export default customLog;

package/dist/cjs/index.js

@@ -10,15 +10,26 @@ exports.customLog = void 0;
 const index_js_1 = require("./utils/index.js");
 /**
  * Logs to the console, but only outside production. Each line is prefixed with
- * a level tag, an ISO timestamp, and a clickable link to the file and line it
- * was called from; all arguments are then printed as-is.
+ * a level tag, a short local timestamp, and a clickable link to the file it was
+ * called from; all arguments are then printed as-is.
  * @example
  * customLog("Auth", "user logged in")
- * // [INFO] 2026-05-30T10:00:00.000Z (server.ts:42) Auth user logged in
+ * // [INFO] 05-30 04:00:00 PM (server.ts:42) Auth user logged in
+ * @example
+ * customLog.maxLines = 5 // long messages collapse to 5 lines; 0 = show all
  */
-const customLog = Object.assign((0, index_js_1.createLog)("log", "[INFO]"), {
+const logger = Object.assign((0, index_js_1.createLog)("log", "[INFO]"), {
     error: (0, index_js_1.createLog)("error", "[ERROR]"),
     warn: (0, index_js_1.createLog)("warn", "[WARN]"),
 });
+// `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: index_js_1.getVisibleLines,
+    set: index_js_1.setVisibleLines,
+    enumerable: true,
+    configurable: true,
+});
+const customLog = logger;
 exports.customLog = customLog;
 exports.default = customLog;

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

@@ -3,7 +3,9 @@ declare const CODES: {
     readonly red: 31;
     readonly yellow: 33;
     readonly cyan: 36;
-    readonly dim: 2;
+    readonly gray: 90;
+    readonly teal: "38;5;30";
+    readonly dimTeal: "38;5;23";
 };
 /** The named colors/styles {@link colorize} understands. */
 export type Color = keyof typeof CODES;

package/dist/cjs/utils/color.js

@@ -13,7 +13,9 @@ const CODES = {
     red: 31,
     yellow: 33,
     cyan: 36,
-    dim: 2,
+    gray: 90, // bright black — renders as light gray
+    teal: "38;5;30", // 256-color teal (#008787)
+    dimTeal: "38;5;23", // 256-color darker teal (#005f5f)
 };
 const RESET = "\x1b[0m";
 /**

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

@@ -1,5 +1,9 @@
 /** The console channels the logger writes to. */
 export type LogChannel = "log" | "error" | "warn";
+/** 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;
 /**
  * Builds a log function bound to a console channel and tag. The returned closure
  * is what the caller invokes directly, so {@link getCaller} still resolves the

package/dist/cjs/utils/createLog.js

@@ -9,7 +9,10 @@ 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.default = createLog;
+const node_util_1 = require("node:util");
 const getCaller_js_1 = __importDefault(require("./getCaller.js"));
 const getTimeStamp_js_1 = __importDefault(require("./getTimeStamp.js"));
 const link_js_1 = require("./link.js");
@@ -21,11 +24,52 @@ const TAG_COLOR = {
     warn: "yellow",
     error: "red",
 };
+/** Visible width of the `└── ` branch; message lines left-align under it. */
+const MESSAGE_INDENT = "   ";
+/** Max message lines to show before collapsing the rest; 0 (default) shows all. */
+let visibleLines = 0;
+/** 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 = `${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 (multi-line strings, pretty-printed objects, error stacks) all 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${MESSAGE_INDENT}`), useColor);
+}
 /**
  * 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;
- * otherwise it's plain text. Pure (no stack access), so it can be called from a
- * helper without disturbing {@link getCaller}'s frame depth.
+ * OSC-8 hyperlinks, the location is a clickable link to the source file while
+ * the line stays visible in the label; otherwise it's plain text. Pure (no
+ * stack access), so it can be called from a helper without disturbing
+ * {@link getCaller}'s frame depth.
  */
 function formatLocation(caller, streamName) {
     if (caller.file !== null &&
@@ -48,12 +92,25 @@ function createLog(channel, tag) {
             return;
         const caller = (0, getCaller_js_1.default)();
         const location = formatLocation(caller, streamName);
-        // 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;
-        // `\n ` + console's own separator space => the message is indented 2 spaces
-        // on its own line below the metadata.
-        console[channel](tagOut, (0, getTimeStamp_js_1.default)(), `(${location})`, `\n `, ...args, `\n`);
+        // Colors (terminal only): tag by level, timestamp teal, location dim teal,
+        // branch and separator gray.
+        const useColor = (0, color_js_1.supportsColor)(streamName);
+        const tagOut = useColor ? (0, color_js_1.colorize)(tag, TAG_COLOR[channel]) : tag;
+        const timeStamp = useColor
+            ? (0, color_js_1.colorize)((0, getTimeStamp_js_1.default)(), "teal")
+            : (0, getTimeStamp_js_1.default)();
+        const locOut = useColor
+            ? (0, color_js_1.colorize)(`(${location})`, "dimTeal")
+            : `(${location})`;
+        const connector = useColor ? (0, color_js_1.colorize)("├──", "gray") : "└──";
+        const connectorBottom = useColor ? (0, color_js_1.colorize)("└──", "gray") : "└──";
+        const separator = useColor ? (0, color_js_1.colorize)("-", "gray") : "-";
+        // Layout: the tag, the message hanging off a `├──` branch, then the
+        // timestamp and location on a `└──` branch below.
+        const message = renderMessage(args, useColor);
+        const meta = `\n${connectorBottom} ${timeStamp} ${separator} ${locOut}`;
+        // Leading `\n` puts a blank line above each entry — in the same call and on
+        // the right stream (a separate `console.log` would always hit stdout).
+        console[channel](`\n${tagOut}`, `\n${connector}`, message, meta);
     };
 }

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

@@ -1,2 +1,6 @@
-/** Returns the current time as an ISO-8601 string, e.g. `2026-05-30T10:00:00.000Z`. */
-export default function getTimeStamp(): string;
+/**
+ * Returns a short local timestamp: month-day plus 12-hour time, e.g.
+ * `05-30 04:00:00 PM`. The year and timezone are dropped to keep log lines
+ * compact; date and time are both local so they stay consistent.
+ */
+export default function getTimeStamp(date?: Date): string;

package/dist/cjs/utils/getTimeStamp.js

@@ -7,7 +7,22 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.default = getTimeStamp;
-/** Returns the current time as an ISO-8601 string, e.g. `2026-05-30T10:00:00.000Z`. */
-function getTimeStamp() {
-    return new Date().toISOString();
+// Time-only 12-hour formatter (date is built separately, timezone is dropped).
+const TIME_FORMATTER = new Intl.DateTimeFormat("en-US", {
+    hour: "2-digit",
+    minute: "2-digit",
+    second: "2-digit",
+    hour12: true,
+});
+function pad(value) {
+    return String(value).padStart(2, "0");
+}
+/**
+ * Returns a short local timestamp: month-day plus 12-hour time, e.g.
+ * `05-30 04:00:00 PM`. The year and timezone are dropped to keep log lines
+ * compact; date and time are both local so they stay consistent.
+ */
+function getTimeStamp(date = new Date()) {
+    const datePart = `${pad(date.getMonth() + 1)}-${pad(date.getDate())}`;
+    return `${datePart} ${TIME_FORMATTER.format(date)}`;
 }

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

@@ -1,4 +1,4 @@
-export { default as createLog, type LogChannel } from "./createLog.js";
+export { default as createLog, getVisibleLines, setVisibleLines, 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";

package/dist/cjs/utils/index.js

@@ -9,9 +9,11 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.supportsColor = exports.colorize = 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.setVisibleLines = exports.getVisibleLines = 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; } });
+Object.defineProperty(exports, "getVisibleLines", { enumerable: true, get: function () { return createLog_js_1.getVisibleLines; } });
+Object.defineProperty(exports, "setVisibleLines", { enumerable: true, get: function () { return createLog_js_1.setVisibleLines; } });
 var getCaller_js_1 = require("./getCaller.js");
 Object.defineProperty(exports, "getCaller", { enumerable: true, get: function () { return __importDefault(getCaller_js_1).default; } });
 var getTimeStamp_js_1 = require("./getTimeStamp.js");

package/dist/index.d.ts

@@ -3,15 +3,12 @@ export interface LogFN {
     (...args: unknown[]): void;
     error(...args: unknown[]): void;
     warn(...args: unknown[]): void;
+    /**
+     * How many lines of a multi-line message to show before collapsing the rest
+     * into a `… N more lines` summary. `0` (the default) shows everything.
+     */
+    maxLines: number;
 }
-/**
- * Logs to the console, but only outside production. Each line is prefixed with
- * a level tag, an ISO timestamp, and a clickable link to the file and line it
- * was called from; all arguments are then printed as-is.
- * @example
- * customLog("Auth", "user logged in")
- * // [INFO] 2026-05-30T10:00:00.000Z (server.ts:42) Auth user logged in
- */
 declare const customLog: LogFN;
 export { customLog };
 export default customLog;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AASA,gFAAgF;AAChF,MAAM,WAAW,KAAK;IACpB,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;IAC1B,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;IAC/B,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;CAC/B;AAED;;;;;;;GAOG;AACH,QAAA,MAAM,SAAS,EAAE,KAGf,CAAA;AAEF,OAAO,EAAE,SAAS,EAAE,CAAA;AACpB,eAAe,SAAS,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AASA,gFAAgF;AAChF,MAAM,WAAW,KAAK;IACpB,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;IAC1B,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;IAC/B,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;IAC9B;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAA;CACjB;AA0BD,QAAA,MAAM,SAAS,EAAa,KAAK,CAAA;AAEjC,OAAO,EAAE,SAAS,EAAE,CAAA;AACpB,eAAe,SAAS,CAAA"}

package/dist/index.js

@@ -4,19 +4,30 @@
  * Copyright (c) 2026 dewan-meadown
  * All rights reserved
  */
-import { createLog } from "./utils/index.js";
+import { createLog, getVisibleLines, setVisibleLines } from "./utils/index.js";
 /**
  * Logs to the console, but only outside production. Each line is prefixed with
- * a level tag, an ISO timestamp, and a clickable link to the file and line it
- * was called from; all arguments are then printed as-is.
+ * a level tag, a short local timestamp, and a clickable link to the file it was
+ * called from; all arguments are then printed as-is.
  * @example
  * customLog("Auth", "user logged in")
- * // [INFO] 2026-05-30T10:00:00.000Z (server.ts:42) Auth user logged in
+ * // [INFO] 05-30 04:00:00 PM (server.ts:42) Auth user logged in
+ * @example
+ * customLog.maxLines = 5 // long messages collapse to 5 lines; 0 = show all
  */
-const customLog = Object.assign(createLog("log", "[INFO]"), {
+const logger = Object.assign(createLog("log", "[INFO]"), {
     error: createLog("error", "[ERROR]"),
     warn: createLog("warn", "[WARN]"),
 });
+// `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: getVisibleLines,
+    set: setVisibleLines,
+    enumerable: true,
+    configurable: true,
+});
+const customLog = logger;
 export { customLog };
 export default customLog;
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAS5C;;;;;;;GAOG;AACH,MAAM,SAAS,GAAU,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE;IACjE,KAAK,EAAE,SAAS,CAAC,OAAO,EAAE,SAAS,CAAC;IACpC,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,QAAQ,CAAC;CAClC,CAAC,CAAA;AAEF,OAAO,EAAE,SAAS,EAAE,CAAA;AACpB,eAAe,SAAS,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAc9E;;;;;;;;;GASG;AACH,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE;IACvD,KAAK,EAAE,SAAS,CAAC,OAAO,EAAE,SAAS,CAAC;IACpC,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,QAAQ,CAAC;CAClC,CAAC,CAAA;AAEF,+EAA+E;AAC/E,uDAAuD;AACvD,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,UAAU,EAAE;IACxC,GAAG,EAAE,eAAe;IACpB,GAAG,EAAE,eAAe;IACpB,UAAU,EAAE,IAAI;IAChB,YAAY,EAAE,IAAI;CACnB,CAAC,CAAA;AAEF,MAAM,SAAS,GAAG,MAAe,CAAA;AAEjC,OAAO,EAAE,SAAS,EAAE,CAAA;AACpB,eAAe,SAAS,CAAA"}

package/dist/utils/color.d.ts

@@ -3,7 +3,9 @@ declare const CODES: {
     readonly red: 31;
     readonly yellow: 33;
     readonly cyan: 36;
-    readonly dim: 2;
+    readonly gray: 90;
+    readonly teal: "38;5;30";
+    readonly dimTeal: "38;5;23";
 };
 /** The named colors/styles {@link colorize} understands. */
 export type Color = keyof typeof CODES;

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

@@ -1 +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"}
+{"version":3,"file":"color.d.ts","sourceRoot":"","sources":["../../src/utils/color.ts"],"names":[],"mappings":"AAOA,4DAA4D;AAC5D,QAAA,MAAM,KAAK;;;;;;;CAOD,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

@@ -9,7 +9,9 @@ const CODES = {
     red: 31,
     yellow: 33,
     cyan: 36,
-    dim: 2,
+    gray: 90, // bright black — renders as light gray
+    teal: "38;5;30", // 256-color teal (#008787)
+    dimTeal: "38;5;23", // 256-color darker teal (#005f5f)
 };
 const RESET = "\x1b[0m";
 /**

package/dist/utils/color.js.map

@@ -1 +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"}
+{"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,IAAI,EAAE,EAAE,EAAE,uCAAuC;IACjD,IAAI,EAAE,SAAS,EAAE,2BAA2B;IAC5C,OAAO,EAAE,SAAS,EAAE,kCAAkC;CAC9C,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

@@ -1,5 +1,9 @@
 /** The console channels the logger writes to. */
 export type LogChannel = "log" | "error" | "warn";
+/** 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;
 /**
  * Builds a log function bound to a console channel and tag. The returned closure
  * is what the caller invokes directly, so {@link getCaller} still resolves the

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

@@ -1 +1 @@
-{"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,CAgB9B"}
+{"version":3,"file":"createLog.d.ts","sourceRoot":"","sources":["../../src/utils/createLog.ts"],"names":[],"mappings":"AAeA,iDAAiD;AACjD,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,OAAO,GAAG,MAAM,CAAA;AAejD,uEAAuE;AACvE,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,2EAA2E;AAC3E,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAEnD;AAkDD;;;;;;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,CA8B9B"}

package/dist/utils/createLog.js

@@ -4,6 +4,7 @@
  * Copyright (c) 2026 dewan-meadown
  * All rights reserved
  */
+import { formatWithOptions } from "node:util";
 import getCaller from "./getCaller.js";
 import getTimeStamp from "./getTimeStamp.js";
 import { fileUrl, hyperlink, supportsHyperlinks } from "./link.js";
@@ -15,11 +16,52 @@ const TAG_COLOR = {
     warn: "yellow",
     error: "red",
 };
+/** Visible width of the `└── ` branch; message lines left-align under it. */
+const MESSAGE_INDENT = "   ";
+/** Max message lines to show before collapsing the rest; 0 (default) shows all. */
+let visibleLines = 0;
+/** 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 (multi-line strings, pretty-printed objects, error stacks) all 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${MESSAGE_INDENT}`), useColor);
+}
 /**
  * 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;
- * otherwise it's plain text. Pure (no stack access), so it can be called from a
- * helper without disturbing {@link getCaller}'s frame depth.
+ * OSC-8 hyperlinks, the location is a clickable link to the source file while
+ * the line stays visible in the label; otherwise it's plain text. Pure (no
+ * stack access), so it can be called from a helper without disturbing
+ * {@link getCaller}'s frame depth.
  */
 function formatLocation(caller, streamName) {
     if (caller.file !== null &&
@@ -42,13 +84,26 @@ export default function createLog(channel, tag) {
             return;
         const caller = getCaller();
         const location = formatLocation(caller, streamName);
-        // Color only the level tag, and only on a real terminal.
-        const tagOut = supportsColor(streamName)
-            ? colorize(tag, TAG_COLOR[channel])
-            : tag;
-        // `\n ` + console's own separator space => the message is indented 2 spaces
-        // on its own line below the metadata.
-        console[channel](tagOut, getTimeStamp(), `(${location})`, `\n `, ...args, `\n`);
+        // Colors (terminal only): tag by level, timestamp teal, location dim teal,
+        // branch and separator gray.
+        const useColor = supportsColor(streamName);
+        const tagOut = useColor ? colorize(tag, TAG_COLOR[channel]) : tag;
+        const timeStamp = useColor
+            ? colorize(getTimeStamp(), "teal")
+            : getTimeStamp();
+        const locOut = useColor
+            ? colorize(`(${location})`, "dimTeal")
+            : `(${location})`;
+        const connector = useColor ? colorize("├──", "gray") : "└──";
+        const connectorBottom = useColor ? colorize("└──", "gray") : "└──";
+        const separator = useColor ? colorize("-", "gray") : "-";
+        // Layout: the tag, the message hanging off a `├──` branch, then the
+        // timestamp and location on a `└──` branch below.
+        const message = renderMessage(args, useColor);
+        const meta = `\n${connectorBottom} ${timeStamp} ${separator} ${locOut}`;
+        // Leading `\n` puts a blank line above each entry — in the same call and on
+        // the right stream (a separate `console.log` would always hit stdout).
+        console[channel](`\n${tagOut}`, `\n${connector}`, message, meta);
     };
 }
 //# 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,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,4EAA4E;QAC5E,sCAAsC;QACtC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,YAAY,EAAE,EAAE,IAAI,QAAQ,GAAG,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,IAAI,CAAC,CAAA;IACjF,CAAC,CAAA;AACH,CAAC"}
+{"version":3,"file":"createLog.js","sourceRoot":"","sources":["../../src/utils/createLog.ts"],"names":[],"mappings":"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"}

package/dist/utils/getTimeStamp.d.ts

@@ -1,3 +1,7 @@
-/** Returns the current time as an ISO-8601 string, e.g. `2026-05-30T10:00:00.000Z`. */
-export default function getTimeStamp(): string;
+/**
+ * Returns a short local timestamp: month-day plus 12-hour time, e.g.
+ * `05-30 04:00:00 PM`. The year and timezone are dropped to keep log lines
+ * compact; date and time are both local so they stay consistent.
+ */
+export default function getTimeStamp(date?: Date): string;
 //# sourceMappingURL=getTimeStamp.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"getTimeStamp.d.ts","sourceRoot":"","sources":["../../src/utils/getTimeStamp.ts"],"names":[],"mappings":"AAOA,uFAAuF;AACvF,MAAM,CAAC,OAAO,UAAU,YAAY,IAAI,MAAM,CAE7C"}
+{"version":3,"file":"getTimeStamp.d.ts","sourceRoot":"","sources":["../../src/utils/getTimeStamp.ts"],"names":[],"mappings":"AAmBA;;;;GAIG;AACH,MAAM,CAAC,OAAO,UAAU,YAAY,CAAC,IAAI,OAAa,GAAG,MAAM,CAG9D"}

package/dist/utils/getTimeStamp.js

@@ -4,8 +4,23 @@
  * Copyright (c) 2026 dewan-meadown
  * All rights reserved
  */
-/** Returns the current time as an ISO-8601 string, e.g. `2026-05-30T10:00:00.000Z`. */
-export default function getTimeStamp() {
-    return new Date().toISOString();
+// Time-only 12-hour formatter (date is built separately, timezone is dropped).
+const TIME_FORMATTER = new Intl.DateTimeFormat("en-US", {
+    hour: "2-digit",
+    minute: "2-digit",
+    second: "2-digit",
+    hour12: true,
+});
+function pad(value) {
+    return String(value).padStart(2, "0");
+}
+/**
+ * Returns a short local timestamp: month-day plus 12-hour time, e.g.
+ * `05-30 04:00:00 PM`. The year and timezone are dropped to keep log lines
+ * compact; date and time are both local so they stay consistent.
+ */
+export default function getTimeStamp(date = new Date()) {
+    const datePart = `${pad(date.getMonth() + 1)}-${pad(date.getDate())}`;
+    return `${datePart} ${TIME_FORMATTER.format(date)}`;
 }
 //# sourceMappingURL=getTimeStamp.js.map

package/dist/utils/getTimeStamp.js.map

@@ -1 +1 @@
-{"version":3,"file":"getTimeStamp.js","sourceRoot":"","sources":["../../src/utils/getTimeStamp.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,uFAAuF;AACvF,MAAM,CAAC,OAAO,UAAU,YAAY;IAClC,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;AACjC,CAAC"}
+{"version":3,"file":"getTimeStamp.js","sourceRoot":"","sources":["../../src/utils/getTimeStamp.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,+EAA+E;AAC/E,MAAM,cAAc,GAAG,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE;IACtD,IAAI,EAAE,SAAS;IACf,MAAM,EAAE,SAAS;IACjB,MAAM,EAAE,SAAS;IACjB,MAAM,EAAE,IAAI;CACb,CAAC,CAAA;AAEF,SAAS,GAAG,CAAC,KAAa;IACxB,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;AACvC,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,OAAO,UAAU,YAAY,CAAC,IAAI,GAAG,IAAI,IAAI,EAAE;IACpD,MAAM,QAAQ,GAAG,GAAG,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,CAAA;IACrE,OAAO,GAAG,QAAQ,IAAI,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAA;AACrD,CAAC"}

package/dist/utils/index.d.ts

@@ -1,4 +1,4 @@
-export { default as createLog, type LogChannel } from "./createLog.js";
+export { default as createLog, getVisibleLines, setVisibleLines, 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";

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;AAClE,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,KAAK,KAAK,EAAE,MAAM,YAAY,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,OAAO,IAAI,SAAS,EACpB,eAAe,EACf,eAAe,EACf,KAAK,UAAU,GAChB,MAAM,gBAAgB,CAAA;AACvB,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

@@ -4,7 +4,7 @@
  * Copyright (c) 2026 dewan-meadown
  * All rights reserved
  */
-export { default as createLog } from "./createLog.js";
+export { default as createLog, getVisibleLines, setVisibleLines, } from "./createLog.js";
 export { default as getCaller } from "./getCaller.js";
 export { default as getTimeStamp } from "./getTimeStamp.js";
 export { fileUrl, hyperlink, supportsHyperlinks } from "./link.js";

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;AAClE,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAc,MAAM,YAAY,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,OAAO,IAAI,SAAS,EACpB,eAAe,EACf,eAAe,GAEhB,MAAM,gBAAgB,CAAA;AACvB,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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meadown/logger",
-  "version": "1.3.1",
+  "version": "1.5.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",
@@ -52,6 +52,7 @@
     "test": "tsc && node --test \"test/**/*.test.mjs\"",
     "lint": "eslint src",
     "lint:fix": "eslint src --fix",
+    "demo": "pnpm build && node examples/demo.mjs",
     "prepublishOnly": "pnpm run lint && pnpm test && pnpm run build",
     "prepare": "husky",
     "release": "semantic-release"