@gesslar/toolkit 5.7.0 → 5.9.0

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

@@ -1,28 +1,22 @@
+/**
+ * @file Sass.js
+ *
+ * Defines the Sass class, a custom error type for toolkit compilation
+ * errors.
+ *
+ * Supports error chaining, trace management, and formatted reporting for both
+ * user-friendly and verbose (nerd) output.
+ *
+ * Used throughout the toolkit for structured error handling and
+ * debugging.
+ */
+import Tantrum from "./Tantrum.js";
 /**
  * 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;
+    #private;
     /**
      * Creates a new Sass instance.
      *
@@ -30,18 +24,18 @@ export default class Sass extends Error {
      * @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 message to the beginning of the trace array.
+     *
+     * @param {string} message - The trace message to add
+     */
+    set trace(message: string);
     /**
      * Adds a trace message and returns this instance for chaining.
      *
@@ -57,7 +51,25 @@ export default class Sass extends Error {
      * @param {boolean} [isNested] - Whether this is a nested error report
      */
     report(nerdMode?: boolean, isNested?: boolean): void;
-    #private;
+    /**
+     * 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;
 }
-import Tantrum from "./Tantrum.js";
 //# sourceMappingURL=Sass.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Sass.d.ts","sourceRoot":"","sources":["../../../src/browser/lib/Sass.js"],"names":[],"mappings":"AAeA;;;GAGG;AACH;IA8HE;;;;;;;;OAQG;IACH,mBALW,KAAK,WACL,MAAM,GACJ,IAAI,CAahB;IAED;;;;;;;;OAQG;IACH,sBAJW,MAAM,UACN,KAAK,GAAC,IAAI,GAAC,OAAO,GAChB,IAAI,CAchB;IArKD;;;;;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,QAuCjB;;CA6EF;oBA/KmB,cAAc"}
+{"version":3,"file":"Sass.d.ts","sourceRoot":"","sources":["../../../src/browser/lib/Sass.js"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,OAAO,MAAM,cAAc,CAAA;AAElC;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,IAAK,SAAQ,KAAK;;IAGrC;;;;;OAKG;IACH,YAAY,OAAO,EAHR,MAGQ,EAAE,GAAG,GAAG,AAFxB,CACF,EADa,OAAO,EAEM,EAI1B;IAED;;;;OAIG;IACH,IAAI,KAAK,IAFI,KAAK,CAAC,MAAM,CAAC,CAIzB;IAED;;;;OAIG;IACH,IAAI,KAAK,CAAC,OAAO,EAFN,MAEM,EAEhB;IAED;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAHL,MAGK,GAFH,IAAI,CAShB;IAED;;;;;;OAMG;IACH,MAAM,CAAC,QAAQ,AAHZ,CACA,EADQ,OAGU,EAAE,QAAQ,AAF5B,CACF,EADU,OAE0B,QAqCpC;IAkCD;;;;;;;;OAQG;IACH,MAAM,CAAC,IAAI,CAAC,KAAK,EALN,KAKM,EAAE,OAAO,EAJf,MAIe,GAHb,IAAI,CAahB;IAED;;;;;;;;OAQG;IACH,MAAM,CAAC,GAAG,CAAC,OAAO,EAJP,MAIO,EAAE,KAAK,AAHtB,CACA,EADQ,KAAK,GAAC,IAAI,GAAC,OAGG,GAFZ,IAAI,CAchB;CACF"}

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

@@ -1,16 +1,20 @@
+/**
+ * @file Tantrum.js
+ *
+ * Defines the Tantrum class, a custom AggregateError type for toolkit
+ * that collects multiple errors with Sass-style reporting.
+ *
+ * Auto-wraps plain Error objects in Sass instances while preserving
+ * existing Sass errors, providing consistent formatted output for
+ * multiple error scenarios.
+ */
+import Sass from "./Sass.js";
 /**
  * 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;
+    #private;
     /**
      * Creates a new Tantrum instance.
      *
@@ -27,18 +31,18 @@ export default class Tantrum extends AggregateError {
      * @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>;
+    /**
+     * Adds a message to the beginning of the trace array.
+     *
+     * @param {string} message - The trace message to add
+     */
+    set trace(message: string);
     /**
      * Reports all aggregated errors to the console with formatted output.
      *
@@ -46,7 +50,13 @@ export default class Tantrum extends AggregateError {
      * @param {boolean} [isNested] - Whether this is a nested error report
      */
     report(nerdMode?: boolean, isNested?: boolean): void;
