@gesslar/toolkit 3.13.0 → 3.14.1

package/src/{lib/CappedDirectoryObject.js → node/lib/VDirectoryObject.js}

@@ -1,5 +1,5 @@
 /**
- * @file CappedDirectoryObject.js
+ * @file VDirectoryObject.js
  * @description Abstract base class for directory objects that are constrained
  * to a specific directory tree (the "cap"). This provides security by ensuring
  * all operations remain within the capped directory hierarchy.
@@ -11,12 +11,11 @@
 import path from "node:path"
 
 import DirectoryObject from "./DirectoryObject.js"
-import FileObject from "./FileObject.js"
-import FS from "./FS.js"
+import FileSystem from "./FileSystem.js"
 import Valid from "./Valid.js"
 
 /**
- * CappedDirectoryObject extends DirectoryObject with constraints that ensure
+ * VDirectoryObject extends DirectoryObject with constraints that ensure
  * all operations are restricted to a specific directory tree (the "cap").
  *
  * All path operations are validated to ensure they remain within the
@@ -24,45 +23,44 @@ import Valid from "./Valid.js"
  *
  * @augments DirectoryObject
  */
-export default class CappedDirectoryObject extends DirectoryObject {
+export default class VDirectoryObject extends DirectoryObject {
   #real
   #cap
   #cappedParentPath
   #cappedParent
 
   /**
-   * Constructs a CappedDirectoryObject instance.
+   * Constructs a VDirectoryObject instance.
    *
-   * Without a parent, the path becomes both the directory location and the cap
-   * (virtual root). With a parent, the path is resolved relative to the parent's
-   * cap using virtual path semantics (absolute paths treated as cap-relative).
+   * Without a parent, creates a new cap at the specified real directory location
+   * with virtual path "/". With a parent, the path is resolved relative to the
+   * parent's virtual path (absolute paths treated as cap-relative).
    *
-   * @param {string} [directory="."] - Directory path (becomes cap if no parent, else relative to parent's cap, defaults to current directory)
-   * @param {CappedDirectoryObject?} [parent] - Optional parent capped directory
-   * @throws {Sass} If parent is provided but not a CappedDirectoryObject
-   * @throws {Sass} If the resulting path would escape the cap
+   * @param {string} [directory="."] - Real directory path when no parent (becomes cap), or relative/absolute virtual path when parent provided
+   * @param {VDirectoryObject?} [parent] - Optional parent capped directory
+   * @throws {Sass} If parent is provided but not a VDirectoryObject
    * @example
    * // Create new capped directory at current directory
-   * const cwd = new CappedDirectoryObject()
-   * // path: process.cwd(), cap: process.cwd()
+   * const cwd = new VDirectoryObject()
+   * // Virtual path: "/", Real path: process.cwd(), Cap: itself
    *
    * @example
    * // Create new capped directory
-   * const cache = new CappedDirectoryObject("/home/user/.cache")
-   * // path: /home/user/.cache, cap: /home/user/.cache
+   * const cache = new VDirectoryObject("/home/user/.cache")
+   * // Virtual path: "/", Real path: /home/user/.cache, Cap: itself
    *
    * @example
    * // Create subdirectory with parent
-   * const data = new CappedDirectoryObject("data", cache)
-   * // path: /home/user/.cache/data, cap: /home/user/.cache
+   * const data = new VDirectoryObject("data", cache)
+   * // Virtual path: /data, Real path: /home/user/.cache/data, Cap: cache
    *
    * @example
-   * // Virtual absolute path with parent
-   * const config = new CappedDirectoryObject("/etc/config", cache)
-   * // path: /home/user/.cache/etc/config, cap: /home/user/.cache
+   * // Virtual absolute path with parent (treated as cap-relative)
+   * const config = new VDirectoryObject("/etc/config", cache)
+   * // Virtual path: /etc/config, Real path: /home/user/.cache/etc/config, Cap: cache
    */
   constructor(directory, source=null) {
-    Valid.type(source, "Null|CappedDirectoryObject")
+    Valid.type(source, "Null|VDirectoryObject")
 
     directory ||= "."
 
@@ -73,9 +71,9 @@ export default class CappedDirectoryObject extends DirectoryObject {
       directory = directory.slice(1)
 
     // Find out what directory means to the basePath
-    const realResolved = FS.resolvePath(baseRealPath, directory)
+    const realResolved = FileSystem.resolvePath(baseRealPath, directory)
     const localResolved = source
-      ? FS.resolvePath(baseLocalPath, directory)
+      ? FileSystem.resolvePath(baseLocalPath, directory)
       : path.parse(path.resolve("")).root
 
     super(localResolved)
@@ -93,14 +91,14 @@ export default class CappedDirectoryObject extends DirectoryObject {
   }
 
   /**
-   * Creates a CappedDirectoryObject from the current working directory.
+   * Creates a VDirectoryObject from the current working directory.
    * This is useful when working with pnpx or other tools where you need to
    * cap at the project's root directory determined at runtime.
    *
-   * @returns {CappedDirectoryObject} A CappedDirectoryObject capped at the current working directory
+   * @returns {VDirectoryObject} A VDirectoryObject capped at the current working directory
    * @example
    * // When using pnpx or similar tools
-   * const projectRoot = CappedDirectoryObject.fromCwd()
+   * const projectRoot = VDirectoryObject.fromCwd()
    * const srcDir = projectRoot.getDirectory("src")
    * // srcDir is capped at the project root
    */
@@ -110,26 +108,26 @@ export default class CappedDirectoryObject extends DirectoryObject {
 
   /**
    * Indicates whether this directory is capped (constrained to a specific tree).
-   * Always returns true for CappedDirectoryObject instances.
+   * Always returns true for VDirectoryObject instances.
    *
-   * @returns {boolean} True for all CappedDirectoryObject instances
+   * @returns {boolean} True for all VDirectoryObject instances
    * @example
    * const capped = new TempDirectoryObject("myapp")
-   * console.log(capped.isCapped) // true
+   * console.log(capped.isVirtual) // true
    *
    * const regular = new DirectoryObject("/tmp")
-   * console.log(regular.isCapped) // false
+   * console.log(regular.isVirtual) // false
    */
-  get isCapped() {
+  get isVirtual() {
     return true
   }
 
   /**
    * Returns the cap (root) of the capped directory tree.
-   * For root CappedDirectoryObject instances, returns itself.
+   * For root VDirectoryObject instances, returns itself.
    * For children, returns the inherited cap from the parent chain.
    *
-   * @returns {CappedDirectoryObject} The cap directory object (root of the capped tree)
+   * @returns {VDirectoryObject} The cap directory object (root of the capped tree)
    * @example
    * const temp = new TempDirectoryObject("myapp")
    * console.log(temp.cap === temp) // true (root is its own cap)
@@ -167,14 +165,14 @@ export default class CappedDirectoryObject extends DirectoryObject {
    * Returns the parent directory of this capped directory.
    * Returns null only if this directory is at the cap (the "root" of the capped tree).
    *
-   * Note: The returned parent is a CappedDirectoryObject with the same cap.
+   * Note: The returned parent is a VDirectoryObject with the same cap.
    * This maintains the capping behavior throughout the directory hierarchy.
    *
-   * @returns {CappedDirectoryObject|null} Parent directory or null if at cap root
+   * @returns {VDirectoryObject|null} Parent directory or null if at cap root
    * @example
    * const capped = new TempDirectoryObject("myapp")
    * const subdir = capped.getDirectory("data")
-   * console.log(subdir.parent.path) // Returns parent CappedDirectoryObject
+   * console.log(subdir.parent.path) // Returns parent VDirectoryObject
    * console.log(capped.parent) // null (at cap root)
    */
   get parent() {
@@ -191,63 +189,10 @@ export default class CappedDirectoryObject extends DirectoryObject {
    * console.log(temp.parentPath) // null (at cap root)
    *
    * const subdir = temp.getDirectory("data")
-   * console.log(subdir.parentPath) // "/data" or similar (parent's virtual path)
+   * console.log(subdir.parentPath) // "/" (parent's virtual path)
    */
   get parentPath() {
     return this.#cappedParentPath
   }
 
-  /**
-   * Override exists to use real filesystem path.
-   *
-   * @returns {Promise<boolean>} Whether the directory exists
-   */
-  get exists() {
-    return this.real.exists
-  }
-
-  /**
-   * Override read to use real filesystem path and return capped objects.
-   *
-   * @param {string} [pat=""] - Optional glob pattern
-   * @returns {Promise<{files: Array<FileObject>, directories: Array}>} Directory contents
-   */
-  async read(...arg) {
-    const {files, directories} = await this.real.read(...arg)
-
-    // we need to re-cast
-    const recastDirs = directories.map(e => this.getDirectory(e.name))
-    const recastFiles = files.map(f => new FileObject(f.name, this))
-
-    return {files: recastFiles, directories: recastDirs}
-  }
-
-  /**
-   * Override hasDirectory to use real filesystem path.
-   *
-   * @param {string} dirname - Directory name to check
-   * @returns {Promise<boolean>} True if directory exists
-   */
-  async hasDirectory(dirname) {
-    return await this.real.hasDirectory(dirname)
-  }
-
-  /**
-   * Override assureExists to use real filesystem path.
-   *
-   * @param {object} [options] - Options for mkdir
-   * @returns {Promise<void>}
-   */
-  async assureExists(options = {}) {
-    return await this.real.assureExists(options)
-  }
-
-  /**
-   * Override delete to use real filesystem path.
-   *
-   * @returns {Promise<void>}
-   */
-  async delete() {
-    return await this.real.delete()
-  }
 }

package/src/node/lib/VFileObject.js

@@ -0,0 +1,61 @@
+/**
+ * @file VFileObject.js
+ * @description Class representing a virtual file within a capped directory tree.
+ * Extends FileObject with virtual path support and real filesystem mapping.
+ */
+
+import FileObject from "./FileObject.js"
+import FS from "./FileSystem.js"
+import Valid from "./Valid.js"
+
+/**
+ * VFileObject extends FileObject with virtual path support, maintaining both
+ * a virtual path (relative to cap) and a real filesystem path.
+ *
+ * Virtual files must have a VDirectoryObject parent and cannot exist independently.
+ * All file operations use the real filesystem path while exposing clean virtual paths.
+ *
+ * @property {string} supplied - User-supplied path
+ * @property {string} path - The virtual file path (relative to cap)
+ * @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
+ * @property {boolean} isFile - Always true for files
+ * @property {boolean} isVirtual - Always true for VFileObject instances
+ * @property {VDirectoryObject} parent - The parent virtual directory object
+ * @property {FileObject} real - The real filesystem FileObject
+ * @property {Promise<boolean>} exists - Whether the file exists (async)
+ */
+
+export default class VFileObject extends FileObject {
+  #real
+
+  /**
+   * Constructs a VFileObject instance.
+   *
+   * @param {string} fileName - The file path
+   * @param {VDirectoryObject} parent - The parent virtual directory (required)
+   */
+  constructor(fileName, parent) {
+    Valid.type(fileName, "String", {allowEmpty: false})
+    Valid.type(parent, "VDirectoryObject")
+
+    super(fileName, parent)
+
+    const parentRealPath = this.parent.real.path
+    const relative = FS.absoluteToRelative(this.path, true)
+    const resolved = FS.resolvePath(parentRealPath, relative)
+    const {base, dir} = FS.pathParts(resolved)
+
+    this.#real = new FileObject(base, dir)
+  }
+
+  get isVirtual() {
+    return true
+  }
+
+  get real() {
+    return this.#real
+  }
+}

package/src/{lib → node/lib}/Valid.js

@@ -6,8 +6,8 @@
  */
 
 import Sass from "./Sass.js"
-import Data from "../browser/lib/Data.js"
-import Collection from "../browser/lib/Collection.js"
+import Data from "../../browser/lib/Data.js"
+import Collection from "../../browser/lib/Collection.js"
 
 /**
  * Validation utility class providing type checking and assertion methods.
@@ -23,10 +23,14 @@ export default class Valid {
    * @param {object} [options] - Additional options for validation.
    */
   static type(value, type, options) {
+    const expected = [type]
+
+    if(options?.allowEmpty !== true)
+      expected.push("[no empty values]")
+
     Valid.assert(
       Data.isType(value, type, options),
-      `Invalid type. Expected ${type}, got ${Data.typeOf(value)}`,
-      1,
+      `Invalid type. Expected ${expected.join(" ")}, got ${Data.typeOf(value)}`
     )
   }
 
@@ -57,7 +61,9 @@ export default class Valid {
   }
 
   /**
-   * Protects against prototype pollution by checking keys for dangerous property names.
+   * Protects against prototype pollution by checking keys for dangerous
+   * property names.
+   *
    * Throws if any restricted prototype properties are found in the keys array.
    *
    * @param {Array<string>} keys - Array of property keys to validate

package/{src/types → types/browser}/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.js"],"names":[],"mappings":""}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/browser/index.js"],"names":[],"mappings":""}

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

@@ -0,0 +1 @@
+{"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.map

@@ -0,0 +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;;;;;;;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,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;CACF;qBAhgBoB,eAAe"}

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

@@ -0,0 +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"}

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

@@ -0,0 +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"}

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

@@ -0,0 +1 @@
+{"version":3,"file":"Notify.d.ts","sourceRoot":"","sources":["../../../src/browser/lib/Notify.js"],"names":[],"mappings":";IAaE,iDAAiD;UAAtC,MAAM;IAGjB;;;;;;;OAOG;eAJQ,MAAM,YACN,OAAO,YACP,OAAO,GAAG,kBAAkB,GAC1B,IAAI;IAOjB;;;;;;;OAOG;kBAJQ,MAAM,YACN,OAAO,YACP,OAAO,GAAG,kBAAkB,GAC1B,OAAO;IASpB;;;;;;;;;OASG;aALQ,MAAM,WACN,CAAC,GAAG,gBAAQ,KAAK,IAAI,YACrB,WAAW,GAAG,MAAM,YACpB,OAAO,GAAG,MAAM,GACd,MAAM,IAAI;IAcvB;;;;;;;;OAQG;cALQ,MAAM,WACN,CAAC,GAAG,gBAAQ,KAAK,IAAI,YACrB,WAAW,GAAG,MAAM,YACpB,OAAO,GAAG,MAAM,GACd,IAAI;;;;;;;;cAjEL,OAAO;;;;iBACP,OAAO;;;;eACP,OAAO"}

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

@@ -0,0 +1 @@
+{"version":3,"file":"Promised.d.ts","sourceRoot":"","sources":["../../../src/browser/lib/Promised.js"],"names":[],"mappings":"AAEA;;;GAGG;AACH;IACE;;;;;;OAMG;IACH,uBAHW,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GACrB,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAInC;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,CAI/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,QAQpF;IAED;;;;;;OAMG;IACH,sBAHW,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GACrB,OAAO,CAAC,OAAO,CAAC,CAI5B;CACF"}

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

@@ -0,0 +1 @@
+{"version":3,"file":"Sass.d.ts","sourceRoot":"","sources":["../../../src/browser/lib/Sass.js"],"names":[],"mappings":"AAeA;;;GAGG;AACH;IAgIE;;;;;;;;OAQG;IACH,mBALW,KAAK,WACL,MAAM,GACJ,IAAI,CAahB;IAED;;;;;;;;OAQG;IACH,sBAJW,MAAM,UACN,KAAK,GAAC,IAAI,GAAC,OAAO,GAChB,IAAI,CAchB;IAvKD;;;;;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,QAyCjB;;CA6EF;oBAjLmB,cAAc"}

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

@@ -0,0 +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"}

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

@@ -0,0 +1 @@
+{"version":3,"file":"Time.d.ts","sourceRoot":"","sources":["../../../src/browser/lib/Time.js"],"names":[],"mappings":"AAEA;;;GAGG;AACH;IACE;;;;;;;;;;;;;;;;;;OAkBG;IACH,oBAfW,MAAM,UACN,OAAO,GACL,OAAO,CAAC,OAAO,CAAC,GAAG;QAAC,OAAO,EAAE,MAAM,CAAA;KAAC,CAwBhD;IAED;;;;;;;;;OASG;IACH,uBANW,OAAO,CAAC,OAAO,CAAC,GAAG;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAC,GACnC,IAAI,CAQhB;CACF"}

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

@@ -0,0 +1 @@
+{"version":3,"file":"TypeSpec.d.ts","sourceRoot":"","sources":["../../../src/browser/lib/TypeSpec.js"],"names":[],"mappings":"AAWA;;;GAGG;AACH;IAGE;;;;;OAKG;IACH,oBAHW,MAAM,WACN,OAAO,EAUjB;IAJC,aAAwB;IACxB,eAAgC;IAChC,6BAA2C;IAI7C;;;;OAIG;IACH,YAFa,MAAM,CAQlB;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;;;;;;;;OAQG;IACH,eALW,OAAO,WACP,OAAO,GAEL,OAAO,CAInB;IAED,2CA6DC;;CAmDF"}

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

@@ -0,0 +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,mEAiBC;CACF"}

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

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

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

@@ -0,0 +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"}

package/{src/types → types/node}/index.d.ts

@@ -1,20 +1,21 @@
-export { default as Collection } from "./browser/lib/Collection.js";
-export { default as Data } from "./browser/lib/Data.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";
+export { default as Collection } from "../browser/lib/Collection.js";
+export { default as Data } from "../browser/lib/Data.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";
 export { default as Valid } from "./lib/Valid.js";
 export { default as Sass } from "./lib/Sass.js";
 export { default as Tantrum } from "./lib/Tantrum.js";
 export { default as Util } from "./lib/Util.js";
 export { default as Cache } from "./lib/Cache.js";
-export { default as CappedDirectoryObject } from "./lib/CappedDirectoryObject.js";
 export { default as DirectoryObject } from "./lib/DirectoryObject.js";
-export { default as TempDirectoryObject } from "./lib/TempDirectoryObject.js";
 export { default as FileObject } from "./lib/FileObject.js";
-export { default as FS } from "./lib/FS.js";
+export { default as FS } from "./lib/FileSystem.js";
 export { default as Glog } from "./lib/Glog.js";
 export { default as Notify } from "./lib/Notify.js";
+export { default as TempDirectoryObject } from "./lib/TempDirectoryObject.js";
 export { default as Term } from "./lib/Term.js";
-export { default as Disposer, Disposer as DisposerClass } from "./browser/lib/Disposer.js";
+export { default as VFileObject } from "./lib/VFileObject.js";
+export { default as VDirectoryObject } from "./lib/VDirectoryObject.js";
+export { default as Disposer, Disposer as DisposerClass } from "../browser/lib/Disposer.js";
 //# sourceMappingURL=index.d.ts.map

package/{src/types/browser → types/node}/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../browser/index.js"],"names":[],"mappings":""}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/node/index.js"],"names":[],"mappings":""}

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

@@ -0,0 +1 @@
+{"version":3,"file":"Cache.d.ts","sourceRoot":"","sources":["../../../src/node/lib/Cache.js"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH;IAoBE;;;;;;;;;;;;OAYG;IACH,2BAJW,OAAO,iBAAiB,EAAE,UAAU,GAClC,OAAO,CAAC,OAAO,CAAC,CA6B5B;;CACF"}

package/{src/types → types/node}/lib/DirectoryObject.d.ts

@@ -17,7 +17,6 @@
  * @property {string} extension - The directory extension (typically empty string)
  * @property {string} sep - Platform-specific path separator ('/' or '\\')
  * @property {Array<string>} trail - Path segments split by separator
- * @property {boolean} isFile - Always false (this is a directory)
  * @property {boolean} isDirectory - Always true
  * @property {DirectoryObject|null} parent - The parent directory (null if root)
  * @property {Promise<boolean>} exists - Whether the directory exists (async getter)
@@ -60,9 +59,9 @@ export default class DirectoryObject extends FS {
     /**
      * Constructs a DirectoryObject instance.
      *
-     * @param {string?} [directory="."] - The directory path or DirectoryObject (defaults to current directory)
+     * @param {string?} [supplied="."] - The directory path (defaults to current directory)
      */
-    constructor(directory?: string | null);
+    constructor(supplied?: string | null);
     /**
      * Checks if the directory exists (async).
      *
@@ -134,12 +133,6 @@ export default class DirectoryObject extends FS {
      * console.log(root.parent) // null
      */
     get parent(): DirectoryObject | null;
-    /**
-     * Returns false. Because this is a directory.
-     *
-     * @returns {boolean} Always false
-     */
-    get isFile(): boolean;
     /**
      * We're a directory!
      *
@@ -149,9 +142,12 @@ export default class DirectoryObject extends FS {
     /**
      * Lists the contents of a directory, optionally filtered by a glob pattern.
      *
+     * Returns FileObject and DirectoryObject instances for regular directories.
+     * Returns VFileObject and VDirectoryObject instances when called on virtual directories.
+     *
      * @async
      * @param {string} [pat=""] - Optional glob pattern to filter results (e.g., "*.txt", "test-*")
-     * @returns {Promise<{files: Array<FileObject>, directories: Array<DirectoryObject>}>} Object containing arrays of files and directories
+     * @returns {Promise<{files: Array<FileObject|VFileObject>, directories: Array<DirectoryObject|VDirectoryObject>}>} Object containing arrays of files and directories
      * @example
      * const dir = new DirectoryObject("./src")
      * const {files, directories} = await dir.read()
@@ -163,8 +159,8 @@ export default class DirectoryObject extends FS {
      * console.log(files) // Only .js files in ./src
      */
     read(pat?: string): Promise<{
-        files: Array<FileObject>;
-        directories: Array<DirectoryObject>;
+        files: Array<FileObject | VFileObject>;
+        directories: Array<DirectoryObject | VDirectoryObject>;
     }>;
     /**
      * Ensures a directory exists, creating it if necessary.
@@ -256,8 +252,11 @@ export default class DirectoryObject extends FS {
      * duplication. The resulting FileObject can be used for reading, writing,
      * and other file operations.
      *
+     * When called on a VDirectoryObject, returns a VFileObject to maintain
+     * virtual path semantics.
+     *
      * @param {string} file - The filename to append (can include subdirectories like "src/index.js")
-     * @returns {FileObject} A new FileObject instance with the combined path
+     * @returns {FileObject|VFileObject} A new FileObject (or VFileObject if virtual)
      * @throws {Sass} If filename is not a string
      * @example
      * const dir = new DirectoryObject("/projects/git/toolkit")
@@ -269,9 +268,10 @@ export default class DirectoryObject extends FS {
      * const file = dir.getFile("src/index.js")
      * const data = await file.read()
      */
-    getFile(file: string): FileObject;
+    getFile(file: string): FileObject | VFileObject;
     #private;
 }
-import FS from "./FS.js";
+import FS from "./FileSystem.js";
 import FileObject from "./FileObject.js";
+import VFileObject from "./VFileObject.js";
 //# sourceMappingURL=DirectoryObject.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DirectoryObject.d.ts","sourceRoot":"","sources":["../../../src/node/lib/DirectoryObject.js"],"names":[],"mappings":"AAiBA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH;IA2DE;;;;;;;;;OASG;IACH,kBALa,eAAe,CAO3B;IA3CD;;;;OAIG;IACH,uBAFW,MAAM,OAAC,EA0BjB;IA2BD;;;;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;;;;;;;;;;;;OAYG;IACH,cARa,eAAe,GAAC,IAAI,CAsBhC;IAED;;;;OAIG;IACH,mBAFa,OAAO,CAInB;IAmBD;;;;;;;;;;;;;;;;;;OAkBG;IACH,WAZW,MAAM,GACJ,OAAO,CAAC;QAAC,KAAK,EAAE,KAAK,CAAC,UAAU,GAAC,WAAW,CAAC,CAAC;QAAC,WAAW,EAAE,KAAK,CAAC,eAAe,GAAC,gBAAgB,CAAC,CAAA;KAAC,CAAC,CAiDjH;IAED;;;;;;;;;;;;OAYG;IACH,uBARW,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAuBzB;IAyBD;;;;;;;;;;;;;;;OAeG;IACH,cAZa,eAAe,CAc3B;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;IAUD;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,kBAdW,MAAM,GACJ,eAAe,CAqB3B;IAED;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,cAbW,MAAM,GACJ,UAAU,GAAC,WAAW,CAsBlC;;CACF;eArhBc,iBAAiB;uBACT,iBAAiB;wBAGhB,kBAAkB"}

package/{src/types → types/node}/lib/FileObject.d.ts

@@ -9,7 +9,6 @@
  * @property {string} module - The file name without extension
  * @property {string} extension - The file extension
  * @property {boolean} isFile - Always true for files
- * @property {boolean} isDirectory - Always false for files
  * @property {DirectoryObject} parent - The parent directory object
  * @property {Promise<boolean>} exists - Whether the file exists (async)
  */
@@ -26,10 +25,10 @@ export default class FileObject extends FS {
     /**
      * Constructs a FileObject instance.
      *
-     * @param {string} fileName - The file path
+     * @param {string} submitted - The file path
      * @param {DirectoryObject|string|null} [parent] - The parent directory (object or string)
      */
-    constructor(fileName: string, parent?: DirectoryObject | string | null);
+    constructor(submitted: string, parent?: DirectoryObject | string | null);
     /**
      * Checks if the file exists (async).
      *
@@ -43,20 +42,15 @@ export default class FileObject extends FS {
      */
     get supplied(): string;
     /**
-     * Returns the file path. If the parent is a capped directory, returns the
-     * virtual path relative to the cap. Otherwise returns the real filesystem
-     * path.
+     * Returns the file path.
      *
-     * Use `.real.path` to always get the actual filesystem path.
-     *
-     * @returns {string} The file path (virtual if parent is capped, real otherwise)
+     * @returns {string} The file path
      */
     get path(): string;
     /**
-     * Returns the URL of the current file. If the parent is a capped directory,
-     * returns a virtual URL relative to the cap. Otherwise returns the real URL.
+     * Returns the URL of the current file.
      *
-     * @returns {URL} The file URL (virtual if parent is capped, real otherwise)
+     * @returns {URL} The file URL
      */
     get url(): URL;
     /**
@@ -83,12 +77,6 @@ export default class FileObject extends FS {
      * @returns {boolean} Always true
      */
     get isFile(): boolean;
-    /**
-     * We're not masquerading as a directory! Nope.
-     *
-     * @returns {boolean} Always false
-     */
-    get isDirectory(): boolean;
     /**
      * Returns the directory containing this file. This does not necessarily
      * mean that the directory exists. It could be theoretical, you will need
@@ -106,23 +94,6 @@ export default class FileObject extends FS {
      */
     get parent(): DirectoryObject;
     get parentPath(): any;
-    /**
-     * Returns a plain FileObject representing the actual filesystem location.
-     * This provides an "escape hatch" when working with capped directories,
-     * allowing direct filesystem access when needed.
-     *
-     * @returns {FileObject} Uncapped file object at the real filesystem path
-     * @example
-     * const temp = new TempDirectoryObject("myapp")
-     * const file = temp.getFile("/config/app.json")
-     *
-     * // file.path shows virtual path
-     * console.log(file.path)       // "/config/app.json"
-     * // file.real.path shows actual filesystem path
-     * console.log(file.real.path)  // "/tmp/myapp-ABC123/config/app.json"
-     * file.real.parent.parent      // Can traverse outside the cap
-     */
-    get real(): FileObject;
     /**
      * Check if a file can be read. Returns true if the file can be read, false
      *
@@ -233,6 +204,6 @@ export default class FileObject extends FS {
     delete(): Promise<void>;
     #private;
 }
-import FS from "./FS.js";
+import FS from "./FileSystem.js";
 import DirectoryObject from "./DirectoryObject.js";
 //# sourceMappingURL=FileObject.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FileObject.d.ts","sourceRoot":"","sources":["../../../src/node/lib/FileObject.js"],"names":[],"mappings":"AAkBA;;;;;;;;;;;;;GAaG;AAEH;IACE;;;;;OAKG;IACH,yBAFU;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,CAAC,OAAO,KAAK,GAAG,OAAO,IAAI,CAAC,CAAA;KAAC,CAO1D;IA0BF;;;;;OAKG;IACH,uBAHW,MAAM,WACN,eAAe,GAAC,MAAM,GAAC,IAAI,EA4DrC;IAaD;;;;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;;;;;;;;;;;;;;OAcG;IACH,cAFa,eAAe,CAI3B;IAED,sBAEC;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;IAED;;;;;OAKG;IACH,gBAHW,MAAM,GACJ,OAAO,CAAC,MAAM,CAAC,CAS3B;IAED;;;;;;;;;;;OAWG;IACH,cARa,OAAO,CAAC,MAAM,CAAC,CAe3B;IAED;;;;;;;;;;;OAWG;IACH,eARW,MAAM,aACN,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAiBzB;IAED;;;;;;;;;;;;;;;OAeG;IACH,kBAXW,WAAW,GAAC,IAAI,GAAC,MAAM,GACrB,OAAO,CAAC,IAAI,CAAC,CAwBzB;IAED;;;;;;;;;;;;;;OAcG;IACH,gBAXW,MAAM,aACN,MAAM,GACJ,OAAO,CAAC,OAAO,CAAC,CAkC5B;IAED;;;;OAIG;IACH,UAFa,OAAO,CAAC,MAAM,CAAC,CAS3B;IAED;;;;;;;;;OASG;IACH,UAPa,OAAO,CAAC,IAAI,CAAC,CAczB;;CACF;eAvdc,iBAAiB;4BADJ,sBAAsB"}

package/{src/types/lib/FS.d.ts → types/node/lib/FileSystem.d.ts}

@@ -1,7 +1,7 @@
 /**
  * File system utility class for path operations and file discovery.
  */
-export default class FS {
+export default class FileSystem {
     static fdTypes: readonly string[];
     static upperFdTypes: readonly string[];
     static fdType: any;
@@ -185,4 +185,4 @@ export default class FS {
 }
 export type FileObject = import("./FileObject.js").default;
 export type DirectoryObject = import("./DirectoryObject.js").default;
-//# sourceMappingURL=FS.d.ts.map
+//# sourceMappingURL=FileSystem.d.ts.map