@meadown/logger 1.3.1 → 1.4.0

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] 2026-05-30 04:00:00 PM GMT+6 (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.
+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.
 
 ### 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

package/dist/cjs/index.d.ts

@@ -6,11 +6,11 @@ export interface LogFN {
 }
 /**
  * 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 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-30T10:00:00.000Z (server.ts:42) 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 };

package/dist/cjs/index.js

@@ -10,11 +10,11 @@ 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 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-30T10:00:00.000Z (server.ts:42) Auth user logged in
+ * // [INFO] 2026-05-30 04:00:00 PM GMT+6 (server.ts:42) Auth user logged in
  */
 const customLog = Object.assign((0, index_js_1.createLog)("log", "[INFO]"), {
     error: (0, index_js_1.createLog)("error", "[ERROR]"),

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

@@ -3,6 +3,7 @@ declare const CODES: {
     readonly red: 31;
     readonly yellow: 33;
     readonly cyan: 36;
+    readonly gray: 90;
     readonly dim: 2;
 };
 /** The named colors/styles {@link colorize} understands. */

package/dist/cjs/utils/color.js

@@ -13,6 +13,7 @@ const CODES = {
     red: 31,
     yellow: 33,
     cyan: 36,
+    gray: 90, // bright black — renders as light gray
     dim: 2,
 };
 const RESET = "\x1b[0m";

package/dist/cjs/utils/createLog.js

@@ -23,9 +23,10 @@ const TAG_COLOR = {
 };
 /**
  * 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 +49,15 @@ 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`);
+        // On a real terminal: color the level tag and the `└──` connector (same
+        // color), and dim the location to gray. The timestamp stays plain.
+        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`);
     };
 }

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 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.
+ */
+export default function getTimeStamp(date?: Date): string;

package/dist/cjs/utils/getTimeStamp.js

@@ -7,7 +7,23 @@
  */
 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 formatter (date is built separately so it stays ISO `YYYY-MM-DD`).
+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.
+ */
+function getTimeStamp(date = new Date()) {
+    const datePart = `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())}`;
+    return `${datePart} ${TIME_FORMATTER.format(date)}`;
 }

package/dist/index.d.ts

@@ -6,11 +6,11 @@ export interface LogFN {
 }
 /**
  * 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 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-30T10:00:00.000Z (server.ts:42) 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 };

package/dist/index.js

@@ -7,11 +7,11 @@
 import { createLog } 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 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-30T10:00:00.000Z (server.ts:42) Auth user logged in
+ * // [INFO] 2026-05-30 04:00:00 PM GMT+6 (server.ts:42) Auth user logged in
  */
 const customLog = Object.assign(createLog("log", "[INFO]"), {
     error: createLog("error", "[ERROR]"),

package/dist/utils/color.d.ts

@@ -3,6 +3,7 @@ declare const CODES: {
     readonly red: 31;
     readonly yellow: 33;
     readonly cyan: 36;
+    readonly gray: 90;
     readonly dim: 2;
 };
 /** The named colors/styles {@link colorize} understands. */

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;;;;;;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"}

package/dist/utils/color.js

@@ -9,6 +9,7 @@ const CODES = {
     red: 31,
     yellow: 33,
     cyan: 36,
+    gray: 90, // bright black — renders as light gray
     dim: 2,
 };
 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,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":"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":"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"}

package/dist/utils/createLog.js

@@ -17,9 +17,10 @@ const TAG_COLOR = {
 };
 /**
  * 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 +43,16 @@ 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`);
+        // On a real terminal: color the level tag and the `└──` connector (same
+        // color), and dim the location to gray. The timestamp stays plain.
+        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`);
     };
 }
 //# 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":"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"}

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 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.
+ */
+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":"AAoBA;;;;GAIG;AACH,MAAM,CAAC,OAAO,UAAU,YAAY,CAAC,IAAI,OAAa,GAAG,MAAM,CAG9D"}

package/dist/utils/getTimeStamp.js

@@ -4,8 +4,24 @@
  * 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 formatter (date is built separately so it stays ISO `YYYY-MM-DD`).
+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.
+ */
+export default function getTimeStamp(date = new Date()) {
+    const datePart = `${date.getFullYear()}-${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;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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meadown/logger",
-  "version": "1.3.1",
+  "version": "1.4.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",