@gesslar/toolkit 0.8.0 → 1.0.0

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

@@ -2,61 +2,8 @@
  * Custom error class for toolkit errors.
  * Provides error chaining, trace management, and formatted error reporting.
  */
-export default class Sass extends Error {
-    /**
-     * Creates an Sass from an existing Error object with additional
-     * trace message.
-     *
-     * @param {Error} error - The original error object
-     * @param {string} message - Additional trace message to add
-     * @returns {Sass} New Sass instance with trace from the original error
-     * @throws {Sass} If the first parameter is not an Error instance
-     */
-    static from(error: Error, message: string): Sass;
-    /**
-     * Factory method to create or enhance Sass instances.
-     * If error parameter is provided, enhances existing Sass or wraps
-     * other errors. Otherwise creates a new Sass instance.
-     *
-     * @param {string} message - The error message
-     * @param {Error|Sass|Tantrum} [error] - Optional existing error to wrap or enhance
-     * @returns {Sass} New or enhanced Sass instance
-     */
-    static "new"(message: string, error?: Error | Sass | Tantrum): Sass;
-    /**
-     * Creates a new Sass instance.
-     *
-     * @param {string} message - The error message
-     * @param {...unknown} [arg] - Additional arguments passed to parent Error constructor
-     */
-    constructor(message: string, ...arg?: unknown[]);
-    /**
-     * Adds a message to the beginning of the trace array.
-     *
-     * @param {string} message - The trace message to add
-     */
-    set trace(message: string);
-    /**
-     * Gets the error trace array.
-     *
-     * @returns {Array<string>} Array of trace messages
-     */
-    get trace(): Array<string>;
-    /**
-     * Adds a trace message and returns this instance for chaining.
-     *
-     * @param {string} message - The trace message to add
-     * @returns {this} This Sass instance for method chaining
-     */
-    addTrace(message: string): this;
-    /**
-     * Reports the error to the terminal with formatted output.
-     * Optionally includes detailed stack trace information.
-     *
-     * @param {boolean} [nerdMode] - Whether to include detailed stack trace
-     */
-    report(nerdMode?: boolean): void;
+export default class Sass extends BrowserSass {
     #private;
 }
-import Tantrum from "./Tantrum.js";
+import { Sass as BrowserSass } from "../browser/index.js";
 //# sourceMappingURL=Sass.d.ts.map

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;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":["../../lib/Sass.js"],"names":[],"mappings":"AAgBA;;;GAGG;AACH;;CA2DC;oCAlEiC,qBAAqB"}

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

@@ -2,49 +2,8 @@
  * Custom aggregate error class that extends AggregateError.
  * Automatically wraps plain errors in Sass instances for consistent reporting.
  */
-export default class Tantrum extends AggregateError {
-    /**
-     * Factory method to create a Tantrum instance.
-     *
-     * @param {string} message - The aggregate error message
-     * @param {Array<Error|Sass>} errors - Array of errors to aggregate
-     * @returns {Tantrum} New Tantrum instance
-     */
-    static "new"(message: string, errors?: Array<Error | Sass>): Tantrum;
-    /**
-     * Creates a new Tantrum instance.
-     *
-     * @param {string} message - The aggregate error message
-     * @param {Array<Error|Sass>} errors - Array of errors to aggregate
-     */
-    constructor(message: string, errors?: Array<Error | Sass>);
-    /**
-     * Adds a trace message and returns this instance for chaining.
-     *
-     * @param {string} message - The trace message to add
-     * @param {Error|Sass} [_error] - Optional error (currently unused, reserved for future use)
-     * @returns {this} This Tantrum instance for method chaining
-     */
-    addTrace(message: string, _error?: Error | Sass): this;
-    /**
-     * Adds a message to the beginning of the trace array.
-     *
-     * @param {string} message - The trace message to add
-     */
-    set trace(message: string);
-    /**
-     * Gets the error trace array.
-     *
-     * @returns {Array<string>} Array of trace messages
-     */
-    get trace(): Array<string>;
-    /**
-     * Reports all aggregated errors to the terminal with formatted output.
-     *
-     * @param {boolean} [nerdMode] - Whether to include detailed stack traces
-     */
-    report(nerdMode?: boolean): void;
-    #private;
+export default class Tantrum extends BrowserTantrum {
+    constructor(message: any, errors?: any[]);
 }
-import Sass from "./Sass.js";
+import { Tantrum as BrowserTantrum } from "../browser/index.js";
 //# sourceMappingURL=Tantrum.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Tantrum.d.ts","sourceRoot":"","sources":["../../lib/Tantrum.js"],"names":[],"mappings":"AAcA;;;GAGG;AACH;IAgFE;;;;;;OAMG;IACH,sBAJW,MAAM,WACN,KAAK,CAAC,KAAK,GAAC,IAAI,CAAC,GACf,OAAO,CAOnB;IAzFD;;;;;OAKG;IACH,qBAHW,MAAM,WACN,KAAK,CAAC,KAAK,GAAC,IAAI,CAAC,EAgB3B;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;iBApGgB,WAAW"}
+{"version":3,"file":"Tantrum.d.ts","sourceRoot":"","sources":["../../lib/Tantrum.js"],"names":[],"mappings":"AAeA;;;GAGG;AACH;IACE,0CAEC;CAsBF;0CAjCuC,qBAAqB"}

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

@@ -2,43 +2,7 @@
  * Utility class providing common helper functions for string manipulation,
  * timing, hashing, and option parsing.
  */
-export default class Util {
-    /**
-     * Capitalizes the first letter of a string.
-     *
-     * @param {string} text - The text to capitalize
-     * @returns {string} Text with first letter capitalized
-     */
-    static capitalize(text: string): string;
-    /**
-     * Measure wall-clock time for an async function.
-     *
-     * @template T
-     * @param {() => Promise<T>} fn - Thunk returning a promise.
-     * @returns {Promise<{result: T, cost: number}>} Object containing result and elapsed ms (number, 1 decimal).
-     */
-    static time<T>(fn: () => Promise<T>): Promise<{
-        result: T;
-        cost: number;
-    }>;
-    /**
-     * Right-align a string inside a fixed width (left pad with spaces).
-     * If the string exceeds width it is returned unchanged.
-     *
-     * @param {string|number} text - Text to align.
-     * @param {number} width - Target field width (default 80).
-     * @returns {string} Padded string.
-     */
-    static rightAlignText(text: string | number, width?: number): string;
-    /**
-     * Centre-align a string inside a fixed width (pad with spaces on left).
-     * If the string exceeds width it is returned unchanged.
-     *
-     * @param {string|number} text - Text to align.
-     * @param {number} width - Target field width (default 80).
-     * @returns {string} Padded string with text centred.
-     */
-    static centreAlignText(text: string | number, width?: number): string;
+export default class Util extends BrowserUtil {
     /**
      * Compute sha256 hash (hex) of the provided string.
      *
@@ -71,73 +35,6 @@ export default class Util {
      * @returns {Array<string>} Array of canonical option names (long preferred, short if no long present).
      */
     static generateOptionNames(object: object): Array<string>;
-    /**
-     * Asynchronously awaits all promises in parallel.
-     * Wrapper around Promise.all for consistency with other utility methods.
-     *
-     * @param {Array<Promise<unknown>>} promises - Array of promises to await
-     * @returns {Promise<Array<unknown>>} Results of all promises
-     */
-    static awaitAll(promises: Array<Promise<unknown>>): Promise<Array<unknown>>;
-    /**
-     * Settles all promises (both fulfilled and rejected) in parallel.
-     * Wrapper around Promise.allSettled for consistency with other utility methods.
-     *
-     * @param {Array<Promise<unknown>>} promises - Array of promises to settle
-     * @returns {Promise<Array<object>>} Results of all settled promises with status and value/reason
-     */
-    static settleAll(promises: Array<Promise<unknown>>): Promise<Array<object>>;
-    /**
-     * Checks if any result in the settled promise array is rejected.
-     *
-     * @param {Array<object>} result - Array of settled promise results.
-     * @returns {boolean} True if any result is rejected, false otherwise.
-     */
-    static anyRejected(result: Array<object>): boolean;
-    /**
-     * Filters and returns all rejected results from a settled promise array.
-     *
-     * @param {Array<object>} result - Array of settled promise results.
-     * @returns {Array<object>} Array of rejected results.
-     */
-    static settledAndRejected(result: Array<object>): Array<object>;
-    /**
-     * Extracts the rejection reasons from an array of rejected promise results.
-     *
-     * @param {Array<object>} rejected - Array of rejected results.
-     * @returns {Array<unknown>} Array of rejection reasons.
-     */
-    static rejectedReasons(rejected: Array<object>): Array<unknown>;
-    /**
-     * Throws a Sass error containing all rejection reasons from settled promises.
-     *
-     * @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.
-     */
-    static throwRejected(_message?: string, rejected: Array<object>): void;
-    /**
-     * Filters and returns all fulfilled results from a settled promise array.
-     *
-     * @param {Array<object>} result - Array of settled promise results.
-     * @returns {Array<object>} Array of fulfilled results.
-     */
-    static settledAndFulfilled(result: Array<object>): Array<object>;
-    /**
-     * Extracts the values from all fulfilled results in a settled promise array.
-     *
-     * @param {Array<object>} result - Array of settled promise results.
-     * @returns {Array<unknown>} Array of fulfilled values.
-     */
-    static fulfilledValues(result: Array<object>): Array<unknown>;
-    /**
-     * Returns the first promise to resolve or reject from an array of promises.
-     * Wrapper around Promise.race for consistency with other utility methods.
-     *
-     * @param {Array<Promise<unknown>>} promises - Array of promises to race
-     * @returns {Promise<unknown>} Result of the first settled promise
-     */
-    static race(promises: Array<Promise<unknown>>): Promise<unknown>;
     /**
      * Private method that performs the actual async emission logic.
      * Handles listener execution, error aggregation, and result processing.
@@ -174,25 +71,7 @@ export default class Util {
      * @returns {Promise<void>} Resolves when all listeners have completed, but no grapes.
      */
     static asyncEmitQuack(emitter: object, event: string, ...args: unknown[]): Promise<void>;
-    /**
-     * Determine the Levenshtein distance between two string values
-     *
-     * @param {string} a The first value for comparison.
-     * @param {string} b The second value for comparison.
-     * @returns {number} The Levenshtein distance
-     */
-    static levenshteinDistance(a: string, b: string): number;
-    /**
-     * Determine the closest match between a string and allowed values
-     * from the Levenshtein distance.
-     *
-     * @param {string} input The input string to resolve
-     * @param {Array<string>} allowedValues The values which are permitted
-     * @param {number} [threshold] Max edit distance for a "close match"
-     * @returns {string} Suggested, probable match.
-     */
-    static findClosestMatch(input: string, allowedValues: Array<string>, threshold?: number): string;
-    static regexify(input: any, trim?: boolean, flags?: any[]): RegExp;
 }
+import { Util as BrowserUtil } from "../browser/index.js";
 import { EventEmitter } from "node:events";
 //# sourceMappingURL=Util.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Util.d.ts","sourceRoot":"","sources":["../../lib/Util.js"],"names":[],"mappings":"AAOA;;;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;;;;;OAKG;IACH,iBAHW,MAAM,GACJ,MAAM,CAIlB;IAED;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,mCAHW,MAAM,GACJ,KAAK,CAAC,MAAM,CAAC,CAazB;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;;;;;;;;OAQG;IACH,+CALW,MAAM,SACN,MAAM,WACH,OAAO,EAAA,GACR,OAAO,CAAC,IAAI,CAAC,CAmBzB;IAED;;;;;;;;;;;;OAYG;IACH,0BALW,YAAY,SACZ,MAAM,WACH,OAAO,EAAA,GACR,OAAO,CAAC,IAAI,CAAC,CAqBzB;IAED;;;;;;;;;;OAUG;IACH,+BALW,MAAM,SACN,MAAM,WACH,OAAO,EAAA,GACR,OAAO,CAAC,IAAI,CAAC,CAyBzB;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;6BAlZ0B,aAAa"}
+{"version":3,"file":"Util.d.ts","sourceRoot":"","sources":["../../lib/Util.js"],"names":[],"mappings":"AAKA;;;GAGG;AACH;IACE;;;;;OAKG;IACH,iBAHW,MAAM,GACJ,MAAM,CAIlB;IAED;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,mCAHW,MAAM,GACJ,KAAK,CAAC,MAAM,CAAC,CAazB;IAED;;;;;;;;OAQG;IACH,+CALW,MAAM,SACN,MAAM,WACH,OAAO,EAAA,GACR,OAAO,CAAC,IAAI,CAAC,CAmBzB;IAED;;;;;;;;;;;;OAYG;IACH,0BALW,YAAY,SACZ,MAAM,WACH,OAAO,EAAA,GACR,OAAO,CAAC,IAAI,CAAC,CAqBzB;IAED;;;;;;;;;;OAUG;IACH,+BALW,MAAM,SACN,MAAM,WACH,OAAO,EAAA,GACR,OAAO,CAAC,IAAI,CAAC,CAyBzB;CACF;oCAvJiC,qBAAqB;6BAF5B,aAAa"}

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

@@ -2,6 +2,7 @@
  * Validation utility class providing type checking and assertion methods.
  */
 export default class Valid {
+    static "__#private@#restrictedProto": string[];
     /**
      * Validates a value against a type. Uses Data.isType.
      *
@@ -20,7 +21,6 @@ export default class Valid {
      *                         met (optional)
      */
     static assert(condition: boolean, message: string, arg?: number): void;
-    static "__#private@#restrictedProto": string[];
     /**
      * Protects against prototype pollution by checking keys for dangerous property names.
      * Throws if any restricted prototype properties are found in the keys array.

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

@@ -1 +1 @@
-{"version":3,"file":"Valid.d.ts","sourceRoot":"","sources":["../../lib/Valid.js"],"names":[],"mappings":"AAaA;;GAEG;AACH;IACE;;;;;;OAMG;IACH,mBAJW,OAAO,QACP,MAAM,YACN,MAAM,QAQhB;IAED;;;;;;;;OAQG;IACH,yBANW,OAAO,WACP,MAAM,QAEN,MAAM,QAmBhB;IAED,+CAAmE;IAEnE;;;;;;OAMG;IACH,0CAHW,KAAK,CAAC,MAAM,CAAC,QAYvB;CACF"}
+{"version":3,"file":"Valid.d.ts","sourceRoot":"","sources":["../../lib/Valid.js"],"names":[],"mappings":"AAWA;;GAEG;AACH;IACE,+CAAmE;IAEnE;;;;;;OAMG;IACH,mBAJW,OAAO,QACP,MAAM,YACN,MAAM,QAQhB;IAED;;;;;;;;OAQG;IACH,yBANW,OAAO,WACP,MAAM,QAEN,MAAM,QAkBhB;IAED;;;;;;OAMG;IACH,0CAHW,KAAK,CAAC,MAAM,CAAC,QAYvB;CACF"}