@gesslar/toolkit 2.3.1 → 2.4.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gesslar/toolkit",
-  "version": "2.3.1",
+  "version": "2.4.0",
   "description": "A collection of utilities for Node.js and browser environments.",
   "main": "./src/index.js",
   "type": "module",

package/src/browser/lib/Util.js

@@ -139,8 +139,11 @@ export default class Util {
    * @param {Array<object>} rejected - Array of rejected results.
    * @throws {Error} Throws a Tantrum error with rejection reasons.
    */
-  static throwRejected(message="GIGO", rejected) {
-    throw Tantrum.new(message, this.rejectedReasons(rejected))
+  static throwRejected(message="GIGO", settled) {
+    throw Tantrum.new(
+      message,
+      this.rejectedReasons(this.settledAndRejected(settled))
+    )
   }
 
   /**

package/src/lib/Glog.js

@@ -63,6 +63,7 @@ class Glog {
 
   constructor(options = {}) {
     this.setOptions(options)
+    this.constructor.name = "Glog"
 
     // VSCode integration if specified
     if(options.env === "extension") {
@@ -125,7 +126,7 @@ class Glog {
   // === FLUENT INSTANCE CREATION ===
 
   static create(options = {}) {
-    return new Glog(options)
+    return new this(options)
   }
 
   withName(name) {
@@ -354,6 +355,64 @@ class Glog {
     Term.log(c`[${this.name || "Log"}] {success}Success{/}: ${message}`, ...args)
   }
 
+  /**
+   * Display tabular data as a table
+   *
+   * @param {object | Array} data - Object or array to display
+   * @param {string | object} [labelOrOptions] - Optional label (string) or options (object)
+   * @param {object} [options] - Optional options when label is provided
+   * @param {Array<string>} [options.properties] - Column properties to display
+   * @param {boolean} [options.showHeader=false] - Whether to show the header row
+   * @param {boolean} [options.quotedStrings=false] - Whether to show quotes around strings
+   */
+  table(data, labelOrOptions, options) {
+    let label
+    let tableOptions = {}
+
+    // Parse polymorphic parameters
+    if(typeof labelOrOptions === "string") {
+      label = labelOrOptions
+      tableOptions = options || {}
+    } else if(typeof labelOrOptions === "object" && labelOrOptions !== null) {
+      tableOptions = labelOrOptions
+    }
+
+    if(label) {
+      Term.log(c`[${this.#name || Glog.name || "Log"}] {info}Table{/}: ${label}`)
+    }
+
+    Term.table(data, tableOptions)
+  }
+
+  /**
+   * Static table method
+   *
+   * @param {object | Array} data - Object or array to display
+   * @param {string | object} [labelOrOptions] - Optional label (string) or options (object)
+   * @param {object} [options] - Optional options when label is provided
+   * @param {Array<string>} [options.properties] - Column properties to display
+   * @param {boolean} [options.showHeader=false] - Whether to show the header row
+   * @param {boolean} [options.quotedStrings=false] - Whether to show quotes around strings
+   */
+  static table(data, labelOrOptions, options) {
+    let label
+    let tableOptions = {}
+
+    // Parse polymorphic parameters
+    if(typeof labelOrOptions === "string") {
+      label = labelOrOptions
+      tableOptions = options || {}
+    } else if(typeof labelOrOptions === "object" && labelOrOptions !== null) {
+      tableOptions = labelOrOptions
+    }
+
+    if(label) {
+      Term.log(c`[${this.name || "Log"}] {info}Table{/}: ${label}`)
+    }
+
+    Term.table(data, tableOptions)
+  }
+
   /**
    * Set a color alias for convenient usage
    *

package/src/lib/Term.js

@@ -1,5 +1,7 @@
 import console from "node:console"
 import process from "node:process"
+import {Console} from "node:console"
+import {Writable} from "node:stream"
 
 import Sass from "./Sass.js"
 
@@ -65,6 +67,75 @@ export default class Term {
     console.groupEnd()
   }
 
+  /**
+   * Display tabular data as a table.
+   *
+   * @param {object | Array} tabularData - Object or array to display.
+   * @param {object} [options] - Table options.
+   * @param {Array<string>} [options.properties] - Optional column properties to display.
+   * @param {boolean} [options.showHeader=false] - Whether to show the header row with column names.
+   * @param {boolean} [options.quotedStrings=false] - Whether to show quotes around strings.
+   */
+  static table(tabularData, options = {}) {
+    const {properties, showHeader = false, quotedStrings = false} = options
+
+    if(showHeader && quotedStrings) {
+      // Simple case: use default console.table
+      console.table(tabularData, properties)
+
+      return
+    }
+
+    // Capture console.table output
+    let output = ""
+    const stream = new Writable({
+      write(chunk, encoding, callback) {
+        output += chunk.toString()
+        callback()
+      }
+    })
+
+    // Make stream appear as a TTY to preserve colors
+    stream.isTTY = true
+    stream.columns = process.stdout.columns
+    stream.rows = process.stdout.rows
+    stream.getColorDepth = () => process.stdout.getColorDepth?.() ?? 8
+
+    const tempConsole = new Console(stream)
+
+    tempConsole.table(tabularData, properties)
+
+    // Process output
+    let processed = output
+
+    // Remove quotes if requested
+    if(!quotedStrings) {
+      // Replace 'string' with string + 2 spaces to maintain alignment
+      // Use a more precise regex to avoid matching color codes
+      processed = processed.replace(/'([^']*)'/g, (match, content) => {
+        // Add 2 spaces to compensate for removed quotes
+        return content + "  "
+      })
+    }
+
+    // Remove header row and separator line
+    const lines = processed.split("\n")
+
+    if(lines.length > 3 && !showHeader) {
+      // Remove the header row (line 1) and separator (line 2)
+      // Keep: top border (line 0), data rows (line 3+)
+      const modified = [lines[0], ...lines.slice(3)]
+
+      process.stdout.write(modified.join("\n"))
+    } else if(showHeader) {
+      // Keep header but remove quotes if requested
+      process.stdout.write(processed)
+    } else {
+      // Fallback: just output as-is if format unexpected
+      process.stdout.write(processed)
+    }
+  }
+
   /**
    * Emit a status line to the terminal.
    *

package/src/types/browser/lib/Util.d.ts

@@ -83,7 +83,7 @@ export default class Util {
      * @param {Array<object>} rejected - Array of rejected results.
      * @throws {Error} Throws a Tantrum error with rejection reasons.
      */
