cloud_storage_gallery 0.5.0

Drop-in Flutter widgets for browsing folders, viewing media, uploading with progress, and thumbnail generation on top of cloud_storage.

0.5.0

New: client-side sort for grid contents.

• Two new public types (both exported from the barrel):
  • CloudNodeSortField — name / createdAt / updatedAt / size / type.
  • CloudNodeSort — immutable (field, ascending, foldersFirst) triple with copyWith. Defaults to name ascending, folders first.
• Helper: sortCloudNodes(nodes, sort) — pure function, stable tiebreak by name, no mutation.
• New optional param on CloudFolderGrid: sort. Applied client-side inside the StreamBuilder, no Firestore index required on the consumer's project.
• New optional param on CloudPathBar: trailing: List<Widget>. Rendered after the breadcrumb — text-direction-aware. Use it to slot your own icon buttons alongside the built-in nav chrome.
• Sort menu wired into CloudFolderScreen: a PopupMenuButton in the path bar's new trailing slot with radio field options, a direction toggle, and a folders-first toggle. State is session-scoped (resets when the widget is recreated).

Localization: 9 new strings under a "Sort menu" section (sortTooltip, sortByHeader, five sortFieldXxx labels, sortDirectionAscending / Descending, sortFoldersFirst). Provided in EN and AR.

Breaking (custom l10n only): consumers who ship their own CloudGalleryLocalizations impl need to add the nine new getters. Consumers relying on the built-in Cn/Ar implementations are unaffected.

0.4.0

New: pinch-to-zoom on the grid. Two-finger pinch changes the column count in real time. Column-count changes crossfade with a scale transition (220 ms). Single-finger scroll is not intercepted — only gestures with two or more pointers resize.

• CloudFolderGrid is now a StatefulWidget owning the current column count. Two new optional params bound the pinch range:
  • minCrossAxisCount — default 2.
  • maxCrossAxisCount — default 5.
• Once the user pinches, the internal state takes over. Rebuilds with a different crossAxisCount param are ignored — the state is authoritative.

Fix: folder tile no longer overflows at small tile sizes. The tile was a Column with a fixed 56 dp icon + label; at the tighter column counts pinch-to-zoom now allows, the tile height dropped below the intrinsic column height and Flutter surfaced the yellow/black overflow indicator. _FolderTile now mirrors the _FileTile / _LinkTile layout — icon centered in a Stack, name as a PositionedDirectional bottom overlay. The 56 dp icon size is unchanged; only the label placement moved.

0.3.0

Breaking: CloudFolderScreen is no longer a Scaffold.

The widget is now embeddable — put it inside a tab, a split-view pane, a bottom sheet, or your own Scaffold as needed.

Consequences:

• If you were using CloudFolderScreen as the direct home: of a MaterialApp, wrap it in a Scaffold:

  // Before
  home: CloudFolderScreen(storage: storage, appBar: AppBar(...));
  
  // After
  home: Scaffold(
    appBar: AppBar(...),
    body: CloudFolderScreen(storage: storage),
  );
  