-    #private;
+    /**
+     * 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;
 }
-import Sass from "./Sass.js";
 //# sourceMappingURL=Tantrum.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Tantrum.d.ts","sourceRoot":"","sources":["../../../src/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"}
+{"version":3,"file":"Tantrum.d.ts","sourceRoot":"","sources":["../../../src/browser/lib/Tantrum.js"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAA;AAE5B;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,OAAQ,SAAQ,cAAc;;IAIjD;;;;;;OAMG;IACH,YAAY,OAAO,EAJR,MAIQ,EAAE,MAAM,GAHhB,KAAK,CAAC,KAAK,GAAC,IAAI,CAGK,EAAE,IAAI,GAF3B,IAEgC,EAgB1C;IAED;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,EAJL,MAIK,EAAE,MAAM,AAHrB,CACA,EADQ,KAAK,GAAC,IAGO,GAFX,IAAI,CAShB;IAED;;;;OAIG;IACH,IAAI,KAAK,IAFI,KAAK,CAAC,MAAM,CAAC,CAIzB;IAED;;;;OAIG;IACH,IAAI,KAAK,CAAC,OAAO,EAFN,MAEM,EAEhB;IAED;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,AAHZ,CACA,EADQ,OAGY,EAAE,QAAQ,AAF9B,CACF,EADU,OAE8B,QAiBxC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,GAAG,CAAC,OAAO,EAJP,MAIO,EAAE,MAAM,GAHf,KAAK,CAAC,KAAK,GAAC,IAAI,CAGI,GAFlB,OAAO,CAOnB;CACF"}

package/types/browser/lib/Time.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Time.d.ts","sourceRoot":"","sources":["../../../src/browser/lib/Time.js"],"names":[],"mappings":"AAGA;;;GAGG;AACH;IACE;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACH,oBAzBW,MAAM,UACN,OAAO,GACL,OAAO,CAAC,OAAO,CAAC,GAAG;QAAC,OAAO,EAAE,MAAM,CAAA;KAAC,CA0ChD;IAED;;;;;;;;;OASG;IACH,uBANW,OAAO,CAAC,OAAO,CAAC,GAAG;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAC,GACnC,IAAI,CAQhB;CACF"}
+{"version":3,"file":"Time.d.ts","sourceRoot":"","sources":["../../../src/browser/lib/Time.js"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,IAAI;IACvB;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACH,MAAM,CAAC,KAAK,CAAC,KAAK,EAzBP,MAyBO,EAAE,KAAK,AAxBtB,CACA,EADQ,OAwBc,GAvBZ,OAAO,CAAC,OAAO,CAAC,GAAG;QAAC,OAAO,EAAE,MAAM,CAAA;KAAC,CA0ChD;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,MAAM,CAAC,OAAO,EANV,OAAO,CAAC,OAAO,CAAC,GAAG;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAM1B,GALR,IAAI,CAQhB;CACF"}

package/types/browser/lib/TypeSpec.d.ts

@@ -1,17 +1,29 @@
+/**
+ * @file Type specification and validation utilities.
+ * Provides TypeSpec class for parsing and validating complex type specifications
+ * including arrays, unions, and options.
+ */
+export type TypeMatchOptions = {
+    /**
+     * - Permit a spec of {@link Data.emptyableTypes} to be empty
+     */
+    allowEmpty?: boolean;
+};
 /**
  * Type specification class for parsing and validating complex type definitions.
  * Supports union types, array types, and validation options.
  */
 export default class TypeSpec {
+    #private;
+    specs: any;
+    length: any;
+    stringRepresentation: string;
     /**
      * Creates a new TypeSpec instance.
      *
      * @param {string} string - The type specification string (e.g., "string|number", "object[]")
      */
     constructor(string: string);
-    specs: any[];
-    length: number;
-    stringRepresentation: string;
     /**
      * Returns a string representation of the type specification.
      *
@@ -29,35 +41,35 @@ export default class TypeSpec {
      *
      * @param {function(unknown): void} callback - Function to execute for each spec
      */
-    forEach(callback: (arg0: unknown) => void): void;
+    forEach(callback: Function): void;
     /**
      * Tests whether all type specifications pass the provided test function.
      *
      * @param {function(unknown): boolean} callback - Function to test each spec
      * @returns {boolean} True if all specs pass the test
      */
-    every(callback: (arg0: unknown) => boolean): boolean;
+    every(callback: Function): boolean;
     /**
      * Tests whether at least one type specification passes the provided test function.
      *
      * @param {function(unknown): boolean} callback - Function to test each spec
      * @returns {boolean} True if at least one spec passes the test
      */
-    some(callback: (arg0: unknown) => boolean): boolean;
+    some(callback: Function): boolean;
     /**
      * Creates a new array with all type specifications that pass the provided test function.
      *
      * @param {function(unknown): boolean} callback - Function to test each spec
      * @returns {Array<unknown>} New array with filtered specs
      */
-    filter(callback: (arg0: unknown) => boolean): Array<unknown>;
+    filter(callback: Function): Array<unknown>;
     /**
      * Creates a new array populated with the results of calling the provided function on every spec.
      *
      * @param {function(unknown): unknown} callback - Function to call on each spec
      * @returns {Array<unknown>} New array with mapped values
      */
-    map(callback: (arg0: unknown) => unknown): Array<unknown>;
+    map(callback: Function): Array<unknown>;
     /**
      * Executes a reducer function on each spec, resulting in a single output value.
      *
@@ -65,14 +77,14 @@ export default class TypeSpec {
      * @param {unknown} initialValue - Initial value for the accumulator
      * @returns {unknown} The final accumulated value
      */
-    reduce(callback: (arg0: unknown, arg1: unknown) => unknown, initialValue: unknown): unknown;
+    reduce(callback: Function, initialValue: unknown): unknown;
     /**
      * Returns the first type specification that satisfies the provided testing function.
      *
      * @param {function(unknown): boolean} callback - Function to test each spec
      * @returns {object|undefined} The first spec that matches, or undefined
      */
-    find(callback: (arg0: unknown) => boolean): object | undefined;
+    find(callback: Function): object | undefined;
     /**
      * Tests whether a value matches any of the type specifications.
      * Handles array types, union types, and empty value validation.
@@ -81,12 +93,7 @@ export default class TypeSpec {
      * @param {TypeMatchOptions} [options] - Validation options
      * @returns {boolean} True if the value matches any type specification
      */
-    matches(value: unknown, options?: {
-        /**
-         * - Permit a spec of {@link Data.emptyableTypes} to be empty
-         */
-        allowEmpty?: boolean;
-    }): boolean;
+    matches(value: unknown, options?: TypeMatchOptions): boolean;
     /**
      * Options that can be passed to {@link TypeSpec.match}
      *
@@ -100,12 +107,15 @@ export default class TypeSpec {
      * @param {TypeMatchOptions} [options] - Validation options
      * @returns {Array<object>} Array of matching type specifications
      */
-    match(value: unknown, { allowEmpty, }?: {
-        /**
-         * - Permit a spec of {@link Data.emptyableTypes} to be empty
-         */
-        allowEmpty?: boolean;
-    }): Array<object>;
-    #private;
+    match(value: unknown, { allowEmpty, }?: TypeMatchOptions): Array<object>;
+    /**
+     * Parses a type specification string into individual type specs.
+     * Handles union types separated by delimiters and array notation.
+     *
+     * @private
+     * @param {string} string - The type specification string to parse
+     * @throws {Sass} If the type specification is invalid
+     */
+    private #parse;
 }
 //# sourceMappingURL=TypeSpec.d.ts.map