-    static throwRejected(message: string, rejected: Array<object>): void;
+    static throwRejected(message: string, settled: any): void;
     /**
      * Filters and returns all fulfilled results from a settled promise array.
      *

package/src/types/browser/lib/Util.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Util.d.ts","sourceRoot":"","sources":["../../../browser/lib/Util.js"],"names":[],"mappings":"AAIA;;;GAGG;AACH;IACE;;;;;OAKG;IACH,wBAHW,MAAM,GACJ,MAAM,CAYlB;IAED;;;;;;OAMG;IACH,YAJa,CAAC,MACH,MAAM,OAAO,CAAC,CAAC,CAAC,GACd,OAAO,CAAC;QAAC,MAAM,EAAE,CAAC,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAC,CAAC,CAQ9C;IAED;;;;;;;OAOG;IACH,4BAJW,MAAM,GAAC,MAAM,UACb,MAAM,GACJ,MAAM,CAWlB;IAED;;;;;;;OAOG;IACH,6BAJW,MAAM,GAAC,MAAM,UACb,MAAM,GACJ,MAAM,CAalB;IAED;;;;;;OAMG;IACH,0BAHW,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GACrB,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAInC;IAED;;;;;;OAMG;IACH,2BAHW,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GACrB,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAIlC;IAED;;;;;OAKG;IACH,2BAHW,KAAK,CAAC,MAAM,CAAC,GACX,OAAO,CAInB;IAED;;;;;OAKG;IACH,kCAHW,KAAK,CAAC,MAAM,CAAC,GACX,KAAK,CAAC,MAAM,CAAC,CAIzB;IAED;;;;;OAKG;IACH,iCAHW,KAAK,CAAC,MAAM,CAAC,GACX,KAAK,CAAC,OAAO,CAAC,CAI1B;IAED;;;;;;OAMG;IACH,gDAHW,KAAK,CAAC,MAAM,CAAC,QAKvB;IAED;;;;;OAKG;IACH,mCAHW,KAAK,CAAC,MAAM,CAAC,GACX,KAAK,CAAC,MAAM,CAAC,CAIzB;IAED;;;;;OAKG;IACH,+BAHW,KAAK,CAAC,MAAM,CAAC,GACX,KAAK,CAAC,OAAO,CAAC,CAI1B;IAED;;;;;;OAMG;IACH,sBAHW,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GACrB,OAAO,CAAC,OAAO,CAAC,CAI5B;IAED;;;;;;OAMG;IACH,8BAJW,MAAM,KACN,MAAM,GACJ,MAAM,CAsBlB;IAED;;;;;;;;OAQG;IACH,+BALW,MAAM,iBACN,KAAK,CAAC,MAAM,CAAC,cACb,MAAM,GACJ,MAAM,CAwBlB;IAED,mEAiBC;CACF"}
+{"version":3,"file":"Util.d.ts","sourceRoot":"","sources":["../../../browser/lib/Util.js"],"names":[],"mappings":"AAIA;;;GAGG;AACH;IACE;;;;;OAKG;IACH,wBAHW,MAAM,GACJ,MAAM,CAYlB;IAED;;;;;;OAMG;IACH,YAJa,CAAC,MACH,MAAM,OAAO,CAAC,CAAC,CAAC,GACd,OAAO,CAAC;QAAC,MAAM,EAAE,CAAC,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAC,CAAC,CAQ9C;IAED;;;;;;;OAOG;IACH,4BAJW,MAAM,GAAC,MAAM,UACb,MAAM,GACJ,MAAM,CAWlB;IAED;;;;;;;OAOG;IACH,6BAJW,MAAM,GAAC,MAAM,UACb,MAAM,GACJ,MAAM,CAalB;IAED;;;;;;OAMG;IACH,0BAHW,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GACrB,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAInC;IAED;;;;;;OAMG;IACH,2BAHW,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GACrB,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAIlC;IAED;;;;;OAKG;IACH,2BAHW,KAAK,CAAC,MAAM,CAAC,GACX,OAAO,CAInB;IAED;;;;;OAKG;IACH,kCAHW,KAAK,CAAC,MAAM,CAAC,GACX,KAAK,CAAC,MAAM,CAAC,CAIzB;IAED;;;;;OAKG;IACH,iCAHW,KAAK,CAAC,MAAM,CAAC,GACX,KAAK,CAAC,OAAO,CAAC,CAI1B;IAED;;;;;;OAMG;IACH,0DAKC;IAED;;;;;OAKG;IACH,mCAHW,KAAK,CAAC,MAAM,CAAC,GACX,KAAK,CAAC,MAAM,CAAC,CAIzB;IAED;;;;;OAKG;IACH,+BAHW,KAAK,CAAC,MAAM,CAAC,GACX,KAAK,CAAC,OAAO,CAAC,CAI1B;IAED;;;;;;OAMG;IACH,sBAHW,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GACrB,OAAO,CAAC,OAAO,CAAC,CAI5B;IAED;;;;;;OAMG;IACH,8BAJW,MAAM,KACN,MAAM,GACJ,MAAM,CAsBlB;IAED;;;;;;;;OAQG;IACH,+BALW,MAAM,iBACN,KAAK,CAAC,MAAM,CAAC,cACb,MAAM,GACJ,MAAM,CAwBlB;IAED,mEAiBC;CACF"}

package/src/types/lib/Glog.d.ts

@@ -40,6 +40,21 @@ declare class Glog {
      * @param {...unknown} args - Additional arguments to log
      */
     static success(message: string, ...args: unknown[]): void;