• ScaffoldMessenger.of(context) inside your callbacks now inherits from the ancestor Scaffold (or MaterialApp's default), not from ours. SnackBars still work if any of those is present.
• FABs moved from Scaffold.floatingActionButton into a Stack + PositionedDirectional overlay inside the widget's own body. Same visual bottom-end placement; no external Scaffold slot consumed.

The appBar: slot is retained for the "embed with a section-scoped top bar" case (tabs, etc.) — it now renders as the first child of the internal Column.

0.2.0

Structural rework of CloudFolderScreen. Direct users of the widget need to adapt — see the "Breaking" section below.

New:

• CloudFolderScreen now takes an optional appBar: PreferredSizeWidget?. Consumers wire whatever they need (title, actions, outer-Navigator back button); pass null and the widget renders with no AppBar at all (the path bar becomes the top of the screen).
• New CloudPathBar widget rendered as the first row of the body, below the consumer AppBar. Layout: [back] [up] <breadcrumb>. Back walks an internal history stack of chain snapshots (no refetch); Up drops the last segment of the current path. Both disable at their boundaries. Breadcrumb segments stay tappable for direct jump-to-ancestor navigation. Exported from the barrel for consumers building custom screens.

Breaking behavioral changes to CloudFolderScreen:

• Folder navigation is now in-place. Tapping a subfolder updates the current folder in state instead of pushing a new CloudFolderScreen route. Only media viewer opens still push a route. If you were relying on Navigator.pop() to go back one folder level, that no longer works — use the built-in path bar back button or the OS back button (which is intercepted via PopScope).
• AppBar is no longer built for you. The widget's own breadcrumb AppBar and selection AppBar are both removed. Pass appBar: if you want an AppBar; the path bar (in browse mode) or the selection header (in selection mode) both live below whatever you pass.
• Selection info (the "N selected" title and close button) has moved from the AppBar's leading + title slots into the same in-body slot as the path bar. Bulk-action FABs are unchanged.

Migration:

// Before
CloudFolderScreen(storage: storage, folderId: root);

// After — same, plus your AppBar if you want one
CloudFolderScreen(
  storage: storage,
  folderId: root,
  appBar: AppBar(title: const Text('My files')),
);

0.1.2

Selection & progress polish.

• Selection-mode UI moved to the FAB slot. Bulk Move-To and Bulk Delete used to live as AppBar actions. They're now FloatingActionButtons in the same position the browse-mode FABs occupied, so the user's thumb doesn't have to jump to the top of the screen after a long-press.
• Per-item progress in bulk operations. Both CloudBulkProgressDialog (deletes / moves) and CloudBatchUploadDialog now render a scrollable list of items under the total progress bar. Each row shows its own state icon (pending / running / done / failed). Upload rows also show byte-level progress bars while a file is streaming.
• Two-phase upload flow. After the file picker closes, a "Preparing files" dialog now shows per-file progress during thumbnail generation. On large batches this used to be a silent multi-second gap before the upload dialog appeared. Uploads only start after all thumbnails are ready, so a cancel during the prep phase is a clean cancel.
• BREAKING (CloudBulkProgressDialog): the constructor now requires an itemLabel: (T) => String callback so the dialog can render each item's display name in the list. If you use this widget directly, add itemLabel: (item) => item.name (or any identifier your item type exposes).

Also:

• CloudFolderScreen gained a new preparingUploadsTitle localization slot (EN / AR provided).
• Sibling dep cloud_storage_platform_interface bumped to ^0.1.2.

0.1.1

• file_picker bumped ^8 → ^11. API change: use FilePicker.pickFiles(...) (static) instead of the removed FilePicker.platform.pickFiles(...). Package internals updated; consumers using the gallery widgets don't need changes.
• share_plus bumped ^10 → ^11. API change: switched to SharePlus.instance.share(ShareParams(files: ..., subject: ...)). The legacy Share.shareXFiles(...) was deprecated. Only affects the "open in external app" fallback flow.
• mime bumped ^1 → ^2.
• chewie bumped ^1.8.5 → ^1.13.0. Deliberately capped below 1.14 (which pulls in win32 ^6 via wakelock_plus 1.6+ and conflicts with share_plus <13 and file_picker <12).
• path_provider ^2.1.6.
• Sibling dep cloud_storage_platform_interface bumped to ^0.1.1.
• Removed unnecessary library-name declaration.

0.1.0

Initial release. Ready-made Flutter widgets on top of cloud_storage.

Widgets:

• CloudFolderScreen — drop-in file-manager screen. Breadcrumb app bar, thumbnail grid, long-press context menu, four floating action buttons (Select / Create folder / Add link / Upload file), full-featured action dialogs.
• CloudMediaViewer — headless swipeable photo/video viewer. Videos stream from the network on first play and cache locally for instant replay.
• CloudFolderGrid — reactive grid tile view of a folder.
• CloudFolderBreadcrumb — self-loading or externally-supplied breadcrumb.
• CloudUploadDialog, CloudBatchUploadDialog, CloudBulkProgressDialog — modal progress dialogs.
• pickCloudFolder(...) — modal folder picker.
• generateThumbnails(File) — helper that produces 256 px thumb + 1024 px preview JPEGs from images and videos.

Features:

• Selection mode with bulk delete / move.
• Custom thumbnail support for files and links (including videos when the auto-generated one isn't good enough).
• External-app open flow for non-media files (PDFs, docs, ...) with fallback to the OS share sheet.
• URL links open in an external browser via url_launcher.
• Read-only mode hides all write-oriented UI.
• Localization via CloudGalleryLocalizations delegate — English and Arabic strings included; RTL layouts respected throughout.
• Every widget derives its colors, text styles, and directionality from the ambient Theme / Directionality.