@gesslar/toolkit 2.2.0 → 2.3.0

package/package.json

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

package/src/browser/lib/Sass.js

@@ -70,9 +70,13 @@ export default class Sass extends Error {
    * Optionally includes detailed stack trace information.
    *
    * @param {boolean} [nerdMode] - Whether to include detailed stack trace
+   * @param {boolean} [isNested] - Whether this is a nested error report
    */
-  report(nerdMode=false) {
-    console.error(
+  report(nerdMode=false, isNested=false) {
+    if(isNested)
+      console.error()
+
+    console.group(
       `[error] Something Went Wrong\n` +
       this.trace.join("\n")
     )
@@ -80,16 +84,33 @@ export default class Sass extends Error {
     if(nerdMode) {
       console.error(
         "\n" +
-        `[error] Nerd Vittles\n` +
+        `[error] Nerd Victuals\n` +
         this.#fullBodyMassage(this.stack)
       )
+    }
 
-      this.cause?.stack && console.error(
-        "\n" +
-        `[error] Rethrown From\n` +
-        this.#fullBodyMassage(this.cause?.stack)
-      )
+    if(this.cause) {
+      if(typeof this.cause.report === "function") {
+        if(nerdMode) {
+          console.error(
+            "\n" +
+            `[error] Caused By`
+          )
+        }
+
+        this.cause.report(nerdMode, true)
+      } else if(nerdMode && this.cause.stack) {
+        console.error()
+        console.group()
+        console.error(
+          `[error] Rethrown From\n` +
+          this.#fullBodyMassage(this.cause.stack)
+        )
+        console.groupEnd()
+      }
     }
+
+    console.groupEnd()
   }
 
   /**
@@ -138,7 +159,9 @@ export default class Sass extends Error {
       throw this.new("Sass.from must take an Error object.")
 
     const oldMessage = error.message
-    const newError = new this(oldMessage, {cause: error}).addTrace(message)
+    const newError = new this(
+      oldMessage, {cause: error}
+    ).addTrace(message)
 
     return newError
   }

package/src/browser/lib/Tantrum.js

@@ -82,21 +82,25 @@ export default class Tantrum extends AggregateError {
    * Reports all aggregated errors to the console with formatted output.
    *
    * @param {boolean} [nerdMode] - Whether to include detailed stack traces
+   * @param {boolean} [isNested] - Whether this is a nested error report
    */
-  report(nerdMode = false) {
-    console.error(
-      `[error] Tantrum Incoming (${this.errors.length} errors)\n` +
+  report(nerdMode = false, isNested = false) {
+    if(isNested)
+      console.error()
+
+    console.group(
+      `[Tantrum Incoming] x${this.errors.length}\n` +
       this.message
     )
 
-    if(this.trace)
+    if(this.trace.length > 0)
       console.error(this.trace.join("\n"))
 
-    console.error()
-
     this.errors.forEach(error => {
-      error.report(nerdMode)
+      error.report(nerdMode, true)
     })
+
+    console.groupEnd()
   }
 
   /**

package/src/browser/lib/Util.js

@@ -1,4 +1,4 @@
-import Sass from "./Sass.js"
+import Tantrum from "./Tantrum.js"
 import Valid from "./Valid.js"
 import Collection from "./Collection.js"
 
@@ -137,10 +137,10 @@ export default class Util {
    *
    * @param {string} [_message] - Optional error message. Defaults to "GIGO"
    * @param {Array<object>} rejected - Array of rejected results.
-   * @throws {Error} Throws a Sass error with rejection reasons.
+   * @throws {Error} Throws a Tantrum error with rejection reasons.
    */
-  static throwRejected(_message="GIGO", rejected) {
-    throw Sass.new(this.rejectedReasons(rejected))
+  static throwRejected(message="GIGO", rejected) {
+    throw Tantrum.new(message, this.rejectedReasons(rejected))
   }
 
   /**

package/src/lib/Sass.js

@@ -24,9 +24,13 @@ export default class Sass extends BrowserSass {
    * Optionally includes detailed stack trace information.
    *
    * @param {boolean} [nerdMode] - Whether to include detailed stack trace
+   * @param {boolean} [isNested] - Whether this is a nested error report
    */
-  report(nerdMode=false) {
-    Term.error(
+  report(nerdMode=false, isNested=false) {
+    if(isNested)
+      Term.error()
+
+    Term.group(
       `${Term.terminalBracket(["error", "Something Went Wrong"])}\n` +
       this.trace.join("\n")
     )
@@ -34,16 +38,33 @@ export default class Sass extends BrowserSass {
     if(nerdMode) {
       Term.error(
         "\n" +
-        `${Term.terminalBracket(["error", "Nerd Vittles"])}\n` +
+        `${Term.terminalBracket(["error", "Nerd Victuals"])}\n` +
         this.#fullBodyMassage(this.stack)
       )
+    }
 
-      this.cause?.stack && Term.error(
-        "\n" +
-        `${Term.terminalBracket(["error", "Rethrown From"])}\n` +
-        this.#fullBodyMassage(this.cause?.stack)
-      )
+    if(this.cause) {
+      if(typeof this.cause.report === "function") {
+        if(nerdMode) {
+          Term.error(
+            "\n" +
+            `${Term.terminalBracket(["error", "Caused By"])}`
+          )
+        }
+
+        this.cause.report(nerdMode, true)
+      } else if(nerdMode && this.cause.stack) {
+        Term.error()
+        Term.group()
+        Term.error(
+          `${Term.terminalBracket(["error", "Rethrown From"])}\n` +
+          this.#fullBodyMassage(this.cause.stack)
+        )
+        Term.groupEnd()
+      }
     }
+
+    Term.groupEnd()
   }
 
   /**

package/src/lib/Tantrum.js

@@ -26,20 +26,24 @@ export default class Tantrum extends BrowserTantrum {
    * Reports all aggregated errors to the terminal with formatted output.
    *
    * @param {boolean} [nerdMode] - Whether to include detailed stack traces
+   * @param {boolean} [isNested] - Whether this is a nested error report
    */
-  report(nerdMode = false) {
-    Term.error(
-      `${Term.terminalBracket(["error", "Tantrum Incoming"])} (${this.errors.length} errors)\n` +
+  report(nerdMode = false, isNested = false) {
+    if(isNested)
+      Term.error()
+
+    Term.group(
+      `${Term.terminalBracket(["error", "Tantrum Incoming"])} x${this.errors.length}\n` +
       this.message
     )
 
-    if(this.trace)
+    if(this.trace.length > 0)
       Term.error(this.trace.join("\n"))
 
-    Term.error()
-
     this.errors.forEach(error => {
-      error.report(nerdMode)
+      error.report(nerdMode, true)
     })
+
+    Term.groupEnd()
   }
 }

package/src/lib/Term.js

@@ -49,6 +49,22 @@ export default class Term {
     console.debug(...arg)
   }
 
+  /**
+   * Start a console group for indented output.
+   *
+   * @param {...unknown} [arg] - Optional group label.
+   */
+  static group(...arg) {
+    console.group(...arg)
+  }
+
+  /**
+   * End the current console group.
+   */
+  static groupEnd() {
+    console.groupEnd()
+  }
+
   /**
    * Emit a status line to the terminal.
    *

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

@@ -54,8 +54,9 @@ export default class Sass extends Error {
      * Optionally includes detailed stack trace information.
      *
      * @param {boolean} [nerdMode] - Whether to include detailed stack trace
+     * @param {boolean} [isNested] - Whether this is a nested error report
      */
-    report(nerdMode?: boolean): void;
+    report(nerdMode?: boolean, isNested?: boolean): void;
     #private;
 }
 import Tantrum from "./Tantrum.js";

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

@@ -1 +1 @@
-{"version":3,"file":"Sass.d.ts","sourceRoot":"","sources":["../../../browser/lib/Sass.js"],"names":[],"mappings":"AAeA;;;GAGG;AACH;IA2GE;;;;;;;;OAQG;IACH,mBALW,KAAK,WACL,MAAM,GACJ,IAAI,CAWhB;IAED;;;;;;;;OAQG;IACH,sBAJW,MAAM,UACN,KAAK,GAAC,IAAI,GAAC,OAAO,GAChB,IAAI,CAchB;IAhJD;;;;;OAKG;IACH,qBAHW,MAAM,WACH,OAAO,EAAA,EAMpB;IAWD;;;;OAIG;IACH,mBAFW,MAAM,EAIhB;IAhBD;;;;OAIG;IACH,aAFa,KAAK,CAAC,MAAM,CAAC,CAIzB;IAWD;;;;;OAKG;IACH,kBAHW,MAAM,GACJ,IAAI,CAShB;IAED;;;;;OAKG;IACH,kBAFW,OAAO,QAqBjB;;CA2EF;oBA1JmB,cAAc"}
+{"version":3,"file":"Sass.d.ts","sourceRoot":"","sources":["../../../browser/lib/Sass.js"],"names":[],"mappings":"AAeA;;;GAGG;AACH;IAgIE;;;;;;;;OAQG;IACH,mBALW,KAAK,WACL,MAAM,GACJ,IAAI,CAahB;IAED;;;;;;;;OAQG;IACH,sBAJW,MAAM,UACN,KAAK,GAAC,IAAI,GAAC,OAAO,GAChB,IAAI,CAchB;IAvKD;;;;;OAKG;IACH,qBAHW,MAAM,WACH,OAAO,EAAA,EAMpB;IAWD;;;;OAIG;IACH,mBAFW,MAAM,EAIhB;IAhBD;;;;OAIG;IACH,aAFa,KAAK,CAAC,MAAM,CAAC,CAIzB;IAWD;;;;;OAKG;IACH,kBAHW,MAAM,GACJ,IAAI,CAShB;IAED;;;;;;OAMG;IACH,kBAHW,OAAO,aACP,OAAO,QAyCjB;;CA6EF;oBAjLmB,cAAc"}

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

@@ -43,8 +43,9 @@ export default class Tantrum extends AggregateError {
      * Reports all aggregated errors to the console with formatted output.
      *
      * @param {boolean} [nerdMode] - Whether to include detailed stack traces
+     * @param {boolean} [isNested] - Whether this is a nested error report
      */
-    report(nerdMode?: boolean): void;
+    report(nerdMode?: boolean, isNested?: boolean): void;
     #private;
 }
 import Sass from "./Sass.js";

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

@@ -1 +1 @@
-{"version":3,"file":"Tantrum.d.ts","sourceRoot":"","sources":["../../../browser/lib/Tantrum.js"],"names":[],"mappings":"AAaA;;;GAGG;AACH;IAoFE;;;;;;OAMG;IACH,sBAJW,MAAM,WACN,KAAK,CAAC,KAAK,GAAC,IAAI,CAAC,GACf,OAAO,CAOnB;IA5FD;;;;;;OAMG;IACH,qBAJW,MAAM,WACN,KAAK,CAAC,KAAK,GAAC,IAAI,CAAC,SACjB,IAAI,EAkBd;IAED;;;;;;OAMG;IACH,kBAJW,MAAM,WACN,KAAK,GAAC,IAAI,GACR,IAAI,CAShB;IAWD;;;;OAIG;IACH,mBAFW,MAAM,EAIhB;IAhBD;;;;OAIG;IACH,aAFa,KAAK,CAAC,MAAM,CAAC,CAIzB;IAWD;;;;OAIG;IACH,kBAFW,OAAO,QAgBjB;;CAeF;iBAvGgB,WAAW"}
+{"version":3,"file":"Tantrum.d.ts","sourceRoot":"","sources":["../../../browser/lib/Tantrum.js"],"names":[],"mappings":"AAaA;;;GAGG;AACH;IAwFE;;;;;;OAMG;IACH,sBAJW,MAAM,WACN,KAAK,CAAC,KAAK,GAAC,IAAI,CAAC,GACf,OAAO,CAOnB;IAhGD;;;;;;OAMG;IACH,qBAJW,MAAM,WACN,KAAK,CAAC,KAAK,GAAC,IAAI,CAAC,SACjB,IAAI,EAkBd;IAED;;;;;;OAMG;IACH,kBAJW,MAAM,WACN,KAAK,GAAC,IAAI,GACR,IAAI,CAShB;IAWD;;;;OAIG;IACH,mBAFW,MAAM,EAIhB;IAhBD;;;;OAIG;IACH,aAFa,KAAK,CAAC,MAAM,CAAC,CAIzB;IAWD;;;;;OAKG;IACH,kBAHW,OAAO,aACP,OAAO,QAmBjB;;CAeF;iBA3GgB,WAAW"}

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

@@ -81,9 +81,9 @@ export default class Util {
      *
      * @param {string} [_message] - Optional error message. Defaults to "GIGO"
      * @param {Array<object>} rejected - Array of rejected results.
-     * @throws {Error} Throws a Sass error with rejection reasons.
+     * @throws {Error} Throws a Tantrum error with rejection reasons.
      */
-    static throwRejected(_message?: string, rejected: Array<object>): void;
+    static throwRejected(message: string, rejected: Array<object>): 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,gCAJW,MAAM,YACN,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,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"}

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

@@ -1 +1 @@
-{"version":3,"file":"Sass.d.ts","sourceRoot":"","sources":["../../lib/Sass.js"],"names":[],"mappings":"AAgBA;;;GAGG;AACH;;CA2DC;oCAlEiC,qBAAqB"}
+{"version":3,"file":"Sass.d.ts","sourceRoot":"","sources":["../../lib/Sass.js"],"names":[],"mappings":"AAgBA;;;GAGG;AACH;;CAgFC;oCAvFiC,qBAAqB"}

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

@@ -1 +1 @@
-{"version":3,"file":"Tantrum.d.ts","sourceRoot":"","sources":["../../lib/Tantrum.js"],"names":[],"mappings":"AAeA;;;GAGG;AACH;IACE,0CAEC;CAsBF;0CAjCuC,qBAAqB"}
+{"version":3,"file":"Tantrum.d.ts","sourceRoot":"","sources":["../../lib/Tantrum.js"],"names":[],"mappings":"AAeA;;;GAGG;AACH;IACE,0CAEC;CA0BF;0CArCuC,qBAAqB"}

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

@@ -29,6 +29,16 @@ export default class Term {
      * @param {...unknown} [arg] - Values to log.
      */
     static debug(...arg?: unknown[]): void;
+    /**
+     * Start a console group for indented output.
+     *
+     * @param {...unknown} [arg] - Optional group label.
+     */
+    static group(...arg?: unknown[]): void;
+    /**
+     * End the current console group.
+     */
+    static groupEnd(): 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;;;;;;;;;;;;;;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":"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"}