+    /**
+     * Static table method
+     *
+     * @param {object | Array} data - Object or array to display
+     * @param {string | object} [labelOrOptions] - Optional label (string) or options (object)
+     * @param {object} [options] - Optional options when label is provided
+     * @param {Array<string>} [options.properties] - Column properties to display
+     * @param {boolean} [options.showHeader=false] - Whether to show the header row
+     * @param {boolean} [options.quotedStrings=false] - Whether to show quotes around strings
+     */
+    static table(data: object | any[], labelOrOptions?: string | object, options?: {
+        properties?: Array<string>;
+        showHeader?: boolean;
+        quotedStrings?: boolean;
+    }): void;
     /**
      * Set a color alias for convenient usage
      *
@@ -102,6 +117,21 @@ declare class Glog {
      * @param {...unknown} args - Additional arguments
      */
     success(message: string, ...args: unknown[]): void;
+    /**
+     * Display tabular data as a table
+     *
+     * @param {object | Array} data - Object or array to display
+     * @param {string | object} [labelOrOptions] - Optional label (string) or options (object)
+     * @param {object} [options] - Optional options when label is provided
+     * @param {Array<string>} [options.properties] - Column properties to display
+     * @param {boolean} [options.showHeader=false] - Whether to show the header row
+     * @param {boolean} [options.quotedStrings=false] - Whether to show quotes around strings
+     */
+    table(data: object | any[], labelOrOptions?: string | object, options?: {
+        properties?: Array<string>;
+        showHeader?: boolean;
+        quotedStrings?: boolean;
+    }): void;
     /**
      * Get access to the colours template function for instance usage
      *

package/src/types/lib/Glog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Glog.d.ts","sourceRoot":"","sources":["../../lib/Glog.js"],"names":[],"mappings":";;;;;;;;;AA6CA;IAEE,wBAAmB;IACnB,yBAAqB;IACrB,mBAAoB;IACpB,2BAAyB;IACzB,oBAAgB;IA2ChB,8CAIC;IAED,4CAIC;IAED,wCAIC;IAED;;;;;;oBAIC;IAED,sDAIC;IAID,kCAEC;IAwJD,qCAoBC;IAuBD;;;;;OAKG;IACH,yBAHW,KAAK,CAAC,MAAM,CAAC,aACV,OAAO,EAAA,QAOpB;IAYD;;;;;OAKG;IACH,wBAHW,MAAM,WACH,OAAO,EAAA,QAIpB;IAED;;;;;;OAMG;IACH,uBAJW,MAAM,aACN,MAAM,GACJ,IAAI,CAMhB;IAhTD,0BAeC;IAID,+BAQC;IAwCD,0BAIC;IAED,+BAIC;IAED,8BAIC;IAED;;;;;;aAIC;IAED,wCAIC;IAID,mBAEC;IAED,yBAEC;IAED;;;;;;MAQC;IAqBD,8BAGC;IAED,wBAQC;IA8BD;;;;;;;;;OASG;IACH,eALW,MAAM,UACN,MAAM,UACH,OAAO,EAAA,QAapB;IAED,wCAGC;IAED,wCAGC;IAED,yCAGC;IA0BD,8BAEC;IAID;;;;;;OAMG;IACH,kBAJW,KAAK,CAAC,MAAM,CAAC,aACV,OAAO,EAAA,QAQpB;IAeD;;;;;OAKG;IACH,iBAHW,MAAM,WACH,OAAO,EAAA,QAIpB;IAyBD;;;;OAIG;IACH,iDAEC;;CACF"}
+{"version":3,"file":"Glog.d.ts","sourceRoot":"","sources":["../../lib/Glog.js"],"names":[],"mappings":";;;;;;;;;AA6CA;IAEE,wBAAmB;IACnB,yBAAqB;IACrB,mBAAoB;IACpB,2BAAyB;IACzB,oBAAgB;IA4ChB,8CAIC;IAED,4CAIC;IAED,wCAIC;IAED;;;;;;oBAIC;IAED,sDAIC;IAID,kCAEC;IAwJD,qCAoBC;IAuBD;;;;;OAKG;IACH,yBAHW,KAAK,CAAC,MAAM,CAAC,aACV,OAAO,EAAA,QAOpB;IAYD;;;;;OAKG;IACH,wBAHW,MAAM,WACH,OAAO,EAAA,QAIpB;IA+BD;;;;;;;;;OASG;IACH,mBAPW,MAAM,QAAQ,mBACd,MAAM,GAAG,MAAM,YAEvB;QAAgC,UAAU,GAAlC,KAAK,CAAC,MAAM,CAAC;QACK,UAAU,GAA5B,OAAO;QACW,aAAa,GAA/B,OAAO;KACjB,QAkBA;IAED;;;;;;OAMG;IACH,uBAJW,MAAM,aACN,MAAM,GACJ,IAAI,CAMhB;IA3WD,0BAgBC;IAID,+BAQC;IAwCD,0BAIC;IAED,+BAIC;IAED,8BAIC;IAED;;;;;;aAIC;IAED,wCAIC;IAID,mBAEC;IAED,yBAEC;IAED;;;;;;MAQC;IAqBD,8BAGC;IAED,wBAQC;IA8BD;;;;;;;;;OASG;IACH,eALW,MAAM,UACN,MAAM,UACH,OAAO,EAAA,QAapB;IAED,wCAGC;IAED,wCAGC;IAED,yCAGC;IA0BD,8BAEC;IAID;;;;;;OAMG;IACH,kBAJW,KAAK,CAAC,MAAM,CAAC,aACV,OAAO,EAAA,QAQpB;IAeD;;;;;OAKG;IACH,iBAHW,MAAM,WACH,OAAO,EAAA,QAIpB;IAYD;;;;;;;;;OASG;IACH,YAPW,MAAM,QAAQ,mBACd,MAAM,GAAG,MAAM,YAEvB;QAAgC,UAAU,GAAlC,KAAK,CAAC,MAAM,CAAC;QACK,UAAU,GAA5B,OAAO;QACW,aAAa,GAA/B,OAAO;KACjB,QAkBA;IA4CD;;;;OAIG;IACH,iDAEC;;CACF"}

package/src/types/lib/Term.d.ts

@@ -39,6 +39,20 @@ export default class Term {
      * End the current console group.
      */
     static groupEnd(): void;
