@gesslar/toolkit 5.8.0 → 5.9.0

package/package.json

@@ -5,7 +5,7 @@
     "name": "gesslar",
     "url": "https://gesslar.dev"
   },
-  "version": "5.8.0",
+  "version": "5.9.0",
   "license": "0BSD",
   "homepage": "https://github.com/gesslar/toolkit#readme",
   "repository": {
@@ -65,7 +65,7 @@
     "lint": "eslint src/",
     "lint:fix": "eslint src/ --fix",
     "submit": "npm publish --access public --//registry.npmjs.org/:_authToken=\"${NPM_ACCESS_TOKEN}\"",
-    "update": "npx npm-check-updates -u && npm install",
+    "update": "npx -y npm-check-updates -u && npm install",
     "test": "node --test tests/**/*.test.js",
     "test:coverage": "node --experimental-config-file=node.config.json --experimental-test-coverage --test-timeout=3000 --test tests/**/*.test.js",
     "test:node": "node --test tests/node/*.test.js",
@@ -84,9 +84,9 @@
   "devDependencies": {
     "@gesslar/uglier": "^2.4.1",
     "@rollup/plugin-node-resolve": "^16.0.3",
-    "eslint": "^10.4.1",
-    "happy-dom": "^20.10.2",
-    "rollup": "^4.61.1",
-    "typescript": "^6.0.3"
+    "eslint": "^10.8.0",
+    "happy-dom": "^20.11.1",
+    "rollup": "^4.62.2",
+    "typescript": "^7.0.2"
   }
 }

package/src/node/lib/Cache.js

