@ztimson/utils 0.27.4 → 0.27.6

package/dist/logger.d.ts

@@ -37,6 +37,7 @@ export declare const CliBackground: {
     WHITE: string;
     GREY: string;
 };
+export type LogLevels = 'debug' | 'log' | 'info' | 'warn' | 'error';
 export declare enum LOG_LEVEL {
     ERROR = 0,
     WARN = 1,

package/dist/misc.d.ts

@@ -1,3 +1,4 @@
+import { LogLevels } from './logger.ts';
 import { PathEvent } from './path-events.ts';
 /**
  * Compare version numbers
@@ -6,6 +7,29 @@ import { PathEvent } from './path-events.ts';
  * @return {number} -1 = target is lower, 0 = equal, 1 = higher
  */
 export declare function compareVersions(target: string, vs: string): -1 | 0 | 1;
+/**
+ * Create a console object to intercept logs with optional passthrough
+ * @param {null | {debug: Function, log: Function, info: Function, warn: Function, error: Function}} out Passthrough logs, null to silence
+ * @param {{[K in LogLevels]?: LogLevels | "none"}} map Map log levels: {log: 'debug', warn: 'error'} = Suppress debug logs, elevate warnings
+ * @returns {{debug: Function, log: Function, info: Function, warn: Function, error: Function, stderr: string[], stdout: string[]}}
+ */
+export declare function consoleInterceptor(out?: null | {
+    debug: Function;
+    log: Function;
+    info: Function;
+    warn: Function;
+    error: Function;
+}, map?: {
+    [K in LogLevels]?: LogLevels | 'none';
+}): {
+    debug: Function;
+    log: Function;
+    info: Function;
+    warn: Function;
+    error: Function;
+    stderr: string[];
+    stdout: string[];
+};
 /**
  * Escape any regex special characters to avoid misinterpretation during search
  * @param {string} value String which should be escaped

package/dist/time.d.ts

@@ -10,6 +10,50 @@ export declare function dayOfYear(date: Date): number;
 /**
  * Format date
  *
+ * Year:
+ * - YYYY = 2025 (4-digit year)
+ * - YY = 25 (2-digit year)
+ *
+ * Month:
+ * - MMMM = January (full month name)
+ * - MMM = Jan (abbreviated month name)
+ * - MM = 01 (zero-padded month number)
+ * - M = 1 (month number)
+ *
+ * Day:
+ * - DDD = 123 (day of year)
+ * - DD = 01 (zero-padded day)
+ * - Do = 1st (day with ordinal suffix)
+ * - D = 1 (day number)
+ * - dddd = Monday (full day name)
+ * - ddd = Mon (abbreviated day name)
+ *
+ * Hour:
+ * - HH = 13 (24-hour format, zero-padded)
+ * - H = 13 (24-hour format)
+ * - hh = 01 (12-hour format, zero-padded)
+ * - h = 1 (12-hour format)
+ *
+ * Minute:
+ * - mm = 05 (zero-padded minutes)
+ * - m = 5 (minutes)
+ *
+ * Second:
+ * - ss = 09 (zero-padded seconds)
+ * - s = 9 (seconds)
+ *
+ * Millisecond:
+ * - SSS = 123 (3-digit milliseconds)
+ *
+ * AM/PM:
+ * - A = AM/PM (uppercase)
+ * - a = am/pm (lowercase)
+ *
+ * Timezone:
+ * - ZZ = +0500 (timezone offset without colon)
+ * - Z = +05:00 (timezone offset with colon)
+ * - z = EST (timezone abbreviation)
+ *
  * @param {string} format How date string will be formatted, default: `YYYY-MM-DD H:mm A`
  * @param {Date | number | string} date Date or timestamp, defaults to now
  * @param tz Set timezone offset

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@ztimson/utils",
-	"version": "0.27.4",
+	"version": "0.27.6",
 	"description": "Utility library",
 	"author": "Zak Timson",
 	"license": "MIT",