@gesslar/toolkit 1.5.0 → 1.8.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gesslar/toolkit",
-  "version": "1.5.0",
+  "version": "1.8.0",
   "description": "Get in, bitches, we're going toolkitting.",
   "main": "./src/index.js",
   "type": "module",
@@ -31,7 +31,7 @@
     "node": ">=20"
   },
   "scripts": {
-    "types:build": "tsc -p tsconfig.types.json",
+    "types:build": "node -e \"require('fs').rmSync('src/types',{recursive:true,force:true});\" && tsc -p tsconfig.types.json",
     "prepublishOnly": "npm run types:build",
     "lint": "eslint src/",
     "lint:fix": "eslint src/ --fix",
@@ -66,14 +66,14 @@
     "ajv": "^8.17.1",
     "globby": "^16.0.0",
     "json5": "^2.2.3",
-    "yaml": "^2.8.1"
+    "yaml": "^2.8.2"
   },
   "devDependencies": {
     "@gesslar/uglier": "^0.0.5",
     "@stylistic/eslint-plugin": "^5.6.1",
     "@types/node": "^24.10.1",
-    "@typescript-eslint/eslint-plugin": "^8.48.0",
-    "@typescript-eslint/parser": "^8.48.0",
+    "@typescript-eslint/eslint-plugin": "^8.48.1",
+    "@typescript-eslint/parser": "^8.48.1",
     "eslint": "^9.39.1",
     "eslint-plugin-jsdoc": "^61.4.1",
     "globals": "^16.5.0"

package/src/browser/lib/Data.js

@@ -27,7 +27,6 @@ export default class Data {
     "Undefined",
 
     // Object Categories from typeof
-    "AsyncFunction",
     "Function",
     "Object",
   ])
