Jess/271 multi share

README.md

@@ -835,9 +835,13 @@ ElevatedButton(
 The `GrantPermissionUi` widget provides a full-featured page for
 granting, editing, and revoking access permissions on resources stored
 in a Solid POD. Wrap it inside a navigation action to reach the
-permission management page.
+permission management page.  The titleData parameter, if provides,
+adds support for switch between file url, filename and file title.
 
-### Basic usage (browse all resources)
+### Basic usage to grant/revoke/change permissions for any resource
+
+This allows the user to select the resource, before inspecting their permissions
+and granting, revoking or editing permissions.
 
 ```dart
 ElevatedButton(
@@ -853,7 +857,7 @@ ElevatedButton(
 )
 ```
 
-### Permissions for a specific file
+### Grant/revoke/change permissions for a specific file
 
 ```dart
 ElevatedButton(
@@ -862,15 +866,15 @@ ElevatedButton(
     context,
     MaterialPageRoute(
       builder: (context) => const GrantPermissionUi(
-        resourceName: 'my-data-file.ttl',
+        resourceNames: ['my-data-file.ttl'],
         child: ReturnPage(),
       ),
     ),
   ),
 )
 ```
 
-### Permissions for a specific directory
+### Grant/revoke/change permissions for a specific directory
 
 ```dart
 ElevatedButton(
@@ -879,7 +883,7 @@ ElevatedButton(
     context,
     MaterialPageRoute(
       builder: (context) => const GrantPermissionUi(
-        resourceName: 'parentDir/',
+        resourceNames: ['parentDir/'],
         child: ReturnPage(),
         isFile: false,
       ),
@@ -888,7 +892,7 @@ ElevatedButton(
 )
 ```
 
-### Permissions for an externally owned resource
+### Grant/revoke/change permissions for an externally owned resource
 
 When the user has *control* access to a resource owned by someone else:
 
@@ -899,7 +903,7 @@ ElevatedButton(
     context,
     MaterialPageRoute(
       builder: (context) => GrantPermissionUi(
-        resourceName: 'my-data-file.ttl',
+        resourceNames: const ['my-data-file.ttl'],
         isExternalRes: true,
         ownerWebId: ownerWebId,
         granterWebId: granterWebId,
@@ -910,6 +914,28 @@ ElevatedButton(
 )
 ```
 
+### Grant permissions for multiple user owned resources
+
+When the user wants to apply the same grant permission operation on
+a list of resources:
+
+```dart
+ElevatedButton(
+  child: const Text('Add/Delete Permissions for Multiple Files'),
+  onPressed: () => Navigator.push(
+    context,
+    MaterialPageRoute(
+      builder: (context) => GrantPermissionUi(
+        resourceNames: const ['my-data-file1.ttl', 'my-data-file2.ttl', 'my-data-file3.ttl'],
+        ownerWebId: ownerWebId,
+        granterWebId: granterWebId,
+        child: ReturnPage(),
+      ),
+    ),
+  ),
+)
+```
+
 ## View Permission UI Example
 
 The `SharedResourcesUi` widget displays the resources that have been

example/lib/features/permission_callback_demo.dart

@@ -74,7 +74,6 @@ class _PermissionCallbackDemoState extends State<PermissionCallbackDemo> {
     try {
       for (int i = 0; i < _sampleFiles.length; i++) {
         final fileName = _sampleFiles[i];
-        final filePath = [await getDataDirPath(), fileName].join('/');
 
         // Create rich demo content with different data for each file
         final fileNumber = i + 1;
@@ -100,7 +99,7 @@ demo:exampleData$fileNumber
 
         if (!mounted) return;
 
-        await writePod(filePath, demoContent);
+        await writePod(fileName, demoContent);
       }
     } catch (e) {
       debugPrint('❌ [CallbackDemo] Error creating demo files: $e');
@@ -157,7 +156,7 @@ demo:exampleData$fileNumber
               foregroundColor: Theme.of(context).appBarTheme.foregroundColor,
             ),
             body: GrantPermissionUi(
-              resourceName: _sampleFiles[_currentFileIndex],
+              resourceNames: [_sampleFiles[_currentFileIndex]],
               title: 'Demo: Grant Permission with Callback',
               accessModeList: const ['read'], // Simplified for demo.
               recipientTypeList: const ['indi'], // Individual permissions only.

example/lib/home.dart

@@ -602,7 +602,7 @@ class HomeState extends State<Home> with SingleTickerProviderStateMixin {
                             builder: (context) => const SolidScaffold(
                               body: GrantPermissionUi(
                                 backgroundColor: titleBackgroundColor,
-                                resourceName: 'keyvalue/key-value.ttl',
+                                resourceNames: ['keyvalue/key-value.ttl'],
                                 child: Home(),
                               ),
                             ),

lib/src/utils/path_utils.dart

@@ -163,6 +163,26 @@ class PathUtils {
     return normalised.substring(0, lastSlash);
   }
 
+  /// Returns the display label for a resource name, respecting the current
+  /// display mode.
+  ///
+  /// - When [showTitle] is true and [titleData] contains [name], the mapped
+  ///   title is returned; otherwise falls back to [name].
+  /// - When [showFullPath] is true the full [name] is returned.
+  /// - Otherwise the last path segment (basename) is returned.
+
+  static String resourceDisplayName(
+    String name, {
+    required bool showFullPath,
+    bool showTitle = false,
+    Map<String, String>? titleData,
+  }) {
+    if (showTitle && titleData != null) {
+      return titleData[name] ?? basename(name);
+    }
+    return showFullPath ? name : basename(name);
+  }
+
   /// Gets the last segment (file or directory name) of a path.
   ///
   /// Examples:

lib/src/widgets/grant_permission_form.dart

@@ -50,6 +50,7 @@ import 'package:solidui/solidui.dart'
         updatePermissionMsg;
 import 'package:solidui/src/utils/snack_bar.dart';
 import 'package:solidui/src/utils/solid_alert.dart';
+import 'package:solidui/src/widgets/grant_permission_helpers_ui.dart';
 import 'package:solidui/src/widgets/group_webid_input.dart';
 import 'package:solidui/src/widgets/ind_webid_input_screen.dart';
 import 'package:solidui/src/widgets/select_recipients.dart';
@@ -62,7 +63,9 @@ import 'package:solidui/src/widgets/show_selected_recipients.dart';
 /// provided [resourceName]
 ///
 /// Parameters:
-/// - [resourceName] - The filename or file url of the resource. If [isExternalRes], it should be the url of the resource.
+/// - [resourceNames] - List of resource names. The first entry is used for
+/// display in the dialog title and ACL table refresh. All entries receive
+/// the same permission grant.
 /// - [isExternalRes] - Boolean flag describing whether the resource
 /// is externally owned.
 /// - [ownerWebId] - WebId of the owner of the resource. Required if the resource is externally owned.
@@ -84,9 +87,11 @@ class GrantPermissionForm extends StatefulWidget {
 
   final String granterWebId;
 
-  /// The name of the file or directory that access is being granted for.
+  /// List of resource names to grant permission to. The first entry is used
+  /// for display in the dialog title and ACL table refresh after granting.
+  /// All entries receive the same permission grant sequentially.
 
-  final String resourceName;
+  final List<String> resourceNames;
 
   final bool isExternalRes;
 
@@ -127,7 +132,7 @@ class GrantPermissionForm extends StatefulWidget {
   const GrantPermissionForm({
     super.key,
     required this.updatePermissionsFunction,
-    required this.resourceName,
+    required this.resourceNames,
     required this.ownerWebId,
     required this.granterWebId,
     this.accessModeList = const ['read', 'write', 'append', 'control'],
@@ -289,7 +294,13 @@ class _GrantPermissionFormState extends State<GrantPermissionForm> {
   Widget build(BuildContext context) {
     return AlertDialog(
       insetPadding: GrantPermFormLayout.contentPadding,
-      title: Text('Share ${widget.resourceName}'),
+      title: Text(
+        makeSharingTitleStr(
+          resourceNames: widget.resourceNames,
+          isFile: widget.isFile,
+        ),
+        style: Theme.of(context).textTheme.titleLarge,
+      ),
       content: Scrollbar(
         thumbVisibility: true,
         child: SingleChildScrollView(
@@ -359,20 +370,30 @@ class _GrantPermissionFormState extends State<GrantPermissionForm> {
 
             if (selectedRecipientType.type.isNotEmpty) {
               if (selectedPermList.isNotEmpty) {
-                SolidFunctionCallStatus result;
+                // Grant permission for each resource sequentially.
+                // When resourceNames is provided all resources share the
+                // same recipient and permission selections.
+                final resourcesToGrant = widget.resourceNames;
+                SolidFunctionCallStatus result =
+                    SolidFunctionCallStatus.success;
                 try {
-                  // Update ACL and permission logs to grant permission
-                  result = await grantPermission(
-                    fileName: widget.resourceName,
-                    isFile: widget.isFile,
-                    permissionList: selectedPermList,
-                    recipientType: selectedRecipientType,
-                    recipientWebIdList: finalWebIdList,
-                    ownerWebId: widget.ownerWebId,
-                    granterWebId: widget.granterWebId,
-                    isExternalRes: widget.isExternalRes,
-                    groupName: selectedGroupName,
-                  );
+                  for (final name in resourcesToGrant) {
+                    final r = await grantPermission(
+                      fileName: name,
+                      isFile: widget.isFile,
+                      permissionList: selectedPermList,
+                      recipientType: selectedRecipientType,
+                      recipientWebIdList: finalWebIdList,
+                      ownerWebId: widget.ownerWebId,
+                      granterWebId: widget.granterWebId,
+                      isExternalRes: widget.isExternalRes,
+                      groupName: selectedGroupName,
+                    );
+                    if (r != SolidFunctionCallStatus.success) {
+                      result = r;
+                      break;
+                    }
+                  }
 
                   // Close grant permission dialog
                   if (!context.mounted) return;
@@ -386,7 +407,7 @@ class _GrantPermissionFormState extends State<GrantPermissionForm> {
                   _showSnackBar(successMsg, ActionColors.success);
                   // Update permissions table
                   await widget.updatePermissionsFunction(
-                    widget.resourceName, //_resourceName,
+                    widget.resourceNames.first,
                     isFile: widget.isFile,
                     isExternalRes: widget.isExternalRes,
                   );
@@ -402,7 +423,7 @@ class _GrantPermissionFormState extends State<GrantPermissionForm> {
 
                   // Also log to console for debugging
                   debugPrintFailure(
-                    widget.resourceName, // _resourceName,
+                    widget.resourceNames.first,
                     finalWebIdList,
                     selectedPermList,
                   );

lib/src/widgets/grant_permission_helpers_ui.dart

@@ -32,6 +32,7 @@ import 'package:flutter/material.dart';
 
 import 'package:solidpod/solidpod.dart' show AccessMode, RecipientType;
 
+import 'package:solidui/src/constants/ui_colors.dart' show ActionColors;
 import 'package:solidui/src/constants/ui_layout.dart' show SharingPageLayout;
 import 'package:solidui/src/widgets/permission_checkbox.dart';
 
@@ -125,12 +126,17 @@ const ownerRecipientTypes = [
 const granterRecipientTypes = [RecipientType.individual, RecipientType.group];
 
 /// Get title of sharing page.
-String makeSharingTitleStr({String? fileName, bool isFile = false}) =>
-    fileName != null
-        ? isFile
-            ? 'Share $fileName'
-            : 'Share $fileName folder'
-        : 'Share your data with other user\'s PODs';
+String makeSharingTitleStr({
+  List<String>? resourceNames,
+  bool isFile = false,
+}) {
+  if (resourceNames != null && resourceNames.length > 1) {
+    return isFile ? 'Sharing multiple files' : 'Sharing multiple folders';
+  } else if (resourceNames != null) {
+    return isFile ? 'Sharing file' : 'Sharing folder';
+  }
+  return 'Share your data with other user\'s PODs';
+}
 
 // Widget builders
 
@@ -168,18 +174,31 @@ Widget getResourceForm({
                 (value == null || value.isEmpty) ? 'Empty field' : null,
           ),
           const SizedBox(height: 10),
-          SwitchListTile(
-            title: const Text(
-              'Is a File?',
-              style: TextStyle(fontSize: 16, fontWeight: FontWeight.bold),
-            ),
-            subtitle: Text(isFile ? 'Yes' : 'No'),
-            value: isFile,
-            onChanged: onResourceTypeChange,
-            thumbColor: WidgetStateProperty.resolveWith<Color?>(
-              (Set<WidgetState> states) =>
-                  states.contains(WidgetState.selected) ? Colors.green : null,
-            ),
+          Row(
+            mainAxisAlignment: MainAxisAlignment.end,
+            children: [
+              Column(
+                crossAxisAlignment: CrossAxisAlignment.end,
+                children: [
+                  const Text(
+                    'Is a File?',
+                    style: TextStyle(fontSize: 16, fontWeight: FontWeight.bold),
+                  ),
+                  Text(isFile ? 'Yes' : 'No'),
+                ],
+              ),
+              Builder(
+                builder: (context) => Switch(
+                  value: isFile,
+                  activeThumbColor:
+                      Theme.of(context).switchTheme.thumbColor?.resolve(
+                            {WidgetState.selected},
+                          ) ??
+                          ActionColors.success,
+                  onChanged: onResourceTypeChange,
+                ),
+              ),
+            ],
           ),
         ],
       ),