1 files changed, 29 insertions, 0 deletions
diff --git a/player-android/lib/utils/duration_formatter.dart b/player-android/lib/utils/duration_formatter.dart
new file mode 100644
index 0000000..72e810b
--- /dev/null
+++ b/player-android/lib/utils/duration_formatter.dart
@@ -0,0 +1,29 @@
+// Duration formatting utilities shared across screen widgets.
+//
+// Centralises the conversion of fractional seconds to a human-readable string
+// so that [MediaGridScreen] and [FolderBrowserScreen] do not each carry their
+// own copy of the same logic (DRY / Single Responsibility).
+//
+// All functions are pure data-transformations: no widget state, no Riverpod
+// reads, no BuildContext — making them easy to unit-test in isolation.
+
+/// Formats [seconds] as `h:mm:ss` or `m:ss`, omitting leading zeros in the
+/// hours and minutes positions.
+///
+/// Examples:
+///   - 7320.0 → "2:02:00"
+///   - 210.5  → "3:30"
+///   - 30.0   → "0:30"
+///
+/// Uses integer arithmetic only — no [Duration] dependency — so the helper
+/// is lightweight and independently testable.
+String formatDuration(double seconds) {
+  final total = seconds.truncate();
+  final h = total ~/ 3600;
+  final m = (total % 3600) ~/ 60;
+  final s = total % 60;
+  if (h > 0) {
+    return '$h:${m.toString().padLeft(2, '0')}:${s.toString().padLeft(2, '0')}';
+  }
+  return '$m:${s.toString().padLeft(2, '0')}';
+}