@@ -41,7 +40,6 @@ export default class Data {
   static constructors = Object.freeze([
   // Object Constructors
     "Array",
-    "AsyncFunction",
     "Date",
     "Error",
     "Float32Array",
@@ -192,11 +190,6 @@ export default class Data {
     if(type === "object")
       return value.constructor.name
 
-    if(type === "function") {
-      if(value.constructor.name === "AsyncFunction")
-        return "AsyncFunction"
-    }
-
     const [first, ...rest] = Array.from(type)
 
     return `${first?.toLocaleUpperCase() ?? ""}${rest.join("")}`

package/src/browser/lib/Disposer.js

@@ -6,8 +6,6 @@ import Valid from "./Valid.js"
  */
 export class Disposer {
   #disposers = []
-  #disposed = false
-  #noop = () => {}
 
   /**
    * Registers a disposer callback to be executed when disposed.
@@ -21,13 +19,6 @@ export class Disposer {
    */
   register(...disposers) {
     const normalized = this.#normalizeDisposers(disposers)
-
-    if(this.#disposed) {
-      return normalized.length === 1
-        ? this.#noop
-        : normalized.map(() => this.#noop)
-    }
-
     const unregisters = normalized.map(
       disposer => this.#registerDisposer(disposer)
     )
@@ -36,7 +27,7 @@ export class Disposer {
   }
 
   #registerDisposer(disposer) {
-    if(this.#disposed || typeof disposer !== "function")
+    if(typeof disposer !== "function")
       return () => {}
 
     this.#disposers.push(disposer)
@@ -50,11 +41,6 @@ export class Disposer {
    * @returns {void}
    */
   dispose() {
-    if(this.#disposed)
-      return
-
-    this.#disposed = true
-
     const errors = []
     this.#disposers.toReversed().forEach(disposer => {
       try {
@@ -81,15 +67,6 @@ export class Disposer {
     return normalized
   }
 
-  /**
-   * Whether disposal has run.
-   *
-   * @returns {boolean} True when dispose() has already been called.
-   */
-  get disposed() {
-    return this.#disposed
-  }
-
   /**
    * Read-only list of registered disposers.
    *

package/src/browser/lib/Util.js

@@ -1,7 +1,6 @@
-import Collection from "./Collection.js"
-import Data from "./Data.js"
 import Sass from "./Sass.js"
 import Valid from "./Valid.js"
+import Collection from "./Collection.js"
 
 /**
  * Utility class providing common helper functions for string manipulation,
@@ -255,13 +254,4 @@ export default class Util {
         .join("")
       , flags?.join(""))
   }
-
-  static disasyncify(func) {
-    Valid.type(func, "Function|AsyncFunction")
-
-    if(Data.isType(func, "Function"))
-      return func
-
-    return (async(...arg) => await func(...arg))()
-  }
 }

package/src/index.js

@@ -18,6 +18,7 @@ export {default as DirectoryObject} from "./lib/DirectoryObject.js"
 export {default as FileObject} from "./lib/FileObject.js"
 export {default as FS} from "./lib/FS.js"
 export {default as Glog} from "./lib/Glog.js"
+export {default as Notify} from "./lib/Notify.js"
 export {default as Schemer} from "./lib/Schemer.js"
 export {default as Term} from "./lib/Term.js"
 export {default as Terms} from "./lib/Terms.js"

package/src/lib/DirectoryObject.js

@@ -355,4 +355,29 @@ export default class DirectoryObject extends FS {
 
     return await fs.rmdir(this.path)
   }
+
+  /**
+   * Checks if a file exists within this directory.
+   *
+   * @param {string} filename - The filename to check for
+   * @returns {Promise<boolean>} True if the file exists, false otherwise
+   */
+  async hasFile(filename) {
+    const file = new FileObject(filename, this)
+
+    return await file.exists
+  }
+
+  /**
+   * Checks if a subdirectory exists within this directory.
+   *
+   * @param {string} dirname - The directory name to check for
+   * @returns {Promise<boolean>} True if the directory exists, false otherwise
+   */
+  async hasDirectory(dirname) {
+    const resolved = FS.resolvePath(this.path, dirname)
+    const directory = new DirectoryObject(resolved)
+
+    return await directory.exists
+  }
 }

package/src/lib/Notify.js

@@ -0,0 +1,87 @@
+/**
+ * @file Notify.js
+ * @description Node.js event notification system using EventEmitter.
+ * Provides a centralized API for event emission and handling.
+ */
+
+import {EventEmitter} from "node:events"
+
+/**
+ * @typedef {object} NotifyEventOptions
+ * @property {boolean} [once] - Whether the listener should be invoked only once.
+ * @property {AbortSignal} [signal] - An AbortSignal to remove the listener.
+ */
+
+/**
+ * Notify class provides a thin wrapper around EventEmitter for centralized
+ * event handling in Node.js applications. Mirrors the browser Notify API.
+ */
+export default new class Notify {
+  /** @type {string} Display name for debugging. */
+  name = "Notify"
+
+  /** @type {EventEmitter} Internal event emitter */
+  #emitter = new EventEmitter()
+
+  /**
+   * Emits an event without expecting a return value.
+   *
+   * @param {string} type - Event name to dispatch.
+   * @param {unknown} [payload] - Data to send with the event.
+   * @returns {void}
+   */
+  emit(type, payload=undefined) {
+    this.#emitter.emit(type, payload)
+  }
+
+  /**
+   * Emits an event and returns the payload for simple request/response flows.
+   * Listeners can mutate the payload object to provide responses.
+   *
+   * @param {string} type - Event name to dispatch.
+   * @param {unknown} [payload] - Data to send with the event (will be returned).
+   * @returns {unknown} The payload after listeners have processed it.
+   */
+  request(type, payload={}) {
+    this.#emitter.emit(type, payload)
+
+    return payload
+  }
+
+  /**
+   * Registers a listener for the given event type.
+   *
+   * @param {string} type - Event name to listen for.
+   * @param {(payload: unknown) => void} handler - Listener callback.
+   * @param {EventEmitter} [emitter] - The EventEmitter to attach to. Default is internal emitter.
+   * @param {NotifyEventOptions} [options] - Options for the listener.
+   * @returns {() => void} Dispose function to unregister the handler.
+   */
+  on(type, handler, emitter=this.#emitter, options=undefined) {
+    if(!(typeof type === "string" && type))
+      throw new Error("No event 'type' specified to listen for.")
+
+    if(typeof handler !== "function")
+      throw new Error("No handler function specified.")
+
+    if(options?.once) {
+      emitter.once(type, handler, options)
+    } else {
+      emitter.on(type, handler, options)
+    }
+
+    return () => this.off(type, handler, emitter)
+  }
+
+  /**
+   * Removes a previously registered listener for the given event type.
+   *
+   * @param {string} type - Event name to remove.
+   * @param {(payload: unknown) => void} handler - Listener callback to detach.
+   * @param {EventEmitter} [emitter] - The EventEmitter from which to remove. Default is internal emitter.
+   * @returns {void}
+   */
+  off(type, handler, emitter=this.#emitter) {
+    emitter.off(type, handler)
+  }
+}

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

@@ -1 +1 @@
-{"version":3,"file":"Data.d.ts","sourceRoot":"","sources":["../../../browser/lib/Data.js"],"names":[],"mappings":"AAUA;IACA;;;;;OAKG;IACD,mBAFQ,KAAK,CAAC,MAAM,CAAC,CAiBnB;IAEF;;;;;OAKG;IACH,qBAFU,KAAK,CAAC,MAAM,CAAC,CAoBrB;IAEF;;;;;;;OAOG;IACH,kBAFU,KAAK,CAAC,MAAM,CAAC,CAKrB;IAEF;;;;;OAKG;IACH,uBAFU,KAAK,CAAC,MAAM,CAAC,CAE6C;IAEpE;;;;;;OAMG;IACH,4BAJW,MAAM,UACN,MAAM,GACJ,MAAM,CAIlB;IAED;;;;;;OAMG;IACH,6BAJW,MAAM,WACN,MAAM,GACJ,MAAM,CAIlB;IAED;;;;;;;OAOG;IACH,2BAJW,MAAM,WACN,MAAM,GACJ,KAAK,CAAC,MAAM,CAAC,CAIzB;IAED;;;;;;;OAOG;IACH,qBALW,OAAO,QACP,MAAM,GAAC,QAAQ,YACf,MAAM,GACJ,OAAO,CAQnB;IAED;;;;;OAKG;IACH,yBAHW,MAAM,GACJ,OAAO,CASnB;IAED;;;;;;;;OAQG;IACH,yBAJW,OAAO,QACP,MAAM,GACJ,OAAO,CAwBnB;IAED;;;;;OAKG;IACH,qBAHW,OAAO,GACL,MAAM,CAmBlB;IAED;;;;;OAKG;IACH,wBAHW,OAAO,GACL,OAAO,CAInB;IAED;;;;;;;;OAQG;IACH,sBALW,OAAO,oBACP,OAAO,GAEL,OAAO,CA2BnB;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;CACF;qBAnboB,eAAe"}
+{"version":3,"file":"Data.d.ts","sourceRoot":"","sources":["../../../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,CAE6C;IAEpE;;;;;;OAMG;IACH,4BAJW,MAAM,UACN,MAAM,GACJ,MAAM,CAIlB;IAED;;;;;;OAMG;IACH,6BAJW,MAAM,WACN,MAAM,GACJ,MAAM,CAIlB;IAED;;;;;;;OAOG;IACH,2BAJW,MAAM,WACN,MAAM,GACJ,KAAK,CAAC,MAAM,CAAC,CAIzB;IAED;;;;;;;OAOG;IACH,qBALW,OAAO,QACP,MAAM,GAAC,QAAQ,YACf,MAAM,GACJ,OAAO,CAQnB;IAED;;;;;OAKG;IACH,yBAHW,MAAM,GACJ,OAAO,CASnB;IAED;;;;;;;;OAQG;IACH,yBAJW,OAAO,QACP,MAAM,GACJ,OAAO,CAwBnB;IAED;;;;;OAKG;IACH,qBAHW,OAAO,GACL,MAAM,CAclB;IAED;;;;;OAKG;IACH,wBAHW,OAAO,GACL,OAAO,CAInB;IAED;;;;;;;;OAQG;IACH,sBALW,OAAO,oBACP,OAAO,GAEL,OAAO,CA2BnB;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;CACF;qBA5aoB,eAAe"}

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

@@ -20,12 +20,6 @@ export class Disposer {
      * @returns {void}
      */
     dispose(): void;
-    /**
-     * Whether disposal has run.
-     *
-     * @returns {boolean} True when dispose() has already been called.
-     */
-    get disposed(): boolean;
     /**
      * Read-only list of registered disposers.
      *

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

@@ -1 +1 @@
-{"version":3,"file":"Disposer.d.ts","sourceRoot":"","sources":["../../../browser/lib/Disposer.js"],"names":[],"mappings":"AAEA;;;GAGG;AACH;IAKE;;;;;;;;;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,CAgB1C;IAWD;;;;OAIG;IACH,WAFa,IAAI,CAoBhB;IAcD;;;;OAIG;IACH,gBAFa,OAAO,CAInB;IAED;;;;OAIG;IACH,iBAFa,KAAK,CAAC,MAAM,IAAI,CAAC,CAI7B;;CAQF"}
+{"version":3,"file":"Disposer.d.ts","sourceRoot":"","sources":["../../../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"}

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

@@ -125,6 +125,5 @@ export default class Util {
      */
     static findClosestMatch(input: string, allowedValues: Array<string>, threshold?: number): string;
     static regexify(input: any, trim?: boolean, flags?: any[]): RegExp;
-    static disasyncify(func: any): any;
 }
 //# sourceMappingURL=Util.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Util.d.ts","sourceRoot":"","sources":["../../../browser/lib/Util.js"],"names":[],"mappings":"AAKA;;;GAGG;AACH;IACE;;;;;OAKG;IACH,wBAHW,MAAM,GACJ,MAAM,CAYlB;IAED;;;;;;OAMG;IACH,YAJa,CAAC,MACH,MAAM,OAAO,CAAC,CAAC,CAAC,GACd,OAAO,CAAC;QAAC,MAAM,EAAE,CAAC,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAC,CAAC,CAQ9C;IAED;;;;;;;OAOG;IACH,4BAJW,MAAM,GAAC,MAAM,UACb,MAAM,GACJ,MAAM,CAWlB;IAED;;;;;;;OAOG;IACH,6BAJW,MAAM,GAAC,MAAM,UACb,MAAM,GACJ,MAAM,CAalB;IAED;;;;;;OAMG;IACH,0BAHW,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GACrB,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAInC;IAED;;;;;;OAMG;IACH,2BAHW,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GACrB,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAIlC;IAED;;;;;OAKG;IACH,2BAHW,KAAK,CAAC,MAAM,CAAC,GACX,OAAO,CAInB;IAED;;;;;OAKG;IACH,kCAHW,KAAK,CAAC,MAAM,CAAC,GACX,KAAK,CAAC,MAAM,CAAC,CAIzB;IAED;;;;;OAKG;IACH,iCAHW,KAAK,CAAC,MAAM,CAAC,GACX,KAAK,CAAC,OAAO,CAAC,CAI1B;IAED;;;;;;OAMG;IACH,gCAJW,MAAM,YACN,KAAK,CAAC,MAAM,CAAC,QAKvB;IAED;;;;;OAKG;IACH,mCAHW,KAAK,CAAC,MAAM,CAAC,GACX,KAAK,CAAC,MAAM,CAAC,CAIzB;IAED;;;;;OAKG;IACH,+BAHW,KAAK,CAAC,MAAM,CAAC,GACX,KAAK,CAAC,OAAO,CAAC,CAI1B;IAED;;;;;;OAMG;IACH,sBAHW,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GACrB,OAAO,CAAC,OAAO,CAAC,CAI5B;IAED;;;;;;OAMG;IACH,8BAJW,MAAM,KACN,MAAM,GACJ,MAAM,CAsBlB;IAED;;;;;;;;OAQG;IACH,+BALW,MAAM,iBACN,KAAK,CAAC,MAAM,CAAC,cACb,MAAM,GACJ,MAAM,CAwBlB;IAED,mEAiBC;IAED,mCAOC;CACF"}
+{"version":3,"file":"Util.d.ts","sourceRoot":"","sources":["../../../browser/lib/Util.js"],"names":[],"mappings":"AAIA;;;GAGG;AACH;IACE;;;;;OAKG;IACH,wBAHW,MAAM,GACJ,MAAM,CAYlB;IAED;;;;;;OAMG;IACH,YAJa,CAAC,MACH,MAAM,OAAO,CAAC,CAAC,CAAC,GACd,OAAO,CAAC;QAAC,MAAM,EAAE,CAAC,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAC,CAAC,CAQ9C;IAED;;;;;;;OAOG;IACH,4BAJW,MAAM,GAAC,MAAM,UACb,MAAM,GACJ,MAAM,CAWlB;IAED;;;;;;;OAOG;IACH,6BAJW,MAAM,GAAC,MAAM,UACb,MAAM,GACJ,MAAM,CAalB;IAED;;;;;;OAMG;IACH,0BAHW,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GACrB,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAInC;IAED;;;;;;OAMG;IACH,2BAHW,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GACrB,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAIlC;IAED;;;;;OAKG;IACH,2BAHW,KAAK,CAAC,MAAM,CAAC,GACX,OAAO,CAInB;IAED;;;;;OAKG;IACH,kCAHW,KAAK,CAAC,MAAM,CAAC,GACX,KAAK,CAAC,MAAM,CAAC,CAIzB;IAED;;;;;OAKG;IACH,iCAHW,KAAK,CAAC,MAAM,CAAC,GACX,KAAK,CAAC,OAAO,CAAC,CAI1B;IAED;;;;;;OAMG;IACH,gCAJW,MAAM,YACN,KAAK,CAAC,MAAM,CAAC,QAKvB;IAED;;;;;OAKG;IACH,mCAHW,KAAK,CAAC,MAAM,CAAC,GACX,KAAK,CAAC,MAAM,CAAC,CAIzB;IAED;;;;;OAKG;IACH,+BAHW,KAAK,CAAC,MAAM,CAAC,GACX,KAAK,CAAC,OAAO,CAAC,CAI1B;IAED;;;;;;OAMG;IACH,sBAHW,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GACrB,OAAO,CAAC,OAAO,CAAC,CAI5B;IAED;;;;;;OAMG;IACH,8BAJW,MAAM,KACN,MAAM,GACJ,MAAM,CAsBlB;IAED;;;;;;;;OAQG;IACH,+BALW,MAAM,iBACN,KAAK,CAAC,MAAM,CAAC,cACb,MAAM,GACJ,MAAM,CAwBlB;IAED,mEAiBC;CACF"}

package/src/types/index.d.ts

@@ -11,6 +11,7 @@ export { default as DirectoryObject } from "./lib/DirectoryObject.js";
 export { default as FileObject } from "./lib/FileObject.js";
 export { default as FS } from "./lib/FS.js";
 export { default as Glog } from "./lib/Glog.js";
+export { default as Notify } from "./lib/Notify.js";
 export { default as Schemer } from "./lib/Schemer.js";
 export { default as Term } from "./lib/Term.js";
 export { default as Terms } from "./lib/Terms.js";

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

@@ -150,6 +150,20 @@ export default class DirectoryObject extends FS {
      * await dir.delete() // Only works if directory is empty
      */
     delete(): Promise<void>;
+    /**
+     * Checks if a file exists within this directory.
+     *
+     * @param {string} filename - The filename to check for
+     * @returns {Promise<boolean>} True if the file exists, false otherwise
+     */
+    hasFile(filename: string): Promise<boolean>;
+    /**
+     * Checks if a subdirectory exists within this directory.
+     *
+     * @param {string} dirname - The directory name to check for
+     * @returns {Promise<boolean>} True if the directory exists, false otherwise
+     */
+    hasDirectory(dirname: string): Promise<boolean>;
     /**
      * Custom inspect method for Node.js console.
      *

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

@@ -1 +1 @@
-{"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"}
+{"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;IAED;;;;;OAKG;IACH,kBAHW,MAAM,GACJ,OAAO,CAAC,OAAO,CAAC,CAM5B;IAED;;;;;OAKG;IACH,sBAHW,MAAM,GACJ,OAAO,CAAC,OAAO,CAAC,CAO5B;IAhRD;;;;OAIG;IACH,yBAFa,MAAM,CAIlB;;CA0QF;eAnXc,SAAS;oBAFN,UAAU;uBAGL,iBAAiB;iBAJvB,WAAW"}

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

@@ -0,0 +1,55 @@
+declare const _default: {
+    /** @type {string} Display name for debugging. */
+    name: string;
+    /** @type {EventEmitter} Internal event emitter */
+    "__#private@#emitter": EventEmitter;
+    /**
+     * Emits an event without expecting a return value.
+     *
+     * @param {string} type - Event name to dispatch.
+     * @param {unknown} [payload] - Data to send with the event.
+     * @returns {void}
+     */
+    emit(type: string, payload?: unknown): void;
+    /**
+     * Emits an event and returns the payload for simple request/response flows.
+     * Listeners can mutate the payload object to provide responses.
+     *
+     * @param {string} type - Event name to dispatch.
+     * @param {unknown} [payload] - Data to send with the event (will be returned).
+     * @returns {unknown} The payload after listeners have processed it.
+     */
+    request(type: string, payload?: unknown): unknown;
+    /**
+     * Registers a listener for the given event type.
+     *
+     * @param {string} type - Event name to listen for.
+     * @param {(payload: unknown) => void} handler - Listener callback.
+     * @param {EventEmitter} [emitter] - The EventEmitter to attach to. Default is internal emitter.
+     * @param {NotifyEventOptions} [options] - Options for the listener.
+     * @returns {() => void} Dispose function to unregister the handler.
+     */
+    on(type: string, handler: (payload: unknown) => void, emitter?: EventEmitter, options?: NotifyEventOptions): () => void;
+    /**
+     * Removes a previously registered listener for the given event type.
+     *
+     * @param {string} type - Event name to remove.
+     * @param {(payload: unknown) => void} handler - Listener callback to detach.
+     * @param {EventEmitter} [emitter] - The EventEmitter from which to remove. Default is internal emitter.
+     * @returns {void}
+     */
+    off(type: string, handler: (payload: unknown) => void, emitter?: EventEmitter): void;
+};
+export default _default;
+export type NotifyEventOptions = {
+    /**
+     * - Whether the listener should be invoked only once.
+     */
+    once?: boolean;
+    /**
+     * - An AbortSignal to remove the listener.
+     */
+    signal?: AbortSignal;
+};
+import { EventEmitter } from "node:events";
+//# sourceMappingURL=Notify.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Notify.d.ts","sourceRoot":"","sources":["../../lib/Notify.js"],"names":[],"mappings":";IAmBE,iDAAiD;UAAtC,MAAM;IAGjB,kDAAkD;2BAAvC,YAAY;IAGvB;;;;;;OAMG;eAHQ,MAAM,YACN,OAAO,GACL,IAAI;IAMjB;;;;;;;OAOG;kBAHQ,MAAM,YACN,OAAO,GACL,OAAO;IAQpB;;;;;;;;OAQG;aALQ,MAAM,WACN,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,YAC1B,YAAY,YACZ,kBAAkB,GAChB,MAAM,IAAI;IAkBvB;;;;;;;OAOG;cAJQ,MAAM,WACN,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,YAC1B,YAAY,GACV,IAAI;;;;;;;WAvEL,OAAO;;;;aACP,WAAW;;6BALE,aAAa"}

package/src/browser/lib/Hook.js

@@ -1,82 +0,0 @@
-import Sass from "./Sass.js"
-import Valid from "./Valid.js"
-
-class PipeClass {
-  name = "Pipe"
-
-  #lastResult
-  #it = 0
-
-  constructor(func) {
-    Valid.type(func, "Function|AsyncFunction|Promise")
-
-    this.#processStart(func)
-  }
-
-  static source(func) {
-    return new this(func)
-  }
-
-  async then(func) {
-    if(++this.it > 2)
-      throw new Error("hi")
-
-    console.log("then", this.#lastResult, "func", func)
-
-    this.#lastResult =
-      this.#lastResult.then(prev => this.#resolve(func, prev))
-
-    return this
-    /*
-
-    this.#processThen(func)
-
-    return this
-    */
-  }
-
-  get value() {
-    return this.#processResult()
-  }
-
-  #processStart(func) {
-    console.log("start", func)
-
-    this.#lastResult = Promise.resolve(this.#resolve(func))
-  }
-
-  #processThen(func) {
-    if(++this.#it > 2)
-      throw new Error("hi")
-
-    this.#lastResult = this.#lastResult.then(prev => this.#resolve(func, prev))
-  }
-
-  #processResult() {
-    const result = this.#lastResult
-    this.#lastResult = undefined
-
-    return result
-  }
-
-  #resolve = (val, prev) => typeof val === "function" ? val(prev) : val
-}
-
-export default new Proxy(PipeClass, {
-  apply(target, _, argumentsList) {
-    return target.source(...argumentsList)
-  },
-
-  construct(..._) {
-    throw new Sass("This class may not be instantiated in this manner.")
-  },
-
-  get(target, prop) {
-    // Hide 'source' method from public API
-    if(prop === "source") {
-      return undefined
-    }
-
-    return Reflect.get(target, prop)
-  }
-})

package/src/browser/lib/test.js

@@ -1,25 +0,0 @@
-import {setTimeout as timeout} from "node:timers/promises"
-import Pipe from "./Hook.js"
-import Disposer from "./Disposer.js"
-
-const step1 = () => 1
-const step2 = num => num+1
-const step3 = num => num+1
-const step4 = async num => {
-  console.log("Waiting for",num,typeof num)
-  await timeout(5_000)
-
-  return num + 1
-}
-const step5 = num => num+1
-const step6 = num => num+1
-
-const result = await Pipe(step1)
-  .then(step2)
-  .then(step3)
-  .then(step4)
-  .then(step5)
-  .then(step6)
-  .result
-
-console.log("result", result)

package/src/browser/lib/test2.js

@@ -1,46 +0,0 @@
-import {setTimeout as timeout} from "node:timers/promises"
-
-const step1 = () => 1
-const step2 = num => num+1
-const step3 = num => num+1
-const step4 = async num => {
-  console.log("Waiting for",num,typeof num)
-  await timeout(5_000)
-
-  return num + 1
-}
-const step5 = num => num+1
-const step6 = num => num+1
-
-function Pipe(initialPromise) {
-  console.log("start", initialPromise)
-
-  const resolve = (val, prev) =>
-    typeof val === "function" ? val(prev) : val
-
-  let chain = Promise.resolve(resolve(initialPromise))
-
-  return {
-    then(promiseOrFn) {
-      console.log("then", chain, "func", promiseOrFn)
-
-      chain = chain.then(prev => resolve(promiseOrFn, prev))
-
-      return this
-    },
-
-    get result() {
-      return chain
-    }
-  }
-}
-
-const result = await Pipe(step1)
-  .then(step2)
-  .then(step3)
-  .then(step4)
-  .then(step5)
-  .then(step6)
-  .result
-
-console.log("result", result)

package/src/types/Cache.d.ts

@@ -1,30 +0,0 @@
-// Implementation: ../lib/Cache.js
-import FileObject from './FileObject.js'
-
-/**
- * File system cache for theme compilation data with automatic invalidation.
- * Provides intelligent caching of parsed JSON5/YAML files with mtime-based
- * cache invalidation to optimize parallel theme compilation performance.
- *
- * The cache eliminates redundant file reads and parsing when multiple themes
- * import the same dependency files, while ensuring data freshness through
- * modification time checking.
- */
-declare class Cache {
-  /**
-   * Loads and caches parsed file data with automatic invalidation based on
-   * modification time.
-   *
-   * Implements a sophisticated caching strategy that checks file modification
-   * times to determine whether cached data is still valid, ensuring data
-   * freshness while optimizing performance for repeated file access during
-   * parallel theme compilation.
-   *
-   * @param fileObject - The file object to load and cache
-   * @returns The parsed file data (JSON5 or YAML)
-   * @throws If the file cannot be found or accessed
-   */
-  loadCachedData(fileObject: FileObject): Promise<unknown>
-}
-
-export default Cache