@meadown/logger 1.4.0 → 1.5.1

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

@@ -14,7 +14,11 @@ No dependencies. No config. Import it and you're done.
 ## Install
 
 ```bash
+pnpm add @meadown/logger
+# or
 npm install @meadown/logger
+# or
+yarn add @meadown/logger
 ```
 
 ## Using it
@@ -32,14 +36,15 @@ customLog.error("Something went wrong")
 You'll see something like:
 
 ```text
-[INFO] 2026-05-30 04:00:00 PM GMT+6 (server.ts:42)
-└── Auth user logged in
+[INFO]
+├── Auth user logged in
+└── 05-30 04:00:00 PM - (server.ts:42)
 ```
 
-The first line carries the level tag — `[INFO]`, `[WARN]`, or `[ERROR]` — the
-local timestamp with AM/PM and timezone, 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.
+Each entry is a little tree: the level tag — `[INFO]`, `[WARN]`, or `[ERROR]` — on
+top, your message hanging off a `├──` branch, and a short local timestamp
+(month-day, 12-hour time) plus the source location on the `└──` branch below.
+Entries are spaced apart by a blank line so they're easy to scan in a busy terminal.
 
 ### One thing if you re-export it
 
@@ -59,12 +64,13 @@ 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 `(file:line)` location is dimmed to
-light gray so it stays out of the way, and the timestamp is left plain.
+cyan, `[WARN]` in yellow, `[ERROR]` in red. The timestamp and source location are
+tinted teal, and the tree branches sit in a quiet gray, so the colored level tag is
+what your eye lands on first.
 
 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.
+file or another program, everything prints as plain text — no stray color codes in
+your log files. Nothing to configure.
 
 ## Click to open the source
 
@@ -78,6 +84,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
@@ -92,6 +114,14 @@ developing and go silent in production. The only thing that flips the switch is
 So leave your logs in the code. Once you ship with `NODE_ENV=production`, they just
 quietly step aside.
 