package/types/browser/lib/TypeSpec.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TypeSpec.d.ts","sourceRoot":"","sources":["../../../src/browser/lib/TypeSpec.js"],"names":[],"mappings":"AAWA;;;GAGG;AACH;IAGE;;;;OAIG;IACH,oBAFW,MAAM,EAUhB;IAJC,aAAwB;IACxB,eAAgC;IAChC,6BAA2C;IAI7C;;;;OAIG;IACH,YAFa,MAAM,CAkBlB;IAED;;;;OAIG;IACH,UAFa,OAAO,CASnB;IAED;;;;OAIG;IACH,kBAFW,CAAS,IAAO,EAAP,OAAO,KAAG,IAAI,QAIjC;IAED;;;;;OAKG;IACH,gBAHW,CAAS,IAAO,EAAP,OAAO,KAAG,OAAO,GACxB,OAAO,CAInB;IAED;;;;;OAKG;IACH,eAHW,CAAS,IAAO,EAAP,OAAO,KAAG,OAAO,GACxB,OAAO,CAInB;IAED;;;;;OAKG;IACH,iBAHW,CAAS,IAAO,EAAP,OAAO,KAAG,OAAO,GACxB,KAAK,CAAC,OAAO,CAAC,CAI1B;IAED;;;;;OAKG;IACH,cAHW,CAAS,IAAO,EAAP,OAAO,KAAG,OAAO,GACxB,KAAK,CAAC,OAAO,CAAC,CAI1B;IAED;;;;;;OAMG;IACH,iBAJW,CAAS,IAAO,EAAP,OAAO,EAAE,IAAO,EAAP,OAAO,KAAG,OAAO,gBACnC,OAAO,GACL,OAAO,CAInB;IAED;;;;;OAKG;IACH,eAHW,CAAS,IAAO,EAAP,OAAO,KAAG,OAAO,GACxB,MAAM,GAAC,SAAS,CAI5B;IAED;;;;;;;OAOG;IACH,eAJW,OAAO;;;;qBAYJ,OAAO;QAVR,OAAO,CAInB;IAED;;;;;OAKG;IAEH;;;;;;OAMG;IACH,aAJW,OAAO;;;;qBANJ,OAAO;QAQR,KAAK,CAAC,MAAM,CAAC,CAsGzB;;CAqFF"}
+{"version":3,"file":"TypeSpec.d.ts","sourceRoot":"","sources":["../../../src/browser/lib/TypeSpec.js"],"names":[],"mappings":"AAAA;;;;GAIG;AAuJE,YAAkB,gBAAgB,GAClC;;;;IAAqB,UAAU,AAA/B,CACF,EADa,OAAO,CACpB;CAAA,CAAA;AAlJH;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,QAAQ;;IAYpB,KAAK;IACL,MAAM;IACN,oBAAoB;IAX3B;;;;OAIG;IACH,YAAY,MAAM,EAFP,MAEO,EAQjB;IAED;;;;OAIG;IACH,QAAQ,IAFK,MAAM,CAkBlB;IAED;;;;OAIG;IACH,MAAM,IAFO,OAAO,CASnB;IAED;;;;OAIG;IACH,OAAO,CAAC,QAAQ,UAAA,QAEf;IAED;;;;;OAKG;IACH,KAAK,CAAC,QAAQ,UAAA,GAFD,OAAO,CAInB;IAED;;;;;OAKG;IACH,IAAI,CAAC,QAAQ,UAAA,GAFA,OAAO,CAInB;IAED;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,UAAA,GAFF,KAAK,CAAC,OAAO,CAAC,CAI1B;IAED;;;;;OAKG;IACH,GAAG,CAAC,QAAQ,UAAA,GAFC,KAAK,CAAC,OAAO,CAAC,CAI1B;IAED;;;;;;OAMG;IACH,MAAM,CAAC,QAAQ,UAAA,EAAE,YAAY,EAHlB,OAGkB,GAFhB,OAAO,CAInB;IAED;;;;;OAKG;IACH,IAAI,CAAC,QAAQ,UAAA,GAFA,MAAM,GAAC,SAAS,CAI5B;IAED;;;;;;;OAOG;IACH,OAAO,CAAC,KAAK,EAJF,OAIE,EAAE,OAAO,AAHnB,CACA,EADQ,gBAGW,GAFT,OAAO,CAInB;IAED;;;;;OAKG;IAEH;;;;;;OAMG;IACH,KAAK,CAAC,KAAK,EAJA,OAIA,EAAE,EACX,UAAiB,GAClB,AALE,CACA,EADQ,gBAKL,GAJO,KAAK,CAAC,MAAM,CAAC,CAsGzB;IAED;;;;;;;OAOG;YACH,MAAM;CA2EP"}

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

