feat(File): Add essential methods for island management

- Implemented read() for full content retrieval
- Added write() for full content persistence
- Created getFileName() for name access
- Added getFolder() for directory path access
- These methods support robust island data handling

Author: ImperaZim

src/imperazim/components/filesystem/File.php

@@ -58,6 +58,27 @@ public function __construct(
     }
   }
 
+  // Add these new methods to support Island management
+  public function read(): array {
+    return $this->get(null, []);
+  }
+
+  public function write(array $data): void {
+    $extension = self::getExtensionByType($this->getFileType());
+    $content = self::serializeContent($extension, $data);
+    $this->writeFile($content);
+  }
+
+  public function getFileName(): string {
+    return $this->fileName;
+  }
+
+  public function getFolder(): string {
+    return $this->directoryOrConfig instanceof Config 
+      ? dirname($this->directoryOrConfig->getPath())
+      : $this->directoryOrConfig;
+  }
+  
   /**
   * Clone the File object with empty data.
   * @return self