+    /**
+     * Display tabular data as a table.
+     *
+     * @param {object | Array} tabularData - Object or array to display.
+     * @param {object} [options] - Table options.
+     * @param {Array<string>} [options.properties] - Optional column properties to display.
+     * @param {boolean} [options.showHeader=false] - Whether to show the header row with column names.
+     * @param {boolean} [options.quotedStrings=false] - Whether to show quotes around strings.
+     */
+    static table(tabularData: object | any[], options?: {
+        properties?: Array<string>;
+        showHeader?: boolean;
+        quotedStrings?: boolean;
+    }): void;
     /**
      * Emit a status line to the terminal.
      *

package/src/types/lib/Term.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Term.d.ts","sourceRoot":"","sources":["../../lib/Term.js"],"names":[],"mappings":"AAKA;IACE;;;;OAIG;IACH,oBAFc,OAAO,EAAA,QAIpB;IAED;;;;OAIG;IACH,qBAFc,OAAO,EAAA,QAIpB;IAED;;;;OAIG;IACH,qBAFc,OAAO,EAAA,QAIpB;IAED;;;;OAIG;IACH,sBAFc,OAAO,EAAA,QAIpB;IAED;;;;OAIG;IACH,sBAFc,OAAO,EAAA,QAIpB;IAED;;;;OAIG;IACH,sBAFc,OAAO,EAAA,QAIpB;IAED;;OAEG;IACH,wBAEC;IAED;;;;;;;;;;;;;;OAcG;IACH,oBALW,MAAM,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,eAEjD;QAAyB,MAAM,EAAvB,OAAO;KACf,GAAU,IAAI,CAOhB;IAED;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,gCAHW,MAAM,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,GAClE,IAAI,CA4BhB;IAED;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,gDAJW,KAAK,CAAC,MAAM,CAAC,GACX,MAAM,CASlB;IAED,sCAGC;IAED,2CAEC;IAED,8CAIC;CACF"}
+{"version":3,"file":"Term.d.ts","sourceRoot":"","sources":["../../lib/Term.js"],"names":[],"mappings":"AAOA;IACE;;;;OAIG;IACH,oBAFc,OAAO,EAAA,QAIpB;IAED;;;;OAIG;IACH,qBAFc,OAAO,EAAA,QAIpB;IAED;;;;OAIG;IACH,qBAFc,OAAO,EAAA,QAIpB;IAED;;;;OAIG;IACH,sBAFc,OAAO,EAAA,QAIpB;IAED;;;;OAIG;IACH,sBAFc,OAAO,EAAA,QAIpB;IAED;;;;OAIG;IACH,sBAFc,OAAO,EAAA,QAIpB;IAED;;OAEG;IACH,wBAEC;IAED;;;;;;;;OAQG;IACH,0BANW,MAAM,QAAQ,YAEtB;QAAgC,UAAU,GAAlC,KAAK,CAAC,MAAM,CAAC;QACK,UAAU,GAA5B,OAAO;QACW,aAAa,GAA/B,OAAO;KACjB,QA2DA;IAED;;;;;;;;;;;;;;OAcG;IACH,oBALW,MAAM,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,eAEjD;QAAyB,MAAM,EAAvB,OAAO;KACf,GAAU,IAAI,CAOhB;IAED;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,gCAHW,MAAM,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,GAClE,IAAI,CA4BhB;IAED;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,gDAJW,KAAK,CAAC,MAAM,CAAC,GACX,MAAM,CASlB;IAED,sCAGC;IAED,2CAEC;IAED,8CAIC;CACF"}