@@ -27,6 +27,14 @@ export default class Cache {
   /** @type {Map<string, CacheData>} Map of file paths to cached data */
   #cache = new Map()
 
+  /**
+   * In-flight reads, keyed by file path and modification time, so that
+   * concurrent callers coalesce onto one read instead of racing each other.
+   *
+   * @type {Map<string, Promise<CacheData>>}
+   */
+  #reading = new Map()
+
   /**
    * Removes cached data for a specific file from the #cache map.
    * Used when files are modified or when cache consistency needs to be
@@ -64,34 +72,78 @@ export default class Cache {
     if(lastModified === null)
       throw Sass.new(`No such file '${fileObject}'`)
 
-    const rec = this.#cache.get(fileObject.path) ?? Object.seal({
-      modified: new Date(0),
-      raw: null,
-      structured: null,
-    })
+    const rec = await this.#record(fileObject, lastModified, options)
+
+    if(kind === "raw")
+      return rec.raw
+
+    // Parsing is synchronous, so a record can never be observed with raw
+    // content from one revision and structured data from another.
+    rec.structured ??= Data.textAsData(rec.raw, options.type)
+
+    return rec.structured
+  }
+
+  /**
+   * 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
+   */
+  async #record(fileObject, lastModified, options) {
+    const cached = this.#cache.get(fileObject.path)
+
+    if(cached && cached.modified.getTime() === lastModified.getTime())
+      return cached
 
-    if(lastModified.getTime() === rec.modified.getTime()) {
-      if(kind === "raw" && rec.raw !== null)
-        return rec.raw
+    const key = `${fileObject.path}\u0000${lastModified.getTime()}`
+    let reading = this.#reading.get(key)
 
-      if(kind === "structured" && rec.structured !== null)
-        return rec.structured
+    if(!reading) {
+      reading = this.#read(fileObject, lastModified, options)
+        .finally(() => this.#reading.delete(key))
+
+      this.#reading.set(key, reading)
     }
 
-    this.#cache.set(fileObject.path, rec)
-    rec.modified = lastModified
-    rec.raw = await fileObject.read({
+    return await reading
+  }
+
+  /**
+   * 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
+   */
+  async #read(fileObject, lastModified, options) {
+    const raw = await fileObject.read({
       encoding: options.encoding,
       skipCache: true,
     })
-    rec.structured = null
 
-    if(kind === "raw")
-      return rec.raw
+    const rec = Object.seal({modified: lastModified, raw, structured: null})
+    const cached = this.#cache.get(fileObject.path)
 
-    rec.structured = Data.textAsData(rec.raw, options.type)
+    // Don't let a slower read of an older revision clobber a newer one.
+    if(!cached || cached.modified.getTime() <= lastModified.getTime())
+      this.#cache.set(fileObject.path, rec)
 
-    return rec.structured
+    return rec
   }
 
   /**

package/types/browser/index.d.ts

@@ -1,5 +1,11 @@
 export { default as Collection } from "./lib/Collection.js";
 export { default as Data } from "./lib/Data.js";
+export { default as Disposer } from "./lib/Disposer.js";
+export { Disposer as DisposerClass } from "./lib/Disposer.js";
+export { default as HTML } from "./lib/HTML.js";
+export { HTML as HTMLClass } from "./lib/HTML.js";
+export { default as Notify } from "./lib/Notify.js";
+export { Notify as NotifyClass } from "./lib/Notify.js";
 export { default as Promised } from "./lib/Promised.js";
 export { default as Sass } from "./lib/Sass.js";
 export { default as Tantrum } from "./lib/Tantrum.js";
@@ -7,7 +13,4 @@ export { default as Time } from "./lib/Time.js";
 export { default as Type } from "./lib/TypeSpec.js";
 export { default as Util } from "./lib/Util.js";
 export { default as Valid } from "./lib/Valid.js";
-export { default as Disposer, Disposer as DisposerClass } from "./lib/Disposer.js";
-export { default as HTML, HTML as HTMLClass } from "./lib/HTML.js";
-export { default as Notify, Notify as NotifyClass } from "./lib/Notify.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/browser/index.js"],"names":[],"mappings":""}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/browser/index.js"],"names":[],"mappings":"AAGA,OAAO,EAAC,OAAO,IAAI,UAAU,EAAC,MAAM,qBAAqB,CAAA;AACzD,OAAO,EAAC,OAAO,IAAI,IAAI,EAAC,MAAM,eAAe,CAAA;AAC7C,OAAO,EAAC,OAAO,IAAI,QAAQ,EAAC,MAAM,mBAAmB,CAAA;AACrD,OAAO,EAAC,QAAQ,IAAI,aAAa,EAAC,MAAM,mBAAmB,CAAA;AAC3D,OAAO,EAAC,OAAO,IAAI,IAAI,EAAC,MAAM,eAAe,CAAA;AAC7C,OAAO,EAAC,IAAI,IAAI,SAAS,EAAC,MAAM,eAAe,CAAA;AAC/C,OAAO,EAAC,OAAO,IAAI,MAAM,EAAC,MAAM,iBAAiB,CAAA;AACjD,OAAO,EAAC,MAAM,IAAI,WAAW,EAAC,MAAM,iBAAiB,CAAA;AACrD,OAAO,EAAC,OAAO,IAAI,QAAQ,EAAC,MAAM,mBAAmB,CAAA;AACrD,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;AAC7C,OAAO,EAAC,OAAO,IAAI,IAAI,EAAC,MAAM,mBAAmB,CAAA;AACjD,OAAO,EAAC,OAAO,IAAI,IAAI,EAAC,MAAM,eAAe,CAAA;AAC7C,OAAO,EAAC,OAAO,IAAI,KAAK,EAAC,MAAM,gBAAgB,CAAA"}

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

@@ -1,3 +1,10 @@
+/**
+ * @file Collection.js
+ *
+ * Provides utility functions for working with collections (arrays, objects, sets, maps).
+ * Includes methods for iteration, transformation, validation, and manipulation of
+ * various collection types.
+ */
 /**
  * Utility class for collection operations.
  * Provides static methods for working with arrays, objects, sets, and maps.
@@ -188,7 +195,7 @@ export default class Collection {
      * @param {boolean} mutate Whether to mutate the original object
      * @returns {Promise<object>} The mapped object
      */
-    static mapObject(original: object, transformer: (arg0: unknown) => unknown, mutate?: boolean): Promise<object>;
+    static mapObject(original: object, transformer: Function, mutate?: boolean): Promise<object>;
     /**
      * Allocates an object from a source array and a spec array or function.
      *
@@ -196,7 +203,7 @@ export default class Collection {
      * @param {Array<unknown>|function(Array<unknown>): Promise<Array<unknown>>|Array<unknown>} spec The spec array or function
      * @returns {Promise<object>} The allocated object
      */
-    static allocateObject(source: Array<unknown>, spec: Array<unknown> | ((arg0: Array<unknown>) => Promise<Array<unknown>> | Array<unknown>)): Promise<object>;
+    static allocateObject(source: Array<unknown>, spec: Array<unknown> | Function): Promise<object>;
     /**
      * Trims falsy values from both ends of an array (in-place).
      * Optionally preserves specific falsy values.

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

@@ -1 +1 @@
-{"version":3,"file":"Collection.d.ts","sourceRoot":"","sources":["../../../src/browser/lib/Collection.js"],"names":[],"mappings":"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"}
+{"version":3,"file":"Collection.d.ts","sourceRoot":"","sources":["../../../src/browser/lib/Collection.js"],"names":[],"mappings":"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"}

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

@@ -1,3 +1,23 @@
+/**
+ * @file Data utility functions for type checking, object manipulation, and
+ * array operations.
+ *
+ * Provides comprehensive utilities for working with JavaScript data types and
+ * structures.
+ */
+import TypeSpec from "./TypeSpec.js";
+export type TypeSpecOptions = {
+    /**
+     * - The delimiter for union types
+     */
+    delimiter?: string;
+};
+export type TypeValidationOptions = {
+    /**
+     * - Whether empty values are allowed
+     */
+    allowEmpty?: boolean;
+};
 export default class Data {
     /**
      * Array of JavaScript primitive type names.
@@ -117,12 +137,7 @@ export default class Data {
      * @param {TypeValidationOptions} [options] Additional options for checking
      * @returns {boolean} Whether the value is of the specified type
      */
-    static isType(value: unknown, type: string | TypeSpec, options?: {
-        /**
-         * - Whether empty values are allowed
-         */
-        allowEmpty?: boolean;
-    }): boolean;
+    static isType(value: unknown, type: string | TypeSpec, options?: TypeValidationOptions): boolean;
     /**
      * Checks if a type is valid
      *
@@ -263,5 +278,4 @@ export default class Data {
      */
     static isBinary(value: unknown): boolean;
 }
-import TypeSpec from "./TypeSpec.js";
 //# sourceMappingURL=Data.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Data.d.ts","sourceRoot":"","sources":["../../../src/browser/lib/Data.js"],"names":[],"mappings":"AAUA;IACA;;;;;OAKG;IACD,mBAFQ,KAAK,CAAC,MAAM,CAAC,CAgBnB;IAEF;;;;;OAKG;IACH,qBAFU,KAAK,CAAC,MAAM,CAAC,CAmBrB;IAEF;;;;;;;OAOG;IACH,kBAFU,KAAK,CAAC,MAAM,CAAC,CAKrB;IAEF;;;;;OAKG;IACH,uBAFU,KAAK,CAAC,MAAM,CAAC,CAE2D;IAElF;;;;;;OAMG;IACH,sBAJW,MAAM,UACN,MAAM,GACJ,MAAM,CAMlB;IAED;;;;;;OAMG;IACH,uBAJW,MAAM,WACN,MAAM,GACJ,MAAM,CAMlB;IAED;;;;;;;;;;;OAWG;IACH,yBATW,MAAM,UACN,MAAM,oBACN,OAAO,GACL,MAAM,CAWlB;IAED;;;;;;;;;;;OAWG;IACH,wBATW,MAAM,UACN,MAAM,oBACN,OAAO,GACL,MAAM,CAWlB;IAED;;;;;;;OAOG;IACH,yBALW,MAAM,UACN,MAAM,oBACN,OAAO,GACL,MAAM,CAWlB;IAED;;;;;;;OAOG;IACH,0BALW,MAAM,UACN,MAAM,oBACN,OAAO,GACL,MAAM,CAYlB;IAED;;;;;OAKG;IAEH;;;;;OAKG;IAEH;;;;;;OAMG;IACH,2BAHW,MAAM,GACJ,QAAQ,CAIpB;IAED;;;;;;;OAOG;IACH,qBALW,OAAO,QACP,MAAM,GAAC,QAAQ;;;;qBAlBZ,OAAO;QAoBR,OAAO,CAQnB;IAED;;;;;OAKG;IACH,yBAHW,MAAM,GACJ,OAAO,CASnB;IAED;;;;;;;;OAQG;IACH,yBAJW,OAAO,QACP,MAAM,GACJ,OAAO,CAenB;IAED;;;;;;OAMG;IACH,qBAHW,OAAO,GACL,MAAM,CAoBlB;IAED;;;;;OAKG;IACH,wBAHW,OAAO,GACL,OAAO,CAInB;IAED;;;;;;;;OAQG;IACH,sBALW,OAAO,oBACP,OAAO,GAEL,OAAO,CA8BnB;IAED;;;;;OAKG;IACH,6BAHW,MAAM,GACJ,MAAM,CAmBlB;IAED;;;;;;;OAOG;IACH,6BAJW,MAAM,QACN,KAAK,CAAC,MAAM,CAAC,GACX,MAAM,CAiBlB;IAED;;;;;;;OAOG;IACH,2BAJW,MAAM,QACN,KAAK,CAAC,MAAM,CAAC,SACb,OAAO,QAMjB;IAED;;;;;OAKG;IACH,+BAHc,MAAM,EAAA,GACP,MAAM,CAqBlB;IAED;;;;;;;OAOG;IACH,wBAJW,KAAK,CAAC,OAAO,CAAC,aACd,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,GAClC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAMnC;IAED;;;;;;;OAOG;IACH,kBALW,MAAM,OACN,MAAM,OACN,MAAM,GACJ,MAAM,CAIlB;IAED;;;;;;;OAOG;IACH,oBALW,MAAM,OACN,MAAM,OACN,MAAM,GACJ,OAAO,CAInB;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,4BAbW,OAAO,GACL,OAAO,CA+BnB;IAED;;;;;;;;;;;;;;;OAeG;IACH,uBAXW,OAAO,GACL,OAAO,CAgBnB;CAEF;qBA5gBoB,eAAe"}
+{"version":3,"file":"Data.d.ts","sourceRoot":"","sources":["../../../src/browser/lib/Data.js"],"names":[],"mappings":"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"}

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

@@ -2,7 +2,8 @@
  * Simple lifecycle helper that tracks disposer callbacks.
  * Register any teardown functions and call dispose() to run them in reverse.
  */
-export class Disposer {
+export declare class Disposer {
+    #private;
     /**
      * Registers a disposer callback to be executed when disposed.
      *
@@ -26,7 +27,6 @@ export class Disposer {
      * @returns {Array<() => void>} Snapshot of disposer callbacks.
      */
     get disposers(): Array<() => void>;
-    #private;
 }
 declare const _default: Disposer;
 export default _default;

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

@@ -1 +1 @@
-{"version":3,"file":"Disposer.d.ts","sourceRoot":"","sources":["../../../src/browser/lib/Disposer.js"],"names":[],"mappings":"AAEA;;;GAGG;AACH;IAGE;;;;;;;;;OASG;IACH,uBAHW,CAAG,CAAC,MAAM,IAAI,CAAC,GAAC,KAAK,CAAC,MAAM,IAAI,CAAC,GAAA,GAC/B,CAAC,MAAM,IAAI,CAAC,GAAC,KAAK,CAAC,MAAM,IAAI,CAAC,CAS1C;IAWD;;;;OAIG;IACH,WAFa,IAAI,CAehB;IAcD;;;;OAIG;IACH,iBAFa,KAAK,CAAC,MAAM,IAAI,CAAC,CAI7B;;CAQF"}
+{"version":3,"file":"Disposer.d.ts","sourceRoot":"","sources":["../../../src/browser/lib/Disposer.js"],"names":[],"mappings":"AAEA;;;GAGG;AACH,qBAAa,QAAQ;;IAGnB;;;;;;;;;OASG;IACH,QAAQ,CAAC,GAAG,SAAS,EAHV,CAAG,CAAC,MAAM,IAAI,CAAC,GAAC,KAAK,CAAC,MAAM,IAAI,CAAC,GAGvB,GAFR,CAAC,MAAM,IAAI,CAAC,GAAC,KAAK,CAAC,MAAM,IAAI,CAAC,CAS1C;IAWD;;;;OAIG;IACH,OAAO,IAFM,IAAI,CAehB;IAcD;;;;OAIG;IACH,IAAI,SAAS,IAFA,KAAK,CAAC,MAAM,IAAI,CAAC,CAI7B;CAQF"}

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

@@ -1,4 +1,5 @@
-export class HTML {
+export declare class HTML {
+    #private;
     /**
      * Lightweight HTML helper utilities for browser contexts.
      *
@@ -33,7 +34,6 @@ export class HTML {
      * @param {Element} element - Element to clear.
      */
     clearHTMLContent(element: Element): void;
-    #private;
 }
 declare const _default: HTML;
 export default _default;

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

@@ -1 +1 @@
-{"version":3,"file":"HTML.d.ts","sourceRoot":"","sources":["../../../src/browser/lib/HTML.js"],"names":[],"mappings":"AAGA;IAGE;;;;OAIG;IACH,wBAFW,MAAM,GAAC,CAAC,MAAM,OAAO,CAAC,EAIhC;IAED;;;;;;OAMG;IACH,cAJW,MAAM,sBACN,OAAO,GACL,OAAO,CAAC,MAAM,CAAC,CAmB3B;IAED;;;;;OAKG;IACH,gBAHW,MAAM,GACJ,MAAM,CAMlB;IAED;;;;;OAKG;IACH,wBAHW,OAAO,cACP,MAAM,QA+BhB;IAED;;;;OAIG;IACH,0BAFW,OAAO,QAmBjB;;CAwBF"}
+{"version":3,"file":"HTML.d.ts","sourceRoot":"","sources":["../../../src/browser/lib/HTML.js"],"names":[],"mappings":"AAGA,qBAAa,IAAI;;IAGf;;;;OAIG;IACH,YAAY,SAAS,GAFV,MAAM,GAAC,CAAC,MAAM,OAAO,CAED,EAE9B;IAED;;;;;;OAMG;IACG,QAAQ,CAAC,GAAG,EAJP,MAIO,EAAE,iBAAiB,GAH1B,OAGgC,GAF9B,OAAO,CAAC,MAAM,CAAC,CAmB3B;IAED;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,GAHF,MAGK,GAFH,MAAM,CAMlB;IAED;;;;;OAKG;IACH,cAAc,CAAC,OAAO,EAHX,OAGW,EAAE,UAAU,EAFvB,MAEuB,QA6BjC;IAED;;;;OAIG;IACH,gBAAgB,CAAC,OAAO,EAFb,OAEa,QAiBvB;CAwBF"}

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

@@ -3,13 +3,28 @@
  * Uses `globalThis` for safe resolution in server-side build environments
  * (e.g. esm.sh) while defaulting to `window` at runtime.
  */
+export type NotifyEventOptions = {
+    /**
+     * - Whether the event bubbles up the DOM tree.
+     */
+    bubbles?: boolean;
+    /**
+     * - Whether the event can be canceled.
+     */
+    cancelable?: boolean;
+    /**
+     * - Whether the event can cross the shadow DOM boundary.
+     */
+    composed?: boolean;
+};
 /**
  * @typedef {object} NotifyEventOptions
  * @property {boolean} [bubbles] - Whether the event bubbles up the DOM tree.
  * @property {boolean} [cancelable] - Whether the event can be canceled.
  * @property {boolean} [composed] - Whether the event can cross the shadow DOM boundary.
  */
-export class Notify {
+export declare class Notify {
+    #private;
     /** @type {string} Display name for debugging. */
     name: string;
     /**
@@ -51,22 +66,7 @@ export class Notify {
      * @returns {void}
      */
     off(type: string, handler: (evt: Event) => void, element?: EventTarget, options?: boolean | object): void;
-    #private;
 }
 declare const _default: Notify;
 export default _default;
-export type NotifyEventOptions = {
-    /**
-     * - Whether the event bubbles up the DOM tree.
-     */
-    bubbles?: boolean;
-    /**
-     * - Whether the event can be canceled.
-     */
-    cancelable?: boolean;
-    /**
-     * - Whether the event can cross the shadow DOM boundary.
-     */
-    composed?: boolean;
-};
 //# sourceMappingURL=Notify.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Notify.d.ts","sourceRoot":"","sources":["../../../src/browser/lib/Notify.js"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;GAKG;AACH;IACE,iDAAiD;IACjD,MADW,MAAM,CACF;IAWf;;;;;;;OAOG;IACH,WALW,MAAM,YACN,OAAO,YACP,OAAO,GAAG,kBAAkB,GAC1B,IAAI,CAKhB;IAED;;;;;;;OAOG;IACH,cALW,MAAM,YACN,OAAO,YACP,OAAO,GAAG,kBAAkB,GAC1B,OAAO,CAOnB;IAED;;;;;;;;;OASG;IACH,SANW,MAAM,WACN,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,YACpB,WAAW,YACX,OAAO,GAAG,MAAM,GACd,MAAM,IAAI,CAatB;IAED;;;;;;;;OAQG;IACH,UANW,MAAM,WACN,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,YACpB,WAAW,YACX,OAAO,GAAG,MAAM,GACd,IAAI,CAKhB;;CAkBF;;;;;;;cAlGa,OAAO;;;;iBACP,OAAO;;;;eACP,OAAO"}
+{"version":3,"file":"Notify.d.ts","sourceRoot":"","sources":["../../../src/browser/lib/Notify.js"],"names":[],"mappings":"AAAA;;;;GAIG;AAGA,YAAkB,kBAAkB,GACpC;;;;IAAqB,OAAO,AAA5B,CACA,EADW,OAAO,CAClB;;;;IAAqB,UAAU,AAA/B,CACA,EADW,OAAO,CAClB;;;;IAAqB,QAAQ,AAA7B,CACF,EADa,OAAO,CACpB;CAAA,CAAA;AALD;;;;;GAKG;AACH,qBAAa,MAAM;;IACjB,iDAAiD;IACjD,IAAI,EADO,MAAM,CACF;IAWf;;;;;;;OAOG;IACH,IAAI,CAAC,IAAI,EALE,MAKF,EAAE,OAAO,AAJf,CACA,EADQ,OAIiB,EAAE,OAAO,AAHlC,CACA,EADQ,OAAO,GAAG,kBAG0B,GAFlC,IAAI,CAKhB;IAED;;;;;;;OAOG;IACH,OAAO,CAAC,IAAI,EALD,MAKC,EAAE,OAAO,AAJlB,CACA,EADQ,OAIa,EAAE,OAAO,AAH9B,CACA,EADQ,OAAO,GAAG,kBAGsB,GAF9B,OAAO,CAOnB;IAED;;;;;;;;;OASG;IACH,EAAE,CAAC,IAAI,EANI,MAMJ,EAAE,OAAO,EALL,CAAC,GAAG,EAAE,KAAK,KAAK,IAKX,EAAE,OAAO,AAJtB,CACA,EADQ,WAIwB,EAAE,OAAO,AAHzC,CACA,EADQ,OAAO,GAAG,MAGiC,GAFzC,MAAM,IAAI,CAatB;IAED;;;;;;;;OAQG;IACH,GAAG,CAAC,IAAI,EANG,MAMH,EAAE,OAAO,EALN,CAAC,GAAG,EAAE,KAAK,KAAK,IAKV,EAAE,OAAO,AAJvB,CACA,EADQ,WAIyB,EAAE,OAAO,AAH1C,CACA,EADQ,OAAO,GAAG,MAGkC,GAF1C,IAAI,CAKhB;CAkBF"}

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

@@ -27,7 +27,7 @@ export default class Promised {
      * @returns {Promise<Array<{status: 'fulfilled'|'rejected', value?: unknown, reason?: unknown}>>} Results of all settled promises with status and value/reason
      */
     static settle(promises: Array<Promise<unknown>>): Promise<Array<{
-        status: "fulfilled" | "rejected";
+        status: 'fulfilled' | 'rejected';
         value?: unknown;
         reason?: unknown;
     }>>;
@@ -38,7 +38,7 @@ export default class Promised {
      * @returns {boolean} True if any result is rejected, false otherwise
      */
     static hasRejected(settled: Array<{
-        status: "fulfilled" | "rejected";
+        status: 'fulfilled' | 'rejected';
         value?: unknown;
         reason?: unknown;
     }>): boolean;
@@ -49,7 +49,7 @@ export default class Promised {
      * @returns {boolean} True if any result is fulfilled, false otherwise
      */
     static hasFulfilled(settled: Array<{
-        status: "fulfilled" | "rejected";
+        status: 'fulfilled' | 'rejected';
         value?: unknown;
         reason?: unknown;
     }>): boolean;
@@ -60,11 +60,11 @@ export default class Promised {
      * @returns {Array<{status: 'rejected', reason: unknown}>} Array of rejected results
      */
     static rejected(settled: Array<{
-        status: "fulfilled" | "rejected";
+        status: 'fulfilled' | 'rejected';
         value?: unknown;
         reason?: unknown;
     }>): Array<{
-        status: "rejected";
+        status: 'rejected';
         reason: unknown;
     }>;
     /**
@@ -74,11 +74,11 @@ export default class Promised {
      * @returns {Array<{status: 'fulfilled', value: unknown}>} Array of fulfilled results
      */
     static fulfilled(result: Array<{
-        status: "fulfilled" | "rejected";
+        status: 'fulfilled' | 'rejected';
         value?: unknown;
         reason?: unknown;
     }>): Array<{
-        status: "fulfilled";
+        status: 'fulfilled';
         value: unknown;
     }>;
     /**
@@ -88,7 +88,7 @@ export default class Promised {
      * @returns {Array<unknown>} Array of rejection reasons
      */
     static reasons(settled: Array<{
-        status: "fulfilled" | "rejected";
+        status: 'fulfilled' | 'rejected';
         value?: unknown;
         reason?: unknown;
     }>): Array<unknown>;
@@ -99,7 +99,7 @@ export default class Promised {
      * @returns {Array<unknown>} Array of fulfilled values
      */
     static values(settled: Array<{
-        status: "fulfilled" | "rejected";
+        status: 'fulfilled' | 'rejected';
         value?: unknown;
         reason?: unknown;
     }>): Array<unknown>;
@@ -111,7 +111,7 @@ export default class Promised {
      * @throws {Tantrum} Throws a Tantrum error with rejection reasons
      */
     static throw(message: string, settled: Array<{
-        status: "fulfilled" | "rejected";
+        status: 'fulfilled' | 'rejected';
         value?: unknown;
         reason?: unknown;
     }>): void;

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

@@ -1 +1 @@
-{"version":3,"file":"Promised.d.ts","sourceRoot":"","sources":["../../../src/browser/lib/Promised.js"],"names":[],"mappings":"AAGA;;;GAGG;AACH;IACE;;;;;;OAMG;IACH,uBAHW,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GACrB,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAMnC;IAED;;;;;;OAMG;IACH,sBAHW,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GACrB,OAAO,CAAC,OAAO,CAAC,CAM5B;IAED;;;;;;OAMG;IACH,wBAHW,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GACrB,OAAO,CAAC,KAAK,CAAC;QAAC,MAAM,EAAE,WAAW,GAAC,UAAU,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAC,CAAC,CAAC,CAM/F;IAED;;;;;OAKG;IACH,4BAHW,KAAK,CAAC;QAAC,MAAM,EAAE,WAAW,GAAC,UAAU,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAC,CAAC,GACxE,OAAO,CAInB;IAED;;;;;OAKG;IACH,6BAHW,KAAK,CAAC;QAAC,MAAM,EAAE,WAAW,GAAC,UAAU,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAC,CAAC,GACxE,OAAO,CAInB;IAED;;;;;OAKG;IACH,yBAHW,KAAK,CAAC;QAAC,MAAM,EAAE,WAAW,GAAC,UAAU,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAC,CAAC,GACxE,KAAK,CAAC;QAAC,MAAM,EAAE,UAAU,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAC,CAAC,CAIxD;IAED;;;;;OAKG;IACH,yBAHW,KAAK,CAAC;QAAC,MAAM,EAAE,WAAW,GAAC,UAAU,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAC,CAAC,GACxE,KAAK,CAAC;QAAC,MAAM,EAAE,WAAW,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAC,CAAC,CAIxD;IAED;;;;;OAKG;IACH,wBAHW,KAAK,CAAC;QAAC,MAAM,EAAE,WAAW,GAAC,UAAU,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAC,CAAC,GACxE,KAAK,CAAC,OAAO,CAAC,CAO1B;IAED;;;;;OAKG;IACH,uBAHW,KAAK,CAAC;QAAC,MAAM,EAAE,WAAW,GAAC,UAAU,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAC,CAAC,GACxE,KAAK,CAAC,OAAO,CAAC,CAO1B;IAED;;;;;;OAMG;IACH,sBAJW,MAAM,WACN,KAAK,CAAC;QAAC,MAAM,EAAE,WAAW,GAAC,UAAU,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAC,CAAC,QAapF;CACF"}
+{"version":3,"file":"Promised.d.ts","sourceRoot":"","sources":["../../../src/browser/lib/Promised.js"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,QAAQ;IAC3B;;;;;;OAMG;IACH,OAAa,KAAK,CAAC,QAAQ,EAHhB,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAGN,GAFd,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAMnC;IAED;;;;;;OAMG;IACH,OAAa,IAAI,CAAC,QAAQ,EAHf,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAGP,GAFb,OAAO,CAAC,OAAO,CAAC,CAM5B;IAED;;;;;;OAMG;IACH,OAAa,MAAM,CAAC,QAAQ,EAHjB,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAGL,GAFf,OAAO,CAAC,KAAK,CAAC;QAAC,MAAM,EAAE,WAAW,GAAC,UAAU,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAC,CAAC,CAAC,CAM/F;IAED;;;;;OAKG;IACH,MAAM,CAAC,WAAW,CAAC,OAAO,EAHf,KAAK,CAAC;QAAC,MAAM,EAAE,WAAW,GAAC,UAAU,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAC,CAG1D,GAFb,OAAO,CAInB;IAED;;;;;OAKG;IACH,MAAM,CAAC,YAAY,CAAC,OAAO,EAHhB,KAAK,CAAC;QAAC,MAAM,EAAE,WAAW,GAAC,UAAU,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAC,CAGzD,GAFd,OAAO,CAInB;IAED;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,CAAC,OAAO,EAHZ,KAAK,CAAC;QAAC,MAAM,EAAE,WAAW,GAAC,UAAU,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAC,CAG7D,GAFV,KAAK,CAAC;QAAC,MAAM,EAAE,UAAU,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAC,CAAC,CAIxD;IAED;;;;;OAKG;IACH,MAAM,CAAC,SAAS,CAAC,MAAM,EAHZ,KAAK,CAAC;QAAC,MAAM,EAAE,WAAW,GAAC,UAAU,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAC,CAG7D,GAFV,KAAK,CAAC;QAAC,MAAM,EAAE,WAAW,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAC,CAAC,CAIxD;IAED;;;;;OAKG;IACH,MAAM,CAAC,OAAO,CAAC,OAAO,EAHX,KAAK,CAAC;QAAC,MAAM,EAAE,WAAW,GAAC,UAAU,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAC,CAG9D,GAFT,KAAK,CAAC,OAAO,CAAC,CAO1B;IAED;;;;;OAKG;IACH,MAAM,CAAC,MAAM,CAAC,OAAO,EAHV,KAAK,CAAC;QAAC,MAAM,EAAE,WAAW,GAAC,UAAU,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAC,CAG/D,GAFR,KAAK,CAAC,OAAO,CAAC,CAO1B;IAED;;;;;;OAMG;IACH,MAAM,CAAC,KAAK,CAAC,OAAO,EAJT,MAIS,EAAE,OAAO,EAHlB,KAAK,CAAC;QAAC,MAAM,EAAE,WAAW,GAAC,UAAU,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAC,CAGvD,QAU5B;CACF"}

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"}