+## Security
+
+It's a tiny, zero-dependency package with no file, network, or dynamic-code access.
+See [SECURITY.md](https://github.com/meadown/meadown-logger/blob/main/SECURITY.md)
+for the security model and how to report a vulnerability. One thing to know: like
+`console.log`, log arguments are written to the terminal as-is and are not
+sanitized — don't log untrusted data to a terminal you trust.
+
 ## License
 
-MIT © Dewan Mobashirul
+MIT © meadown

package/SECURITY.md

@@ -0,0 +1,50 @@
+# Security Policy
+
+## Reporting a vulnerability
+
+Please report security issues **privately** by email to
+[inbox.meadown@gmail.com](mailto:inbox.meadown@gmail.com).
+
+Include a description, the affected version, and steps to reproduce. We aim to
+acknowledge reports within a few days and to coordinate a fix and disclosure.
+
+> Once this repository is public, reports can also be filed via GitHub Security
+> Advisories ("Report a vulnerability" under the Security tab).
+
+## Supported versions
+
+Only the latest published `@meadown/logger` release receives security fixes.
+
+## Security model
+
+`@meadown/logger` is intentionally minimal, which keeps its attack surface small:
+
+- **Zero runtime dependencies.** Installing the package pulls in no transitive
+  packages, so there is no third-party supply-chain surface to inherit.
+- **No I/O or dynamic execution.** It does not read or write files, open network
+  connections, spawn processes, or use `eval`/`Function`. It only writes to the
+  console and reads `process.env.NODE_ENV` (to stay quiet in production).
+- **Nothing is persisted.** Log output is never written to disk, so the logger
+  cannot leak logged data to a temp file or similar.
+
+## Trust boundary: log arguments are output, not input
+
+Like `console.log` itself, this logger passes the arguments you give it through
+to the terminal as output. **It does not sanitize them.**
+
+If you log **untrusted data** (user input, third-party API responses, etc.) that
+contains terminal control or escape sequences (ANSI `\x1b[…`, OSC-8 hyperlinks,
+carriage returns), those sequences reach the terminal and can manipulate it —
+e.g. overwrite previously printed text or spoof a clickable link. This is an
+inherent property of writing untrusted text to a terminal, not specific to this
+package.
+
+Guidance:
+
+- Treat log output as you would any other untrusted text rendered in a terminal.
+- Do not log raw untrusted input to a terminal or log stream you treat as
+  trusted; sanitize or encode it first if that is a concern in your environment.
+
+The clickable source link the logger emits is built from the runtime call
+stack's file path (encoded via `node:url`'s `pathToFileURL`), not from your
+arguments, so the logger's own escape sequences are not attacker-influenced.

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, a local AM/PM timestamp with timezone, 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-30 04:00:00 PM GMT+6 (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, a local AM/PM timestamp with timezone, and a clickable link to
- * the file 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-30 04:00:00 PM GMT+6 (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

@@ -4,7 +4,8 @@ declare const CODES: {
     readonly yellow: 33;
     readonly cyan: 36;
     readonly gray: 90;
-    readonly dim: 2;
+    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

@@ -14,7 +14,8 @@ const CODES = {
     yellow: 33,
     cyan: 36,
     gray: 90, // bright black — renders as light gray
-    dim: 2,
+    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,6 +24,46 @@ 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 source file while
@@ -49,15 +92,25 @@ function createLog(channel, tag) {
             return;
         const caller = (0, getCaller_js_1.default)();
         const location = formatLocation(caller, streamName);
-        // On a real terminal: color the level tag and the `└──` connector (same
-        // color), and dim the location to gray. The timestamp stays plain.
+        // Colors (terminal only): tag by level, timestamp teal, location dim teal,
+        // branch and separator gray.
         const useColor = (0, color_js_1.supportsColor)(streamName);
-        const color = TAG_COLOR[channel];
-        const tagOut = useColor ? (0, color_js_1.colorize)(tag, color) : tag;
-        const locOut = useColor ? (0, color_js_1.colorize)(`(${location})`, "gray") : `(${location})`;
-        const connector = useColor ? (0, color_js_1.colorize)("└──", color) : "└──";
-        // `\n` + connector puts the message on its own line under a tree branch;
-        // console's separator space sits between the connector and the message.
-        console[channel](tagOut, (0, getTimeStamp_js_1.default)(), locOut, `\n${connector}`, ...args, `\n`);
+        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,6 +1,6 @@
 /**
- * Returns local time as an ISO date plus a readable AM/PM time and timezone,
- * e.g. `2026-05-29 04:00:00 PM GMT+6`. The date and time are both local, so they
- * stay consistent.
+ * 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,23 +7,22 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.default = getTimeStamp;
-// Time-only formatter (date is built separately so it stays ISO `YYYY-MM-DD`).
+// 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,
-    timeZoneName: "short",
 });
 function pad(value) {
     return String(value).padStart(2, "0");
 }
 /**
- * Returns local time as an ISO date plus a readable AM/PM time and timezone,
- * e.g. `2026-05-29 04:00:00 PM GMT+6`. The date and time are both local, so they
- * stay consistent.
+ * 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 = `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())}`;
+    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, a local AM/PM timestamp with timezone, 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-30 04:00:00 PM GMT+6 (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, a local AM/PM timestamp with timezone, and a clickable link to
- * the file 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-30 04:00:00 PM GMT+6 (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

@@ -4,7 +4,8 @@ declare const CODES: {
     readonly yellow: 33;
     readonly cyan: 36;
     readonly gray: 90;
-    readonly dim: 2;
+    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;;;;;;CAMD,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

@@ -10,7 +10,8 @@ const CODES = {
     yellow: 33,
     cyan: 36,
     gray: 90, // bright black — renders as light gray
-    dim: 2,
+    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,IAAI,EAAE,EAAE,EAAE,uCAAuC;IACjD,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;AA6BjD;;;;;;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,CAmB9B"}
+{"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,6 +16,46 @@ 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 source file while
@@ -43,16 +84,26 @@ export default function createLog(channel, tag) {
             return;
         const caller = getCaller();
         const location = formatLocation(caller, streamName);
-        // On a real terminal: color the level tag and the `└──` connector (same
-        // color), and dim the location to gray. The timestamp stays plain.
+        // Colors (terminal only): tag by level, timestamp teal, location dim teal,
+        // branch and separator gray.
         const useColor = supportsColor(streamName);
-        const color = TAG_COLOR[channel];
-        const tagOut = useColor ? colorize(tag, color) : tag;
-        const locOut = useColor ? colorize(`(${location})`, "gray") : `(${location})`;
-        const connector = useColor ? colorize("└──", color) : "└──";
-        // `\n` + connector puts the message on its own line under a tree branch;
-        // console's separator space sits between the connector and the message.
-        console[channel](tagOut, getTimeStamp(), locOut, `\n${connector}`, ...args, `\n`);
+        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;;;;;;GAMG;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,wEAAwE;QACxE,mEAAmE;QACnE,MAAM,QAAQ,GAAG,aAAa,CAAC,UAAU,CAAC,CAAA;QAC1C,MAAM,KAAK,GAAG,SAAS,CAAC,OAAO,CAAC,CAAA;QAChC,MAAM,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAA;QACpD,MAAM,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,QAAQ,GAAG,CAAA;QAC7E,MAAM,SAAS,GAAG,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAA;QAE3D,yEAAyE;QACzE,wEAAwE;QACxE,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,YAAY,EAAE,EAAE,MAAM,EAAE,KAAK,SAAS,EAAE,EAAE,GAAG,IAAI,EAAE,IAAI,CAAC,CAAA;IACnF,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,7 +1,7 @@
 /**
- * Returns local time as an ISO date plus a readable AM/PM time and timezone,
- * e.g. `2026-05-29 04:00:00 PM GMT+6`. The date and time are both local, so they
- * stay consistent.
+ * 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":"AAoBA;;;;GAIG;AACH,MAAM,CAAC,OAAO,UAAU,YAAY,CAAC,IAAI,OAAa,GAAG,MAAM,CAG9D"}
+{"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,24 +4,23 @@
  * Copyright (c) 2026 dewan-meadown
  * All rights reserved
  */
-// Time-only formatter (date is built separately so it stays ISO `YYYY-MM-DD`).
+// 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,
-    timeZoneName: "short",
 });
 function pad(value) {
     return String(value).padStart(2, "0");
 }
 /**
- * Returns local time as an ISO date plus a readable AM/PM time and timezone,
- * e.g. `2026-05-29 04:00:00 PM GMT+6`. The date and time are both local, so they
- * stay consistent.
+ * 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 = `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())}`;
+    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,+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;IACZ,YAAY,EAAE,OAAO;CACtB,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,IAAI,CAAC,WAAW,EAAE,IAAI,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,CAAA;IAC3F,OAAO,GAAG,QAAQ,IAAI,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAA;AACrD,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.4.0",
+  "version": "1.5.1",
   "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",
@@ -39,7 +39,8 @@
     }
   },
   "files": [
-    "dist"
+    "dist",
+    "SECURITY.md"
   ],
   "engines": {
     "node": ">=18"
@@ -52,6 +53,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"