@gesslar/toolkit 2.5.0 → 2.7.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gesslar/toolkit",
-  "version": "2.5.0",
+  "version": "2.7.0",
   "description": "A collection of utilities for Node.js and browser environments.",
   "main": "./src/index.js",
   "type": "module",

package/src/lib/CappedDirectoryObject.js

@@ -157,6 +157,75 @@ export default class CappedDirectoryObject extends DirectoryObject {
     return true
   }
 
+  /**
+   * 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 plain DirectoryObject (not capped).
+   * Use getDirectory() for creating capped subdirectories.
+   *
+   * @returns {DirectoryObject|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 DirectoryObject
+   * console.log(capped.parent) // null (at cap root)
+   */
+  get parent() {
+    const capResolved = path.resolve(this.#cap)
+
+    // If we're at the cap, return null (cap is the "root")
+    if(this.path === capResolved) {
+      return null
+    }
+
+    // Otherwise return the parent (plain DirectoryObject, not capped)
+    return super.parent
+  }
+
+  /**
+   * Generator that walks up the directory tree, stopping at the cap.
+   * Yields parent directories from current up to (and including) the cap root.
+   *
+   * @returns {Generator<DirectoryObject>} Generator yielding parent DirectoryObject instances
+   * @example
+   * const capped = new TempDirectoryObject("myapp")
+   * const deep = capped.getDirectory("data").getDirectory("files")
+   * for(const parent of deep.walkUp) {
+   *   console.log(parent.path)
+   *   // .../myapp-ABC123/data/files
+   *   // .../myapp-ABC123/data
+   *   // .../myapp-ABC123 (stops at cap)
+   * }
+   */
+  *#walkUpCapped() {
+    const capResolved = path.resolve(this.#cap)
+
+    // Use super.walkUp but stop when we would go beyond the cap
+    for(const dir of super.walkUp) {
+      // Don't yield anything beyond the cap
+      if(!dir.path.startsWith(capResolved)) {
+        break
+      }
+
+      yield dir
+
+      // Stop after yielding the cap
+      if(dir.path === capResolved) {
+        break
+      }
+    }
+  }
+
+  /**
+   * Returns a generator that walks up to the cap.
+   *
+   * @returns {Generator<DirectoryObject>} Generator yielding parent directories
+   */
+  get walkUp() {
+    return this.#walkUpCapped()
+  }
+
   /**
    * Creates a new CappedDirectoryObject by extending this directory's path.
    *

package/src/lib/DirectoryObject.js

@@ -37,6 +37,7 @@ import Sass from "./Sass.js"
  * @property {boolean} temporary - Whether this is marked as a temporary directory
  * @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)
  * @property {Generator<DirectoryObject>} walkUp - Generator yielding parent directories up to root
  *
@@ -89,6 +90,14 @@ export default class DirectoryObject extends FS {
     temporary: null,
   })
 
+  /**
+   * Cached parent directory object
+   *
+   * @type {DirectoryObject|null|undefined}
+   * @private
+   */
+  #parent = undefined
+
   /**
    * Constructs a DirectoryObject instance.
    *
@@ -147,7 +156,8 @@ export default class DirectoryObject extends FS {
       module: this.module,
       extension: this.extension,
       isFile: this.isFile,
-      isDirectory: this.isDirectory
+      isDirectory: this.isDirectory,
+      parent: this.parent ? this.parent.path : null
     }
   }
 
@@ -253,6 +263,37 @@ export default class DirectoryObject extends FS {
     return this.#meta.temporary
   }
 
+  /**
+   * Returns the parent directory of this directory.
+   * Returns null if this directory is the root directory.
+   * Computed lazily on first access and cached.
+   *
+   * @returns {DirectoryObject|null} The parent directory or null if root
+   * @example
+   * const dir = new DirectoryObject('/path/to/directory')
+   * console.log(dir.parent.path) // '/path/to'
+   *
+   * const root = new DirectoryObject('/')
+   * console.log(root.parent) // null
+   */
+  get parent() {
+    // Return cached value if available
+    if(this.#parent !== undefined) {
+      return this.#parent
+    }
+
+    // Compute parent directory (null if we're at root)
+    const parentPath = path.dirname(this.path)
+    const isRoot = parentPath === this.path
+
+    // Cache and return
+    this.#parent = isRoot
+      ? null
+      : new DirectoryObject(parentPath, this.temporary)
+
+    return this.#parent
+  }
+
   /**
    * Recursively removes a temporary directory and all its contents.
    *

package/src/lib/FS.js

@@ -30,6 +30,26 @@ export default class FS {
   static upperFdTypes = upperFdTypes
   static fdType = fdType
 
+  /**
+   * Compute the relative path from another file or directory to this instance.
+   *
+   * If the target is outside the source (i.e., the relative path starts with ".."),
+   * returns the absolute path to this instance instead.
+   *
+   * @param {FileObject|DirectoryObject} fileOrDirectoryObject - The source file or directory object
+   * @returns {string} The relative path from the source to this instance, or the absolute path if not reachable
+   * @throws {Sass} If the parameter is not a FileObject or DirectoryObject
+   */
+  relativeTo(fileOrDirectoryObject) {
+    Valid.assert(
+      typeof fileOrDirectoryObject?.path === "string",
+      "fileOrDirectoryObject must be a FileObject or DirectoryObject with a path property",
+      1
+    )
+
+    return FS.relativeOrAbsolutePath(fileOrDirectoryObject, this)
+  }
+
   /**
    * Fix slashes in a path
    *
@@ -129,7 +149,7 @@ export default class FS {
   static relativeOrAbsolutePath(from, to) {
     const fromBasePath = from.isDirectory
       ? from.path
-      : from.directory?.path ?? path.dirname(from.path)
+      : from.parent?.path ?? path.dirname(from.path)
 
     const relative = path.relative(fromBasePath, to.path)
 

package/src/lib/FileObject.js

@@ -29,7 +29,7 @@ import Valid from "./Valid.js"
  * @property {string} extension - The file extension
  * @property {boolean} isFile - Always true for files
  * @property {boolean} isDirectory - Always false for files
- * @property {DirectoryObject} directory - The parent directory object
+ * @property {DirectoryObject} parent - The parent directory object
  * @property {Promise<boolean>} exists - Whether the file exists (async)
  */
 
@@ -58,7 +58,7 @@ export default class FileObject extends FS {
    * @property {string|null} extension - The file extension
    * @property {boolean} isFile - Always true
    * @property {boolean} isDirectory - Always false
-   * @property {DirectoryObject|null} directory - The parent directory object
+   * @property {DirectoryObject|null} parent - The parent directory object
    */
   #meta = Object.seal({
     supplied: null,
@@ -69,16 +69,16 @@ export default class FileObject extends FS {
     extension: null,
     isFile: true,
     isDirectory: false,
-    directory: null,
+    parent: null,
   })
 
   /**
    * Constructs a FileObject instance.
    *
    * @param {string | FileObject} fileName - The file path or FileObject
-   * @param {DirectoryObject|string|null} [directory] - The parent directory (object or string)
+   * @param {DirectoryObject|string|null} [parent] - The parent directory (object or string)
    */
-  constructor(fileName, directory=null) {
+  constructor(fileName, parent=null) {
     super()
 
     // If passed a FileObject, extract its path
@@ -93,19 +93,19 @@ export default class FileObject extends FS {
 
     const {dir,base,ext} = this.#deconstructFilenameToParts(fixedFile)
 
-    const directoryObject = (() => {
-      switch(Data.typeOf(directory)) {
+    const parentObject = (() => {
+      switch(Data.typeOf(parent)) {
         case "String":
-          return new DirectoryObject(directory)
+          return new DirectoryObject(parent)
         case "DirectoryObject":
         case "TempDirectoryObject":
-          return directory
+          return parent
         default:
           return new DirectoryObject(dir)
       }
     })()
 
-    const final = FS.resolvePath(directoryObject.path ?? ".", fixedFile)
+    const final = FS.resolvePath(parentObject.path ?? ".", fixedFile)
 
     const resolved = final
     const url = new URL(FS.pathToUri(resolved))
@@ -116,7 +116,7 @@ export default class FileObject extends FS {
     this.#meta.name = base
     this.#meta.extension = ext
     this.#meta.module = path.basename(this.supplied, this.extension)
-    this.#meta.directory = directoryObject
+    this.#meta.parent = parentObject
 
     Object.freeze(this.#meta)
   }
@@ -145,7 +145,7 @@ export default class FileObject extends FS {
       extension: this.extension,
       isFile: this.isFile,
       isDirectory: this.isDirectory,
-      directory: this.directory ? this.directory.path : null
+      parent: this.parent ? this.parent.path : null
     }
   }
 
@@ -253,8 +253,8 @@ export default class FileObject extends FS {
    *
    * @returns {DirectoryObject} The parent directory object
    */
-  get directory() {
-    return this.#meta.directory
+  get parent() {
+    return this.#meta.parent
   }
 
   /**
@@ -411,11 +411,11 @@ export default class FileObject extends FS {
     if(!this.url)
       throw Sass.new("No URL in file")
 
-    if(await this.directory.exists)
+    if(await this.parent.exists)
       await fs.writeFile(this.url, content, encoding)
 
     else
-      throw Sass.new(`Invalid directory, ${this.directory.url.href}`)
+      throw Sass.new(`Invalid directory, ${this.parent.url.href}`)
   }
 
   /**
@@ -438,8 +438,8 @@ export default class FileObject extends FS {
     if(!this.url)
       throw Sass.new("No URL in file")
 
-    const exists = await this.directory.exists
-    Valid.assert(exists, `Invalid directory, ${this.directory.url.href}`)
+    const exists = await this.parent.exists
+    Valid.assert(exists, `Invalid directory, ${this.parent.url.href}`)
 
     Valid.assert(Data.isBinary(data), "Data must be binary (ArrayBuffer, TypedArray, Blob, or Buffer)")
 

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

@@ -38,6 +38,12 @@ export default class CappedDirectoryObject extends DirectoryObject {
      * @returns {boolean} Always true for CappedDirectoryObject instances
      */
     get capped(): boolean;
+    /**
+     * Returns a generator that walks up to the cap.
+     *
+     * @returns {Generator<DirectoryObject>} Generator yielding parent directories
+     */
+    get walkUp(): Generator<DirectoryObject>;
     /**
      * Creates a new CappedDirectoryObject by extending this directory's path.
      *

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

@@ -1 +1 @@
-{"version":3,"file":"CappedDirectoryObject.d.ts","sourceRoot":"","sources":["../../lib/CappedDirectoryObject.js"],"names":[],"mappings":"AAiBA;;;;;;;;GAQG;AACH;IAGE;;;;;;;;;;;;;;;;OAgBG;IACH,kBAXW,MAAM,OAAC,OACP,MAAM,WACN,qBAAqB,OAAC,cACtB,OAAO,EAkFjB;IAqBD;;;;OAIG;IACH,WAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,cAFa,OAAO,CAInB;IAED;;;;;;;;;;;;;;OAcG;IACH,sBAVW,MAAM,GACJ,qBAAqB,CA0BjC;;CA6CF;4BA/N2B,sBAAsB"}
+{"version":3,"file":"CappedDirectoryObject.d.ts","sourceRoot":"","sources":["../../lib/CappedDirectoryObject.js"],"names":[],"mappings":"AAiBA;;;;;;;;GAQG;AACH;IAGE;;;;;;;;;;;;;;;;OAgBG;IACH,kBAXW,MAAM,OAAC,OACP,MAAM,WACN,qBAAqB,OAAC,cACtB,OAAO,EAkFjB;IAqBD;;;;OAIG;IACH,WAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,cAFa,OAAO,CAInB;IA8DD;;;;OAIG;IACH,cAFa,SAAS,CAAC,eAAe,CAAC,CAItC;IAED;;;;;;;;;;;;;;OAcG;IACH,sBAVW,MAAM,GACJ,qBAAqB,CA0BjC;;CA6CF;4BApS2B,sBAAsB"}

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

@@ -21,6 +21,7 @@
  * @property {boolean} temporary - Whether this is marked as a temporary directory
  * @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)
  * @property {Generator<DirectoryObject>} walkUp - Generator yielding parent directories up to root
  *
@@ -124,6 +125,20 @@ export default class DirectoryObject extends FS {
      * @returns {boolean} True if this is a temporary directory, false otherwise
      */
     get temporary(): boolean;
+    /**
+     * Returns the parent directory of this directory.
+     * Returns null if this directory is the root directory.
+     * Computed lazily on first access and cached.
+     *
+     * @returns {DirectoryObject|null} The parent directory or null if root
+     * @example
+     * const dir = new DirectoryObject('/path/to/directory')
+     * console.log(dir.parent.path) // '/path/to'
+     *
+     * const root = new DirectoryObject('/')
+     * console.log(root.parent) // null
+     */
+    get parent(): DirectoryObject | null;
     /**
      * Recursively removes a temporary directory and all its contents.
      *

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

@@ -1 +1 @@
-{"version":3,"file":"DirectoryObject.d.ts","sourceRoot":"","sources":["../../lib/DirectoryObject.js"],"names":[],"mappings":"AAgBA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH;uBA4Fe,MAAM;IAjEnB;;;;;OAKG;IACH,yCAFW,OAAO,EA6BjB;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,iBAFa,OAAO,CAInB;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,UATa,OAAO,CAAC,IAAI,CAAC,CA0BzB;IAED;;;;OAIG;IACH,cAFa,OAAO,CAInB;IAED;;;;OAIG;IACH,mBAFa,OAAO,CAInB;IAiBD;;;;;;;;;;;;;;;OAeG;IACH,WAZW,MAAM,GACJ,OAAO,CAAC;QAAC,KAAK,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;QAAC,WAAW,EAAE,KAAK,CAAC,eAAe,CAAC,CAAA;KAAC,CAAC,CAoCpF;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;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,sBAdW,MAAM,GACJ,eAAe,CAoB3B;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,kBAbW,MAAM,GACJ,UAAU,CAmBtB;;CACF;eA9hBc,SAAS;uBACD,iBAAiB"}
+{"version":3,"file":"DirectoryObject.d.ts","sourceRoot":"","sources":["../../lib/DirectoryObject.js"],"names":[],"mappings":"AAgBA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH;uBAqGe,MAAM;IAlEnB;;;;;OAKG;IACH,yCAFW,OAAO,EA6BjB;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;IAED;;;;OAIG;IACH,WAFa,MAAM,CAIlB;IAED;;;;;;;OAOG;IACH,aALa,KAAK,CAAC,MAAM,CAAC,CAOzB;IAED;;;;OAIG;IACH,iBAFa,OAAO,CAInB;IAED;;;;;;;;;;;;OAYG;IACH,cARa,eAAe,GAAC,IAAI,CAwBhC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,UATa,OAAO,CAAC,IAAI,CAAC,CA0BzB;IAED;;;;OAIG;IACH,cAFa,OAAO,CAInB;IAED;;;;OAIG;IACH,mBAFa,OAAO,CAInB;IAiBD;;;;;;;;;;;;;;;OAeG;IACH,WAZW,MAAM,GACJ,OAAO,CAAC;QAAC,KAAK,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;QAAC,WAAW,EAAE,KAAK,CAAC,eAAe,CAAC,CAAA;KAAC,CAAC,CAoCpF;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;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,sBAdW,MAAM,GACJ,eAAe,CAoB3B;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,kBAbW,MAAM,GACJ,UAAU,CAmBtB;;CACF;eAvkBc,SAAS;uBACD,iBAAiB"}

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

@@ -71,6 +71,17 @@ export default class FS {
      * @returns {string} The resolved path
      */
     static resolvePath(fromPath: string, toPath: string): string;
+    /**
+     * Compute the relative path from another file or directory to this instance.
+     *
+     * If the target is outside the source (i.e., the relative path starts with ".."),
+     * returns the absolute path to this instance instead.
+     *
+     * @param {FileObject|DirectoryObject} fileOrDirectoryObject - The source file or directory object
+     * @returns {string} The relative path from the source to this instance, or the absolute path if not reachable
+     * @throws {Sass} If the parameter is not a FileObject or DirectoryObject
+     */
+    relativeTo(fileOrDirectoryObject: FileObject | DirectoryObject): string;
 }
 export type FileObject = import("./FileObject.js").default;
 export type DirectoryObject = import("./DirectoryObject.js").default;

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

@@ -1 +1 @@
-{"version":3,"file":"FS.d.ts","sourceRoot":"","sources":["../../lib/FS.js"],"names":[],"mappings":"AAwBA;;GAEG;AACH;IACE,kCAAwB;IACxB,uCAAkC;IAClC,mBAAsB;IAEtB;;;;;;OAMG;IACH,4BAHW,MAAM,GACJ,MAAM,CAIlB;IAED;;;;;;OAMG;IACH,2BAHW,MAAM,GACJ,MAAM,CAUlB;IAED;;;;;;OAMG;IACH,2BAHW,MAAM,GACJ,MAAM,CAQlB;IAED;;;;;;;;OAQG;IACH,sBALW,MAAM,GAAC,KAAK,CAAC,MAAM,CAAC,GAClB,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAmCtC;IAED;;;;;;;;;;OAUG;IACH,oCAJW,UAAU,GAAC,eAAe,MAC1B,UAAU,GAAC,eAAe,GACxB,MAAM,CAYlB;IAED;;;;;;;;OAQG;IACH,oCALW,MAAM,SACN,MAAM,QACN,MAAM,GACJ,MAAM,CA0BlB;IAED;;;;;;;;OAQG;IACH,6BAJW,MAAM,UACN,MAAM,GACJ,MAAM,CAgClB;CACF;yBAxMa,OAAO,iBAAiB,EAAE,OAAO;8BACjC,OAAO,sBAAsB,EAAE,OAAO"}
+{"version":3,"file":"FS.d.ts","sourceRoot":"","sources":["../../lib/FS.js"],"names":[],"mappings":"AAwBA;;GAEG;AACH;IACE,kCAAwB;IACxB,uCAAkC;IAClC,mBAAsB;IAsBtB;;;;;;OAMG;IACH,4BAHW,MAAM,GACJ,MAAM,CAIlB;IAED;;;;;;OAMG;IACH,2BAHW,MAAM,GACJ,MAAM,CAUlB;IAED;;;;;;OAMG;IACH,2BAHW,MAAM,GACJ,MAAM,CAQlB;IAED;;;;;;;;OAQG;IACH,sBALW,MAAM,GAAC,KAAK,CAAC,MAAM,CAAC,GAClB,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAmCtC;IAED;;;;;;;;;;OAUG;IACH,oCAJW,UAAU,GAAC,eAAe,MAC1B,UAAU,GAAC,eAAe,GACxB,MAAM,CAYlB;IAED;;;;;;;;OAQG;IACH,oCALW,MAAM,SACN,MAAM,QACN,MAAM,GACJ,MAAM,CA0BlB;IAED;;;;;;;;OAQG;IACH,6BAJW,MAAM,UACN,MAAM,GACJ,MAAM,CAgClB;IA1MD;;;;;;;;;OASG;IACH,kCAJW,UAAU,GAAC,eAAe,GACxB,MAAM,CAWlB;CAyLF;yBA5Na,OAAO,iBAAiB,EAAE,OAAO;8BACjC,OAAO,sBAAsB,EAAE,OAAO"}

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

@@ -10,7 +10,7 @@
  * @property {string} extension - The file extension
  * @property {boolean} isFile - Always true for files
  * @property {boolean} isDirectory - Always false for files
- * @property {DirectoryObject} directory - The parent directory object
+ * @property {DirectoryObject} parent - The parent directory object
  * @property {Promise<boolean>} exists - Whether the file exists (async)
  */
 export default class FileObject extends FS {
@@ -28,9 +28,9 @@ export default class FileObject extends FS {
      * Constructs a FileObject instance.
      *
      * @param {string | FileObject} fileName - The file path or FileObject
-     * @param {DirectoryObject|string|null} [directory] - The parent directory (object or string)
+     * @param {DirectoryObject|string|null} [parent] - The parent directory (object or string)
      */
-    constructor(fileName: string | FileObject, directory?: DirectoryObject | string | null);
+    constructor(fileName: string | FileObject, parent?: DirectoryObject | string | null);
     /**
      * Returns a JSON representation of the FileObject.
      *
@@ -106,7 +106,7 @@ export default class FileObject extends FS {
      *
      * @returns {DirectoryObject} The parent directory object
      */
-    get directory(): DirectoryObject;
+    get parent(): DirectoryObject;
     /**
      * Check if a file can be read. Returns true if the file can be read, false
      *

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

@@ -1 +1 @@
-{"version":3,"file":"FileObject.d.ts","sourceRoot":"","sources":["../../lib/FileObject.js"],"names":[],"mappings":"AAmBA;;;;;;;;;;;;;;GAcG;AAEH;uBAuHe,MAAM;IAtHnB;;;;;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,GAAG,UAAU,cACnB,eAAe,GAAC,MAAM,GAAC,IAAI,EA2CrC;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,cARa,OAAO,CAAC,MAAM,CAAC,CAkB3B;IAED;;;;;;;;;;;OAWG;IACH,eARW,MAAM,aACN,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAezB;IAED;;;;;;;;;;;;;;;OAeG;IACH,kBAXW,WAAW,GAAC,IAAI,GAAC,MAAM,GACrB,OAAO,CAAC,IAAI,CAAC,CAyBzB;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;;CACF;eAtgBc,SAAS;4BADI,sBAAsB;kBARhC,OAAO;iBAIR,MAAM"}
+{"version":3,"file":"FileObject.d.ts","sourceRoot":"","sources":["../../lib/FileObject.js"],"names":[],"mappings":"AAmBA;;;;;;;;;;;;;;GAcG;AAEH;uBAuHe,MAAM;IAtHnB;;;;;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,GAAG,UAAU,WACnB,eAAe,GAAC,MAAM,GAAC,IAAI,EA2CrC;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,cAFa,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,cARa,OAAO,CAAC,MAAM,CAAC,CAkB3B;IAED;;;;;;;;;;;OAWG;IACH,eARW,MAAM,aACN,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAezB;IAED;;;;;;;;;;;;;;;OAeG;IACH,kBAXW,WAAW,GAAC,IAAI,GAAC,MAAM,GACrB,OAAO,CAAC,IAAI,CAAC,CAyBzB;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;;CACF;eAtgBc,SAAS;4BADI,sBAAsB;kBARhC,OAAO;iBAIR,MAAM"}