Add initialPath to enable browsing files on the root directory of the POD

Author: tonypioneer

lib/src/widgets/solid_file.dart

@@ -202,23 +202,32 @@ class _SolidFileState extends State<SolidFile> {
 
   /// Resolves the base path asynchronously.
   ///
-  /// Defaults to the app data directory path via [getDataDirPath].
-  /// Falls back to POD root if the app data directory cannot be determined.
+  /// If [widget.currentPath] is explicitly provided, it is used as the base
+  /// path. This allows the widget to start from any location on the POD,
+  /// including the root. Otherwise, defaults to the app data directory path
+  /// via [getDataDirPath]. Falls back to POD root if the app data directory
+  /// cannot be determined.
 
   Future<void> _resolveBasePath() async {
-    try {
-      final appDataPath = await getDataDirPath();
-      _resolvedBasePath = PathUtils.normalise(appDataPath);
-    } catch (e) {
-      // Fall back to POD root if getDataDirPath fails.
-
-      debugPrint('Failed to get app data path, falling back to POD root: $e');
-      _resolvedBasePath = SolidFile.podRoot;
+    if (widget.currentPath != null) {
+      // Use the explicitly provided path as the base.
+
+      _resolvedBasePath = PathUtils.normalise(widget.currentPath!);
+    } else {
+      try {
+        final appDataPath = await getDataDirPath();
+        _resolvedBasePath = PathUtils.normalise(appDataPath);
+      } catch (e) {
+        // Fall back to POD root if getDataDirPath fails.
+
+        debugPrint(
+          'Failed to get app data path, falling back to POD root: $e',
+        );
+        _resolvedBasePath = SolidFile.podRoot;
+      }
     }
 
-    _currentPath = widget.currentPath != null
-        ? PathUtils.normalise(widget.currentPath!)
-        : _resolvedBasePath!;
+    _currentPath = _resolvedBasePath!;
     setState(() {
       _isResolvingBasePath = false;
     });
@@ -379,6 +388,9 @@ class _SolidFileState extends State<SolidFile> {
   }
 
   /// Builds the file browser widget.
+  ///
+  /// Passes the resolved [_currentPath] as the initial path so the browser
+  /// starts from the correct location (e.g., POD root for "All POD Files").
 
   Widget _buildFileBrowser() {
     return SolidFileBrowserBuilder.build(
@@ -389,6 +401,7 @@ class _SolidFileState extends State<SolidFile> {
         widget.autoConfig,
         widget.friendlyFolderName,
       ),
+      initialPath: widget.currentPath,
       onFileSelected: widget.onFileSelected,
       onFileDownload: widget.onFileDownload,
       onFileDelete: widget.onFileDelete,

lib/src/widgets/solid_file_browser.dart

@@ -73,6 +73,14 @@ class SolidFileBrowser extends StatefulWidget {
 
   final String friendlyFolderName;
 
+  /// Optional initial path for the browser to start from.
+  ///
+  /// If provided, the browser will start from this path instead of the
+  /// default app data directory path. Use an empty string to start from
+  /// the POD root.
+
+  final String? initialPath;
+
   const SolidFileBrowser({
     super.key,
     required this.onFileSelected,
@@ -82,6 +90,7 @@ class SolidFileBrowser extends StatefulWidget {
     required this.onImportCsv,
     required this.onDirectoryChanged,
     required this.friendlyFolderName,
+    this.initialPath,
   });
 
   @override
@@ -142,14 +151,28 @@ class SolidFileBrowserState extends State<SolidFileBrowser> {
   }
 
   /// Resolves the home path internally via [getDataDirPath].
+  ///
+  /// If [widget.initialPath] is provided, it is used as both the starting
+  /// path and the home path for navigation. This allows browsing from any
+  /// location on the POD, including the root.
 
   Future<void> _resolveHomePath() async {
-    try {
-      final appDataPath = await getDataDirPath();
-      _homePath = PathUtils.normalise(appDataPath);
-    } catch (e) {
-      debugPrint('Failed to get app data path, falling back to POD root: $e');
-      _homePath = '';
+    if (widget.initialPath != null) {
+      // Use the explicitly provided initial path as both the home path and
+      // the starting path. This ensures the "back to root" navigation and
+      // path history work correctly for non-default starting locations.
+
+      _homePath = PathUtils.normalise(widget.initialPath!);
+    } else {
+      try {
+        final appDataPath = await getDataDirPath();
+        _homePath = PathUtils.normalise(appDataPath);
+      } catch (e) {
+        debugPrint(
+          'Failed to get app data path, falling back to POD root: $e',
+        );
+        _homePath = '';
+      }
     }
 
     currentPath = _homePath;

lib/src/widgets/solid_file_browser_builder.dart

@@ -42,6 +42,7 @@ class SolidFileBrowserBuilder {
   static Widget build({
     required GlobalKey<SolidFileBrowserState> browserKey,
     required String friendlyFolderName,
+    String? initialPath,
     Function(String fileName, String filePath)? onFileSelected,
     Function(String fileName, String filePath)? onFileDownload,
     Function(String fileName, String filePath)? onFileDelete,
@@ -53,6 +54,7 @@ class SolidFileBrowserBuilder {
       key: browserKey,
       browserKey: browserKey,
       friendlyFolderName: friendlyFolderName,
+      initialPath: initialPath,
       onFileSelected: onFileSelected ??
           (fileName, filePath) {
             debugPrint('File selected: $fileName at $filePath');