@gesslar/toolkit 0.7.0 → 0.7.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gesslar/toolkit",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "description": "Get in, bitches, we're going toolkitting.",
   "main": "./src/index.js",
   "type": "module",
@@ -17,7 +17,7 @@
   ],
   "sideEffects": false,
   "engines": {
-    "node": ">=20"
+    "node": ">=22"
   },
   "scripts": {
     "types:build": "tsc -p tsconfig.types.json",

package/src/lib/DirectoryObject.js

@@ -7,6 +7,7 @@
 import fs from "node:fs/promises"
 import path from "node:path"
 import util from "node:util"
+import {URL} from "node:url"
 
 import FS from "./FS.js"
 import FileObject from "./FileObject.js"
@@ -18,7 +19,7 @@ import Sass from "./Sass.js"
  *
  * @property {string} supplied - The supplied directory
  * @property {string} path - The resolved path
- * @property {string} uri - The directory URI
+ * @property {URL} url - The directory URL
  * @property {string} name - The directory name
  * @property {string} module - The directory name without extension
  * @property {string} extension - The directory extension (usually empty)
@@ -32,7 +33,7 @@ export default class DirectoryObject extends FS {
    * @private
    * @property {string|null} supplied - User-supplied path
    * @property {string|null} path - The absolute file path
-   * @property {string|null} uri - The file URI
+   * @property {URL|null} url - The file URL
    * @property {string|null} name - The file name
    * @property {string|null} module - The file name without extension
    * @property {string|null} extension - The file extension
@@ -42,7 +43,7 @@ export default class DirectoryObject extends FS {
   #meta = Object.seal({
     supplied: null,
     path: null,
-    uri: null,
+    url: null,
     name: null,
     module: null,
     extension: null,
@@ -61,16 +62,15 @@ export default class DirectoryObject extends FS {
     super()
 
     const fixedDir = FS.fixSlashes(directory ?? ".")
-    const absolutePath = path.resolve(fixedDir)
-    const fileUri = FS.pathToUri(absolutePath)
-    const filePath = FS.uriToPath(fileUri)
-    const baseName = path.basename(absolutePath) || "."
-    const trail = filePath.split(path.sep)
+    const resolved = path.resolve(fixedDir)
+    const url = new URL(FS.pathToUri(resolved))
+    const baseName = path.basename(resolved) || "."
+    const trail = resolved.split(path.sep)
     const sep = path.sep
 
     this.#meta.supplied = fixedDir
-    this.#meta.path = filePath
-    this.#meta.uri = fileUri
+    this.#meta.path = resolved
+    this.#meta.url = url
     this.#meta.name = baseName
     this.#meta.extension = ""
     this.#meta.module = baseName
@@ -98,7 +98,7 @@ export default class DirectoryObject extends FS {
     return {
       supplied: this.supplied,
       path: this.path,
-      uri: this.uri,
+      url: this.url.toString(),
       name: this.name,
       module: this.module,
       extension: this.extension,
@@ -144,12 +144,12 @@ export default class DirectoryObject extends FS {
   }
 
   /**
-   * Returns the URI of the current directory.
+   * Returns the URL of the current directory.
    *
-   * @returns {string} The directory URI
+   * @returns {URL} The directory URL
    */
-  get uri() {
-    return this.#meta.uri
+  get url() {
+    return this.#meta.url
   }
 
   /**
@@ -239,10 +239,7 @@ export default class DirectoryObject extends FS {
    * @returns {Promise<{files: Array<FileObject>, directories: Array<DirectoryObject>}>} The files and directories in the directory.
    */
   async read() {
-    const found = await fs.readdir(
-      new URL(this.uri),
-      {withFileTypes: true}
-    )
+    const found = await fs.readdir(this.url, {withFileTypes: true})
 
     const files = found
       .filter(dirent => dirent.isFile())
@@ -331,4 +328,31 @@ export default class DirectoryObject extends FS {
   get walkUp() {
     return this.#walkUp()
   }
+
+  /**
+   * Deletes an empty directory from the filesystem.
+   *
+   * Recursive deletion is intentionally not supported. If you need to delete
+   * a directory with contents, you must imperatively decide your deletion
+   * strategy and handle it explicitly.
+   *
+   * @returns {Promise<void>} Resolves when directory is deleted
+   * @throws {Sass} If the directory URL is invalid
+   * @throws {Sass} If the directory does not exist
+   * @throws {Error} If the directory is not empty (from fs.rmdir)
+   * @example
+   * const dir = new DirectoryObject('./temp/cache')
+   * await dir.delete() // Only works if directory is empty
+   */
+  async delete() {
+    const dirPath = this.path
+
+    if(!dirPath)
+      throw Sass.new("This object does not represent a valid resource.")
+
+    if(!(await this.exists))
+      throw Sass.new(`No such resource '${this.url.href}'`)
+
+    return await fs.rmdir(this.path)
+  }
 }

package/src/lib/FileObject.js

@@ -9,6 +9,7 @@ import fs from "node:fs/promises"
 import path from "node:path"
 import util from "node:util"
 import YAML from "yaml"
+import {URL} from "node:url"
 
 import Data from "./Data.js"
 import DirectoryObject from "./DirectoryObject.js"
@@ -22,7 +23,7 @@ import Valid from "./Valid.js"
  *
  * @property {string} supplied - User-supplied path
  * @property {string} path - The absolute file path
- * @property {string} uri - The file URI
+ * @property {URL} url - The file URL
  * @property {string} name - The file name
  * @property {string} module - The file name without extension
  * @property {string} extension - The file extension
@@ -51,7 +52,7 @@ export default class FileObject extends FS {
    * @private
    * @property {string|null} supplied - User-supplied path
    * @property {string|null} path - The absolute file path
-   * @property {string|null} uri - The file URI
+   * @property {URL|null} url - The file URL
    * @property {string|null} name - The file name
    * @property {string|null} module - The file name without extension
    * @property {string|null} extension - The file extension
@@ -62,7 +63,7 @@ export default class FileObject extends FS {
   #meta = Object.seal({
     supplied: null,
     path: null,
-    uri: null,
+    url: null,
     name: null,
     module: null,
     extension: null,
@@ -102,11 +103,11 @@ export default class FileObject extends FS {
     const final = FS.resolvePath(directoryObject.path ?? ".", fixedFile)
 
     const resolved = final
-    const fileUri = FS.pathToUri(resolved)
+    const url = new URL(FS.pathToUri(resolved))
 
     this.#meta.supplied = fixedFile
     this.#meta.path = resolved
-    this.#meta.uri = fileUri
+    this.#meta.url = url
     this.#meta.name = base
     this.#meta.extension = ext
     this.#meta.module = path.basename(this.supplied, this.extension)
@@ -133,7 +134,7 @@ export default class FileObject extends FS {
     return {
       supplied: this.supplied,
       path: this.path,
-      uri: this.uri,
+      url: this.url.toString(),
       name: this.name,
       module: this.module,
       extension: this.extension,
@@ -162,30 +163,30 @@ export default class FileObject extends FS {
   }
 
   /**
-   * Return the user-supplied path
+   * Return the normalized path that was provided to the constructor.
    *
-   * @returns {string} The file path
+   * @returns {string} The sanitized user-supplied file path
    */
   get supplied() {
     return this.#meta.supplied
   }
 
   /**
-   * Return the resolved path as passed to the constructor.
+   * Return the fully resolved absolute path to the file on disk.
    *
-   * @returns {string} The file path
+   * @returns {string} The fully resolved absolute file path
    */
   get path() {
     return this.#meta.path
   }
 
   /**
-   * Returns the URI of the current file.
+   * Returns the URL of the current file.
    *
-   * @returns {string} The file URI
+   * @returns {URL} The file URL
    */
-  get uri() {
-    return this.#meta.uri
+  get url() {
+    return this.#meta.url
   }
 
   /**
@@ -385,7 +386,7 @@ export default class FileObject extends FS {
       await fs.writeFile(this.path, content, encoding)
 
     else
-      throw Sass.new(`Invalid directory, ${this.directory.uri}`)
+      throw Sass.new(`Invalid directory, ${this.directory.url.href}`)
   }
 
   /**
@@ -436,14 +437,36 @@ export default class FileObject extends FS {
    * @returns {Promise<object>} The file contents as a module.
    */
   async import() {
-    const fileUri = this.uri
+    const url = this.url
 
-    if(!fileUri)
-      throw Sass.new("No URI in file map")
+    if(!url)
+      throw Sass.new("No URL in file map")
 
     if(!(await this.exists))
-      throw Sass.new(`No such file '${fileUri}'`)
+      throw Sass.new(`No such file '${url.href}'`)
 
-    return await import(fileUri)
+    return await import(url.href)
+  }
+
+  /**
+   * Deletes the file from the filesystem.
+   *
+   * @returns {Promise<void>} Resolves when file is deleted
+   * @throws {Sass} If the file URL is invalid
+   * @throws {Sass} If the file does not exist
+   * @example
+   * const file = new FileObject('./temp/data.json')
+   * await file.delete()
+   */
+  async delete() {
+    const filePath = this.path
+
+    if(!filePath)
+      throw Sass.new("This object does not represent a valid resource.")
+
+    if(!(await this.exists))
+      throw Sass.new(`No such resource '${this.url.href}'`)
+
+    return await fs.unlink(this.path)
   }
 }

package/src/lib/Logger.js

@@ -8,7 +8,7 @@
         options { depth: 0, colors: false, compact: 3 }.
   * %d: Number will be used to convert all values except BigInt and Symbol.
   * %i: parseInt(value, 10) is used for all values except BigInt and Symbol.
-  * %f: parseFloat(value) is used for all values expect Symbol.
+  * %f: parseFloat(value) is used for all values except Symbol.
   * %j: JSON. Replaced with the string '[Circular]' if the argument contains
         circular references.
   * %o: Object. A string representation of an object with generic JavaScript

package/src/lib/Util.js

@@ -290,13 +290,14 @@ export default class Util {
    * Emits an event asynchronously and waits for all listeners to complete.
    * Like asyncEmit, but uses duck typing for more flexible emitter validation.
    * Accepts any object that has the required EventEmitter-like methods.
+   * If it walks like an EventEmitter and quacks like an EventEmitter...
    *
    * @param {object} emitter - Any object with EventEmitter-like interface
    * @param {string} event - The event name to emit
    * @param {...unknown} args - Arguments to pass to event listeners
-   * @returns {Promise<void>} Resolves when all listeners have completed
+   * @returns {Promise<void>} Resolves when all listeners have completed, but no grapes.
    */
-  static async asyncEmitAnon(emitter, event, ...args) {
+  static async asyncEmitQuack(emitter, event, ...args) {
     try {
       if(!emitter ||
          typeof emitter.listeners !== "function" ||

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

@@ -0,0 +1,37 @@
+/**
+ * Custom error class for toolkit errors.
+ * Provides error chaining, trace management, and formatted error reporting.
+ */
+export default class Chide extends Sass {
+    /**
+     * Creates an Chide 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 {Chide} New Chide instance with trace from the original error
+     * @throws {Chide} If the first parameter is not an Error instance
+     */
+    static from(error: Error, message: string): Chide;
+    /**
+     * 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|Chide} [error] - Optional existing error to wrap or enhance
+     * @returns {Chide} New or enhanced Sass instance
+     */
+    static "new"(message: string, error?: Error | Sass | Tantrum | Chide): Chide;
+    /**
+     * Adds a trace message and returns this instance for chaining.
+     *
+     * @param {string} message - The trace message to add
+     * @returns {this} This Chide instance for method chaining
+     */
+    addTrace(message: string): this;
+    #private;
+}
+import Sass from "./Sass.js";
+import Tantrum from "./Tantrum.js";
+//# sourceMappingURL=Chide.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Chide.d.ts","sourceRoot":"","sources":["../../lib/Chide.js"],"names":[],"mappings":"AAkBA;;;GAGG;AACH;IA2GE;;;;;;;;OAQG;IACH,mBALW,KAAK,WACL,MAAM,GACJ,KAAK,CAWjB;IAED;;;;;;;;OAQG;IACH,sBAJW,MAAM,UACN,KAAK,GAAC,IAAI,GAAC,OAAO,GAAC,KAAK,GACtB,KAAK,CAWjB;IA/GD;;;;;OAKG;IACH,kBAHW,MAAM,GACJ,IAAI,CAShB;;CAmGF;iBAzJgB,WAAW;oBAER,cAAc"}

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

@@ -4,7 +4,7 @@
  *
  * @property {string} supplied - The supplied directory
  * @property {string} path - The resolved path
- * @property {string} uri - The directory URI
+ * @property {URL} url - The directory URL
  * @property {string} name - The directory name
  * @property {string} module - The directory name without extension
  * @property {string} extension - The directory extension (usually empty)
@@ -44,11 +44,11 @@ export default class DirectoryObject extends FS {
      */
     get path(): string;
     /**
-     * Returns the URI of the current directory.
+     * Returns the URL of the current directory.
      *
-     * @returns {string} The directory URI
+     * @returns {URL} The directory URL
      */
-    get uri(): string;
+    get url(): URL;
     /**
      * Returns the directory name with extension (if any) without the path.
      *
@@ -134,6 +134,22 @@ export default class DirectoryObject extends FS {
      * }
      */
     get walkUp(): object;
+    /**
+     * Deletes an empty directory from the filesystem.
+     *
+     * Recursive deletion is intentionally not supported. If you need to delete
+     * a directory with contents, you must imperatively decide your deletion
+     * strategy and handle it explicitly.
+     *
+     * @returns {Promise<void>} Resolves when directory is deleted
+     * @throws {Sass} If the directory URL is invalid
+     * @throws {Sass} If the directory does not exist
+     * @throws {Error} If the directory is not empty (from fs.rmdir)
+     * @example
+     * const dir = new DirectoryObject('./temp/cache')
+     * await dir.delete() // Only works if directory is empty
+     */
+    delete(): Promise<void>;
     /**
      * Custom inspect method for Node.js console.
      *
@@ -143,6 +159,7 @@ export default class DirectoryObject extends FS {
     #private;
 }
 import FS from "./FS.js";
+import { URL } from "node:url";
 import FileObject from "./FileObject.js";
 import util from "node:util";
 //# sourceMappingURL=DirectoryObject.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"DirectoryObject.d.ts","sourceRoot":"","sources":["../../lib/DirectoryObject.js"],"names":[],"mappings":"AAcA;;;;;;;;;;;;;GAaG;AACH;IA0BE;;;;OAIG;IACH,uBAFW,MAAM,EAuBhB;IAWD;;;;OAIG;IACH,UAFa,MAAM,CAalB;IAWD;;;;OAIG;IACH,cAFa,OAAO,CAAC,OAAO,CAAC,CAI5B;IAED;;;;OAIG;IACH,gBAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,YAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,WAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,YAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,cAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,iBAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,WAFa,MAAM,CAIlB;IAED;;;;;;;OAOG;IACH,aALa,KAAK,CAAC,MAAM,CAAC,CAOzB;IAED;;;;OAIG;IACH,cAFa,OAAO,CAInB;IAED;;;;OAIG;IACH,mBAFa,OAAO,CAInB;IAiBD;;;;OAIG;IACH,QAFa,OAAO,CAAC;QAAC,KAAK,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;QAAC,WAAW,EAAE,KAAK,CAAC,eAAe,CAAC,CAAA;KAAC,CAAC,CAiBpF;IAED;;;;;;;;;;;;OAYG;IACH,uBARW,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAqBzB;IA8BD;;;;;;;;;;;;;;;OAeG;IACH,cAZa,MAAM,CAclB;IA/ND;;;;OAIG;IACH,yBAFa,MAAM,CAIlB;;CAyNF;eAnUc,SAAS;uBACD,iBAAiB;iBAHvB,WAAW"}
+{"version":3,"file":"DirectoryObject.d.ts","sourceRoot":"","sources":["../../lib/DirectoryObject.js"],"names":[],"mappings":"AAeA;;;;;;;;;;;;;GAaG;AACH;IA0BE;;;;OAIG;IACH,uBAFW,MAAM,EAsBhB;IAWD;;;;OAIG;IACH,UAFa,MAAM,CAalB;IAWD;;;;OAIG;IACH,cAFa,OAAO,CAAC,OAAO,CAAC,CAI5B;IAED;;;;OAIG;IACH,gBAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,YAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,WAFa,GAAG,CAIf;IAED;;;;OAIG;IACH,YAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,cAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,iBAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,WAFa,MAAM,CAIlB;IAED;;;;;;;OAOG;IACH,aALa,KAAK,CAAC,MAAM,CAAC,CAOzB;IAED;;;;OAIG;IACH,cAFa,OAAO,CAInB;IAED;;;;OAIG;IACH,mBAFa,OAAO,CAInB;IAiBD;;;;OAIG;IACH,QAFa,OAAO,CAAC;QAAC,KAAK,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;QAAC,WAAW,EAAE,KAAK,CAAC,eAAe,CAAC,CAAA;KAAC,CAAC,CAcpF;IAED;;;;;;;;;;;;OAYG;IACH,uBARW,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAqBzB;IA8BD;;;;;;;;;;;;;;;OAeG;IACH,cAZa,MAAM,CAclB;IAED;;;;;;;;;;;;;;OAcG;IACH,UARa,OAAO,CAAC,IAAI,CAAC,CAkBzB;IAvPD;;;;OAIG;IACH,yBAFa,MAAM,CAIlB;;CAiPF;eA1Vc,SAAS;oBAFN,UAAU;uBAGL,iBAAiB;iBAJvB,WAAW"}

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

@@ -4,7 +4,7 @@
  *
  * @property {string} supplied - User-supplied path
  * @property {string} path - The absolute file path
- * @property {string} uri - The file URI
+ * @property {URL} url - The file URL
  * @property {string} name - The file name
  * @property {string} module - The file name without extension
  * @property {string} extension - The file extension
@@ -43,23 +43,23 @@ export default class FileObject extends FS {
      */
     get exists(): Promise<boolean>;
     /**
-     * Return the user-supplied path
+     * Return the normalized path that was provided to the constructor.
      *
-     * @returns {string} The file path
+     * @returns {string} The sanitized user-supplied file path
      */
     get supplied(): string;
     /**
-     * Return the resolved path as passed to the constructor.
+     * Return the fully resolved absolute path to the file on disk.
      *
-     * @returns {string} The file path
+     * @returns {string} The fully resolved absolute file path
      */
     get path(): string;
     /**
-     * Returns the URI of the current file.
+     * Returns the URL of the current file.
      *
-     * @returns {string} The file URI
+     * @returns {URL} The file URL
      */
-    get uri(): string;
+    get url(): URL;
     /**
      * Returns the file name with extension (if any) without the path.
      *
@@ -173,6 +173,17 @@ export default class FileObject extends FS {
      * @returns {Promise<object>} The file contents as a module.
      */
     import(): Promise<object>;
+    /**
+     * Deletes the file from the filesystem.
+     *
+     * @returns {Promise<void>} Resolves when file is deleted
+     * @throws {Sass} If the file URL is invalid
+     * @throws {Sass} If the file does not exist
+     * @example
+     * const file = new FileObject('./temp/data.json')
+     * await file.delete()
+     */
+    delete(): Promise<void>;
     /**
      * Custom inspect method for Node.js console.
      *
@@ -182,6 +193,7 @@ export default class FileObject extends FS {
     #private;
 }
 import FS from "./FS.js";
+import { URL } from "node:url";
 import DirectoryObject from "./DirectoryObject.js";
 import util from "node:util";
 import JSON5 from "json5";

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

@@ -1 +1 @@
-{"version":3,"file":"FileObject.d.ts","sourceRoot":"","sources":["../../lib/FileObject.js"],"names":[],"mappings":"AAkBA;;;;;;;;;;;;;;GAcG;AAEH;IACE;;;;;OAKG;IACH,yBAFU;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,CAAC,OAAO,KAAK,GAAG,OAAO,IAAI,CAAC,CAAA;KAAC,CAO1D;IA2BF;;;;;OAKG;IACH,sBAHW,MAAM,cACN,eAAe,GAAC,MAAM,GAAC,IAAI,EAsCrC;IAWD;;;;OAIG;IACH,UAFa,MAAM,CAclB;IAWD;;;;OAIG;IACH,cAFa,OAAO,CAAC,OAAO,CAAC,CAI5B;IAED;;;;OAIG;IACH,gBAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,YAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,WAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,YAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,cAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,iBAFa,MAAM,CAIlB;IACD;;;;OAIG;IACH,cAFa,OAAO,CAInB;IAED;;;;OAIG;IACH,mBAFa,OAAO,CAInB;IAED;;;;;;;;;;;;;;OAcG;IACH,iBAFa,eAAe,CAI3B;IAED;;;;OAIG;IACH,WAFa,OAAO,CAAC,OAAO,CAAC,CAU5B;IAED;;;;OAIG;IACH,YAFa,OAAO,CAAC,OAAO,CAAC,CAU5B;IAiBD;;;;OAIG;IACH,QAFa,OAAO,CAAC,MAAM,OAAC,CAAC,CAU5B;IAED;;;;;OAKG;IACH,YAFa,OAAO,CAAC,IAAI,OAAC,CAAC,CAU1B;IAsBD;;;;;OAKG;IACH,gBAHW,MAAM,GACJ,OAAO,CAAC,MAAM,CAAC,CAY3B;IAED;;;;;;;;;;;OAWG;IACH,eARW,MAAM,aACN,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAezB;IAED;;;;;;;;;;;;;;OAcG;IACH,gBAXW,MAAM,aACN,MAAM,GACJ,OAAO,CAAC,OAAO,CAAC,CAkC5B;IAED;;;;OAIG;IACH,UAFa,OAAO,CAAC,MAAM,CAAC,CAY3B;IA9SD;;;;OAIG;IACH,yBAFa,MAAM,CAIlB;;CAwSF;eAlbc,SAAS;4BADI,sBAAsB;iBAJjC,WAAW;kBAHV,OAAO;iBAIR,MAAM"}
+{"version":3,"file":"FileObject.d.ts","sourceRoot":"","sources":["../../lib/FileObject.js"],"names":[],"mappings":"AAmBA;;;;;;;;;;;;;;GAcG;AAEH;IACE;;;;;OAKG;IACH,yBAFU;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,CAAC,OAAO,KAAK,GAAG,OAAO,IAAI,CAAC,CAAA;KAAC,CAO1D;IA2BF;;;;;OAKG;IACH,sBAHW,MAAM,cACN,eAAe,GAAC,MAAM,GAAC,IAAI,EAsCrC;IAWD;;;;OAIG;IACH,UAFa,MAAM,CAclB;IAWD;;;;OAIG;IACH,cAFa,OAAO,CAAC,OAAO,CAAC,CAI5B;IAED;;;;OAIG;IACH,gBAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,YAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,WAFa,GAAG,CAIf;IAED;;;;OAIG;IACH,YAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,cAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,iBAFa,MAAM,CAIlB;IACD;;;;OAIG;IACH,cAFa,OAAO,CAInB;IAED;;;;OAIG;IACH,mBAFa,OAAO,CAInB;IAED;;;;;;;;;;;;;;OAcG;IACH,iBAFa,eAAe,CAI3B;IAED;;;;OAIG;IACH,WAFa,OAAO,CAAC,OAAO,CAAC,CAU5B;IAED;;;;OAIG;IACH,YAFa,OAAO,CAAC,OAAO,CAAC,CAU5B;IAiBD;;;;OAIG;IACH,QAFa,OAAO,CAAC,MAAM,OAAC,CAAC,CAU5B;IAED;;;;;OAKG;IACH,YAFa,OAAO,CAAC,IAAI,OAAC,CAAC,CAU1B;IAsBD;;;;;OAKG;IACH,gBAHW,MAAM,GACJ,OAAO,CAAC,MAAM,CAAC,CAY3B;IAED;;;;;;;;;;;OAWG;IACH,eARW,MAAM,aACN,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAezB;IAED;;;;;;;;;;;;;;OAcG;IACH,gBAXW,MAAM,aACN,MAAM,GACJ,OAAO,CAAC,OAAO,CAAC,CAkC5B;IAED;;;;OAIG;IACH,UAFa,OAAO,CAAC,MAAM,CAAC,CAY3B;IAED;;;;;;;;;OASG;IACH,UAPa,OAAO,CAAC,IAAI,CAAC,CAiBzB;IApUD;;;;OAIG;IACH,yBAFa,MAAM,CAIlB;;CA8TF;eAxcc,SAAS;oBAJN,UAAU;4BAGA,sBAAsB;iBALjC,WAAW;kBAHV,OAAO;iBAIR,MAAM"}

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

@@ -86,7 +86,7 @@ export default class TypeSpec {
     matches(value: unknown, options: {
         allowEmpty: boolean;
     }): boolean;
-    match(value: any, options: any): false | unknown[];
+    match(value: any, options: any): unknown[];
     #private;
 }
 //# sourceMappingURL=TypeSpec.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"TypeSpec.d.ts","sourceRoot":"","sources":["../../lib/TypeSpec.js"],"names":[],"mappings":"AAWA;;;GAGG;AACH;IAGE;;;;;OAKG;IACH,oBAHW,MAAM,WACN,MAAM,EAUhB;IAJC,aAAwB;IACxB,eAAgC;IAChC,6BAA2C;IAI7C;;;;OAIG;IACH,YAFa,MAAM,CAQlB;IAED;;;;OAIG;IACH,UAFa,MAAM,CASlB;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;;;;;;;;OAQG;IACH,eALW,OAAO,WAEf;QAAyB,UAAU,EAA3B,OAAO;KACf,GAAU,OAAO,CAInB;IAED,mDAkDC;;CAiCF"}
+{"version":3,"file":"TypeSpec.d.ts","sourceRoot":"","sources":["../../lib/TypeSpec.js"],"names":[],"mappings":"AAWA;;;GAGG;AACH;IAGE;;;;;OAKG;IACH,oBAHW,MAAM,WACN,MAAM,EAUhB;IAJC,aAAwB;IACxB,eAAgC;IAChC,6BAA2C;IAI7C;;;;OAIG;IACH,YAFa,MAAM,CAQlB;IAED;;;;OAIG;IACH,UAFa,MAAM,CASlB;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;;;;;;;;OAQG;IACH,eALW,OAAO,WAEf;QAAyB,UAAU,EAA3B,OAAO;KACf,GAAU,OAAO,CAInB;IAED,2CAkDC;;CAiCF"}

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

@@ -166,13 +166,14 @@ export default class Util {
      * Emits an event asynchronously and waits for all listeners to complete.
      * Like asyncEmit, but uses duck typing for more flexible emitter validation.
      * Accepts any object that has the required EventEmitter-like methods.
+     * If it walks like an EventEmitter and quacks like an EventEmitter...
      *
      * @param {object} emitter - Any object with EventEmitter-like interface
      * @param {string} event - The event name to emit
      * @param {...unknown} args - Arguments to pass to event listeners
      * @returns {Promise<void>} Resolves when all listeners have completed
      */
-    static asyncEmitAnon(emitter: object, event: string, ...args: unknown[]): Promise<void>;
+    static asyncEmitQuack(emitter: object, event: string, ...args: unknown[]): Promise<void>;
     /**
      * Determine the Levenshtein distance between two string values
      *

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;;;;;;;;;OASG;IACH,8BALW,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;6BAjZ0B,aAAa"}
+{"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"}