feat(Path): Add file system inspection methods

- Added exists() to check directory existence
- Added getFiles() to retrieve File objects in directory
- Enhanced getBaseNames() to use getFiles()
- These methods support efficient file system operations

Author: ImperaZim

src/imperazim/components/filesystem/Path.php

@@ -49,6 +49,53 @@ public function getFolder(): string {
     return $this->sourceFolder;
   }
 
+  /**
+  * Checks if the directory exists.
+  * @return bool
+  */
+  public function exists(): bool {
+    return is_dir($this->sourceFolder);
+  }
+
+  /**
+  * Gets all files in the directory as File objects.
+  * @return File[]
+  */
+  public function getFiles(): array {
+    if (!$this->exists()) {
+      return [];
+    }
+    
+    $files = [];
+    $iterator = new DirectoryIterator($this->sourceFolder);
+    
+    foreach ($iterator as $file) {
+      if ($file->isDot() || $file->isDir()) continue;
+      
+      $fileName = $file->getBasename('.' . $file->getExtension());
+      $extension = $file->getExtension();
+      $fileType = File::getTypeByExtension($extension);
+      
+      $files[] = new File(
+        directoryOrConfig: $this->sourceFolder,
+        fileName: $fileName,
+        fileType: $fileType
+      );
+    }
+    
+    return $files;
+  }
+
+  /**
+  * Gets all file base names (without extension) in the directory.
+  * @return string[]
+  */
+  public function getBaseNames(): array {
+    return array_map(
+      fn(File $file) => $file->getFileName(),
+      $this->getFiles()
+    );
+  }
 
   /**
   * Adds a new file to the directory using the File class.