@@ -1 +1 @@
-{"version":3,"file":"Util.d.ts","sourceRoot":"","sources":["../../../src/browser/lib/Util.js"],"names":[],"mappings":"AAGA;;;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,8BAJW,MAAM,KACN,MAAM,GACJ,MAAM,CAsBlB;IAED;;;;;;;;OAQG;IACH,+BALW,MAAM,iBACN,KAAK,CAAC,MAAM,CAAC,cACb,MAAM,GACJ,MAAM,CAwBlB;IAED,mEAkBC;IAED;;;;MAqCC;CACF"}
+{"version":3,"file":"Util.d.ts","sourceRoot":"","sources":["../../../src/browser/lib/Util.js"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,IAAI;IACvB;;;;;OAKG;IACH,MAAM,CAAC,UAAU,CAAC,IAAI,EAHX,MAGW,GAFT,MAAM,CAYlB;IAED;;;;;;OAMG;IACH,OAAa,IAAI,CAJJ,CAAC,EAII,EAAE,EAHT,MAAM,OAAO,CAAC,CAAC,CAGN,GAFP,OAAO,CAAC;QAAC,MAAM,EAAE,CAAC,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAC,CAAC,CAQ9C;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,cAAc,CAAC,IAAI,EAJf,MAAM,GAAC,MAIQ,EAAE,KAAK,GAHtB,MAGyB,GAFvB,MAAM,CAWlB;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,eAAe,CAAC,IAAI,EAJhB,MAAM,GAAC,MAIS,EAAE,KAAK,GAHvB,MAG0B,GAFxB,MAAM,CAalB;IAED;;;;;;OAMG;IACH,MAAM,CAAC,mBAAmB,CAAC,CAAC,EAJjB,MAIiB,EAAE,CAAC,EAHpB,MAGoB,GAFlB,MAAM,CAsBlB;IAED;;;;;;;;OAQG;IACH,MAAM,CAAC,gBAAgB,CAAC,KAAK,EALlB,MAKkB,EAAE,aAAa,EAJjC,KAAK,CAAC,MAAM,CAIqB,EAAE,SAAS,AAHpD,CACA,EADQ,MAG8C,GAF5C,MAAM,CAwBlB;IAED,MAAM,CAAC,QAAQ,CAAC,KAAK,KAAA,EAAE,IAAI,UAAK,EAAE,KAAK,QAAG,UAkBzC;IAED,MAAM,CAAC,MAAM;;;;MAqCZ;CACF"}

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

@@ -1,3 +1,16 @@
+/**
+ * @file Valid.js
+ *
+ * Provides validation utilities for type checking and assertion.
+ * Includes prototype pollution protection for secure object manipulation.
+ */
+import Sass from "./Sass.js";
+export type TypeValidationOptions = {
+    /**
+     * - Whether empty values are allowed
+     */
+    allowEmpty?: boolean;
+};
 /**
  * Options for type validation methods.
  *
@@ -8,6 +21,7 @@
  * Validation utility class providing type checking and assertion methods.
  */
 export default class Valid {
+    #private;
     /** @type {typeof Sass} */
     static _Sass: typeof Sass;
     /**
@@ -28,7 +42,6 @@ export default class Valid {
      *                         met (optional)
      */
     static assert(condition: boolean, message: string, arg?: number): void;
-    static #restrictedProto: readonly string[];
     /**
      * Protects against prototype pollution by checking keys for dangerous property names.
      * Throws if any restricted prototype properties are found in the keys array.
@@ -38,14 +51,4 @@ export default class Valid {
      */
     static prototypePollutionProtection(keys: Array<string>): void;
 }
-/**
- * Options for type validation methods.
- */
-export type TypeValidationOptions = {
-    /**
-     * - Whether empty values are allowed
-     */
-    allowEmpty?: boolean;
-};
-import Sass from "./Sass.js";
 //# sourceMappingURL=Valid.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Valid.d.ts","sourceRoot":"","sources":["../../../src/browser/lib/Valid.js"],"names":[],"mappings":"AAWA;;;;;GAKG;AAEH;;GAEG;AACH;IACE,0BAA0B;IAC1B,cADW,OAAO,IAAI,CACH;IAEnB;;;;;;OAMG;IACH,mBAJW,OAAO,QACP,MAAM,YACN,qBAAqB,QAY/B;IAED;;;;;;;;OAQG;IACH,yBANW,OAAO,WACP,MAAM,QAEN,MAAM,QAehB;IAED,2CAAkF;IAElF;;;;;;OAMG;IACH,0CAHW,KAAK,CAAC,MAAM,CAAC,QAcvB;CACF;;;;;;;;iBAzEa,OAAO;;iBARJ,WAAW"}
+{"version":3,"file":"Valid.d.ts","sourceRoot":"","sources":["../../../src/browser/lib/Valid.js"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAA;AAOzB,YAAkB,qBAAqB,GACvC;;;;IAAqB,UAAU,AAA/B,CACF,EADa,OAAO,CACpB;CAAA,CAAA;AALD;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,KAAK;;IACxB,0BAA0B;IAC1B,MAAM,CAAC,KAAK,EADD,OAAO,IAAI,CACH;IAEnB;;;;;;OAMG;IACH,MAAM,CAAC,IAAI,CAAC,KAAK,EAJN,OAIM,EAAE,IAAI,EAHZ,MAGY,EAAE,OAAO,AAF7B,CACF,EADU,qBAEqB,QAU/B;IAED;;;;;;;;OAQG;IACH,MAAM,CAAC,MAAM,CAAC,SAAS,EANZ,OAMY,EAAE,OAAO,EALrB,MAKqB,EAAE,GAAG,AAHlC,CAEF,EAFU,MAGiC,QAY3C;IAID;;;;;;OAMG;IACH,MAAM,CAAC,4BAA4B,CAAC,IAAI,EAH7B,KAAK,CAAC,MAAM,CAGiB,QAWvC;CACF"}

package/types/browser/lib/vendor/dompurify.esm.d.ts

@@ -1,29 +1,17 @@
-export { purify as default };
-declare function purify(root: any): {
+/*! @license DOMPurify 3.3.0 | (c) Cure53 and other contributors | Released under the Apache license 2.0 and Mozilla Public License 2.0 | github.com/cure53/DOMPurify/blob/3.3.0/LICENSE */
+declare var purify: {
     (root: any): /*elided*/ any;
     version: string;
     removed: any[];
     isSupported: boolean;
-    sanitize(dirty: any, ...args: any[]): any;
-    setConfig(...args: any[]): void;
-    clearConfig(): void;
-    isValidAttribute(tag: any, attr: any, value: any): boolean;
-    addHook(entryPoint: any, hookFunction: any): void;
-    removeHook(entryPoint: any, hookFunction: any): any;
-    removeHooks(entryPoint: any): void;
-    removeAllHooks(): void;
+    sanitize: (dirty: any) => any;
+    setConfig: () => void;
+    clearConfig: () => void;
+    isValidAttribute: (tag: any, attr: any, value: any) => boolean;
+    addHook: (entryPoint: any, hookFunction: any) => void;
+    removeHook: (entryPoint: any, hookFunction: any) => any;
+    removeHooks: (entryPoint: any) => void;
+    removeAllHooks: () => void;
 };
-declare namespace purify {
-    let version: string;
-    let removed: any[];
-    let isSupported: boolean;
-    function sanitize(dirty: any, ...args: any[]): any;
-    function setConfig(...args: any[]): void;
-    function clearConfig(): void;
-    function isValidAttribute(tag: any, attr: any, value: any): boolean;
-    function addHook(entryPoint: any, hookFunction: any): void;
-    function removeHook(entryPoint: any, hookFunction: any): any;
-    function removeHooks(entryPoint: any): void;
-    function removeAllHooks(): void;
-}
+export { purify as default };
 //# sourceMappingURL=dompurify.esm.d.ts.map

package/types/browser/lib/vendor/dompurify.esm.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dompurify.esm.d.ts","sourceRoot":"","sources":["../../../../src/browser/lib/vendor/dompurify.esm.js"],"names":[],"mappings":";AA0UE;;;;;;;;;;;;;EAA+C;;;;;IA+9B/C,mDAiJC;IACD,yCAIC;IACD,6BAGC;IACD,oEAUC;IACD,2DAMC;IACD,6DAQC;IACD,4CAEC;IACD,gCAEC"}
+{"version":3,"file":"dompurify.esm.d.ts","sourceRoot":"","sources":["../../../../src/browser/lib/vendor/dompurify.esm.js"],"names":[],"mappings":"AAAA,2LAA2L;AAw+C3L,QAAA,IAAI,MAAM;;;;;;;;;;;;;CAAoB,CAAA;AAE9B,OAAO,EAAC,MAAM,IAAI,OAAO,EAAC,CAAA"}

package/types/node/index.d.ts

@@ -1,5 +1,7 @@
 export { default as Collection } from "../browser/lib/Collection.js";
 export { default as Data } from "./lib/Data.js";
+export { default as Disposer } from "../browser/lib/Disposer.js";
+export { Disposer as DisposerClass } from "../browser/lib/Disposer.js";
 export { default as Promised } from "../browser/lib/Promised.js";
 export { default as Time } from "../browser/lib/Time.js";
 export { default as Type } from "../browser/lib/TypeSpec.js";
@@ -13,8 +15,8 @@ export { default as FileObject } from "./lib/FileObject.js";
 export { default as FileSystem } from "./lib/FileSystem.js";
 export { default as Font } from "./lib/Font.js";
 export { default as Glog } from "./lib/Glog.js";
+export { default as Notify } from "./lib/Notify.js";
+export { Notify as NotifyClass } from "./lib/Notify.js";
 export { default as Term } from "./lib/Term.js";
-export { default as Disposer, Disposer as DisposerClass } from "../browser/lib/Disposer.js";
-export { default as Notify, Notify as NotifyClass } from "./lib/Notify.js";
 export { default as Watcher, OverFlowBehaviour } from "./lib/Watcher.js";
 //# sourceMappingURL=index.d.ts.map

package/types/node/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/node/index.js"],"names":[],"mappings":""}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/node/index.js"],"names":[],"mappings":"AACA,OAAO,EAAC,OAAO,IAAI,UAAU,EAAC,MAAM,8BAA8B,CAAA;AAClE,OAAO,EAAC,OAAO,IAAI,IAAI,EAAC,MAAM,eAAe,CAAA;AAC7C,OAAO,EAAC,OAAO,IAAI,QAAQ,EAAC,MAAM,4BAA4B,CAAA;AAC9D,OAAO,EAAC,QAAQ,IAAI,aAAa,EAAC,MAAM,4BAA4B,CAAA;AACpE,OAAO,EAAC,OAAO,IAAI,QAAQ,EAAC,MAAM,4BAA4B,CAAA;AAC9D,OAAO,EAAC,OAAO,IAAI,IAAI,EAAC,MAAM,wBAAwB,CAAA;AACtD,OAAO,EAAC,OAAO,IAAI,IAAI,EAAC,MAAM,4BAA4B,CAAA;AAC1D,OAAO,EAAC,OAAO,IAAI,KAAK,EAAC,MAAM,gBAAgB,CAAA;AAG/C,OAAO,EAAC,OAAO,IAAI,IAAI,EAAC,MAAM,eAAe,CAAA;AAC7C,OAAO,EAAC,OAAO,IAAI,OAAO,EAAC,MAAM,kBAAkB,CAAA;AACnD,OAAO,EAAC,OAAO,IAAI,IAAI,EAAC,MAAM,eAAe,CAAA;AAG7C,OAAO,EAAC,OAAO,IAAI,KAAK,EAAC,MAAM,gBAAgB,CAAA;AAC/C,OAAO,EAAC,OAAO,IAAI,eAAe,EAAC,MAAM,0BAA0B,CAAA;AACnE,OAAO,EAAC,OAAO,IAAI,UAAU,EAAC,MAAM,qBAAqB,CAAA;AACzD,OAAO,EAAC,OAAO,IAAI,UAAU,EAAC,MAAM,qBAAqB,CAAA;AACzD,OAAO,EAAC,OAAO,IAAI,IAAI,EAAC,MAAM,eAAe,CAAA;AAC7C,OAAO,EAAC,OAAO,IAAI,IAAI,EAAC,MAAM,eAAe,CAAA;AAC7C,OAAO,EAAC,OAAO,IAAI,MAAM,EAAC,MAAM,iBAAiB,CAAA;AACjD,OAAO,EAAC,MAAM,IAAI,WAAW,EAAC,MAAM,iBAAiB,CAAA;AACrD,OAAO,EAAC,OAAO,IAAI,IAAI,EAAC,MAAM,eAAe,CAAA;AAC7C,OAAO,EAAC,OAAO,IAAI,OAAO,EAAE,iBAAiB,EAAC,MAAM,kBAAkB,CAAA"}

package/types/node/lib/Cache.d.ts

@@ -1,3 +1,10 @@
+import type FileObject from "./FileObject.js";
+export type CacheDataType = "raw" | "structured";
+export type CacheData = {
+    modified: Date;
+    raw: string | null;
+    structured: unknown;
+};
 /**
  * @import FileObject from "./FileObject.js"
  */
@@ -17,6 +24,62 @@
  * through modification time checking.
  */
 export default class Cache {
+    #private;
+    /**
+     * Removes cached data for a specific file from the #cache map.
+     * Used when files are modified or when cache consistency needs to be
+     * maintained.
+     *
+     * @private
+     * @param {FileObject} file - The file object to remove from cache
+     * @returns {undefined}
+     */
+    private #cleanup;
+    /**
+     * Internal cache loader that reads raw content via FileObject and
+     * optionally parses it, using mtime-based invalidation to serve cached
+     * results when possible.
+     *
+     * @private
+     * @param {FileObject} fileObject - The file object to load
+     * @param {CacheDataType} kind - Whether to return "raw" text or
+     *   "structured" parsed data
+     * @param {object} [options] - Options forwarded to read/parse
+     * @param {string} [options.encoding="utf8"] - File encoding
+     * @param {string} [options.type="any"] - Data format for parsing
+     * @returns {Promise<unknown>} The cached or freshly loaded data
+     * @throws {Sass} If the file does not exist
+     */
+    private #loadFromCache;
+    /**
+     * Resolves the cache record for a file at a given modification time,
+     * reading from disk when no record exists or the existing one is stale.
+     *
+     * Concurrent callers asking for the same file at the same mtime share a
+     * single read, and a record only enters the map once its contents are in
+     * hand. Without both of those, a second caller arriving while the first is
+     * still awaiting the read would find a record already stamped with the new
+     * mtime but still holding the previous revision's data, and happily return
+     * it as fresh.
+     *
+     * @private
+     * @param {FileObject} fileObject - The file object to resolve
+     * @param {Date} lastModified - The file's current modification time
+     * @param {object} options - Options forwarded to read
+     * @returns {Promise<CacheData>} The populated cache record
+     */
+    private #record;
+    /**
+     * Reads a file from disk and publishes it as a cache record.
+     *
+     * @private
+     * @param {FileObject} fileObject - The file object to read
+     * @param {Date} lastModified - The modification time the read represents
+     * @param {object} options - Options forwarded to read
+     * @param {string} [options.encoding="utf8"] - File encoding
+     * @returns {Promise<CacheData>} The freshly populated cache record
+     */
+    private #read;
     /**
      * Loads and caches parsed file data with automatic invalidation based on
      * modification time.
@@ -46,13 +109,5 @@ export default class Cache {
      * @param {import("./FileObject.js").default} file - The file object to clear from cache
      */
     resetCache(file: import("./FileObject.js").default): void;
-    #private;
 }
-export type CacheDataType = "raw" | "structured";
-export type CacheData = {
-    modified: Date;
-    raw: string | null;
-    structured: unknown;
-};
-import type FileObject from "./FileObject.js";
 //# sourceMappingURL=Cache.d.ts.map

package/types/node/lib/Cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Cache.d.ts","sourceRoot":"","sources":["../../../src/node/lib/Cache.js"],"names":[],"mappings":"AAIA;;GAEG;AAEH;;GAEG;AAEH;;GAEG;AAEH;;;;;;;;GAQG;AACH;IAuEE;;;;;;;;;;;;OAYG;IACH,8BAJW,UAAU,iBACR,OAAO,CAAC,OAAO,CAAC,CAQ5B;IAED;;;;;;;OAOG;IACH,0BAJW,UAAU,iBACR,OAAO,CAAC,MAAM,CAAC,CAQ3B;IAED;;;;OAIG;IACH,iBAFW,OAAO,iBAAiB,EAAE,OAAO,QAM3C;;CACF;4BApIY,KAAK,GAAG,YAAY;wBAIpB;IAAC,QAAQ,EAAE,IAAI,CAAC;IAAC,GAAG,EAAE,MAAM,GAAC,IAAI,CAAC;IAAC,UAAU,EAAE,OAAO,CAAA;CAAC;4BARzC,iBAAiB"}
+{"version":3,"file":"Cache.d.ts","sourceRoot":"","sources":["../../../src/node/lib/Cache.js"],"names":[],"mappings":"AAKG,OAAQ,KAAA,UAAU,MAAM,iBAAiB,CAAA;AAIzC,YAAgC,aAAa,GAAnC,KAAK,GAAG,YAAY,CAAe;AAI7C,YAAmE,SAAS,GAAlE;IAAC,QAAQ,EAAE,IAAI,CAAC;IAAC,GAAG,EAAE,MAAM,GAAC,IAAI,CAAC;IAAC,UAAU,EAAE,OAAO,CAAA;CAAC,CAAW;AAT/E;;GAEG;AAEH;;GAEG;AAEH;;GAEG;AAEH;;;;;;;;GAQG;AACH,MAAM,CAAC,OAAO,OAAO,KAAK;;IAYxB;;;;;;;;OAQG;YACH,QAAQ;IAIR;;;;;;;;;;;;;;OAcG;YACG,cAAc;IAqBpB;;;;;;;;;;;;;;;;OAgBG;YACG,OAAO;IAmBb;;;;;;;;;OASG;YACG,KAAK;IAgBX;;;;;;;;;;;;OAYG;IACG,iBAAiB,CAAC,UAAU,EAJvB,UAIuB,EAAE,OAAO,KAAG,GAHjC,OAAO,CAAC,OAAO,CAAC,CAQ5B;IAED;;;;;;;OAOG;IACG,aAAa,CAAC,UAAU,EAJnB,UAImB,EAAE,OAAO,KAAG,GAH7B,OAAO,CAAC,MAAM,CAAC,CAQ3B;IAED;;;;OAIG;IACH,UAAU,CAAC,IAAI,EAFJ,OAAO,iBAAiB,EAAE,OAEtB,QAId;CACF"}

package/types/node/lib/Data.d.ts

@@ -1,19 +1,29 @@
+import JSON5 from "json5";
+import YAML from "yaml";
+import BrowserData from "../../browser/lib/Data.js";
 /**
  * Node-side extension of Data with parsing utilities that require
  * node-specific dependencies.
  */
 export default class Data extends BrowserData {
+    static LOAD_DATA_TYPES: Readonly<{
+        json: readonly JSON[];
+        json5: readonly (typeof JSON5)[];
+        yaml: readonly (typeof YAML)[];
+    }>;
     /**
-     * Parses text content as structured data (JSON5 or YAML).
+     * Parses text content as structured data (JSON, JSON5, or YAML).
+     *
+     * The `json` type uses strict JSON parsing and will NOT accept JSON5
+     * extensions (comments, trailing commas, unquoted keys); use `json5` for
+     * that. The `any` type tries each format from least to most permissive.
      *
      * @param {string} source - The text content to parse
-     * @param {string} [type="any"] - The expected format ("json",
-     *   "json5", "yaml", or "any")
+     * @param {string} [type="any"] - The expected format ("json", "json5",
+     *  "yaml", or "any")
      * @returns {unknown} The parsed data
-     * @throws {Sass} If content cannot be parsed or type is
-     *   unsupported
+     * @throws {Sass} If content cannot be parsed or type is unsupported
      */
     static textAsData(source: string, type?: string): unknown;
 }
-import BrowserData from "../../browser/lib/Data.js";
 //# sourceMappingURL=Data.d.ts.map

package/types/node/lib/Data.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Data.d.ts","sourceRoot":"","sources":["../../../src/node/lib/Data.js"],"names":[],"mappings":"AAKA;;;GAGG;AACH;IACE;;;;;;;;;OASG;IACH,0BAPW,MAAM,SACN,MAAM,GAEJ,OAAO,CA+BnB;CACF;wBA9CuB,2BAA2B"}
+{"version":3,"file":"Data.d.ts","sourceRoot":"","sources":["../../../src/node/lib/Data.js"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,IAAI,MAAM,MAAM,CAAA;AACvB,OAAO,WAAW,MAAM,2BAA2B,CAAA;AAInD;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,IAAK,SAAQ,WAAW;IAC3C,MAAM,CAAC,eAAe;;;;OAIpB;IAEF;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,UAAU,CAAC,MAAM,EANb,MAMa,EAAE,IAAI,AAL3B,CAEA,EAFQ,MAKyB,GAHvB,OAAO,CAqCnB;CACF"}