@dejwcake/craftable 2.2.0 → 2.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dejwcake/craftable",
-  "version": "2.2.0",
+  "version": "2.3.0",
   "description": "This is a frontend dependency for Craftable. Craftable is a Laravel-based open-source toolkit for building administration interfaces.",
   "type": "module",
   "main": "./dist/index.cjs",

package/src/index.js

@@ -61,7 +61,14 @@ export { default as ActivationError } from './auth/ActivationError.vue';
 export { default as TranslationListing } from './translation/TranslationListing.vue';
 
 // Utilities
-export { formatDate, formatDatetime, formatTime, nowInTimezone, dayjs } from './utils/dateFormatters.js';
+export {
+    formatDate,
+    formatDatetime,
+    formatTime,
+    formatDuration,
+    nowInTimezone,
+    dayjs,
+} from './utils/dateFormatters.js';
 export { mediaCollectionProp, mediaCollectionDefaults } from './utils/mediaProps.js';
 export { notifySuccess, notifyError } from './utils/notify.js';
 export { getDateFnsLocale, initDateFnsLocale } from './utils/dateFnsLocale.js';

package/src/utils/dateFormatters.js

@@ -23,6 +23,47 @@ export function formatTime(time, format = 'HH:mm') {
     return d.isValid() ? d.format(format) : '';
 }
 
+const SECONDS_IN_MINUTE = 60;
+const SECONDS_IN_HOUR = 3600;
+const SECONDS_IN_DAY = 86400;
+
+/**
+ * Formats a number of seconds as a compact duration, e.g. `359d 19h 1m 39s`.
+ *
+ * Zero-valued units are dropped, so an exact hour reads `2h` rather than `0d 2h 0m 0s`, and a
+ * duration of zero reads `0s`. `null`, `undefined`, negative and non-finite values (`NaN`,
+ * `Infinity`) return the placeholder, which lets a listing cell or detail row render a missing or
+ * invalid value without a guard at the call site.
+ *
+ * Deliberately plain arithmetic rather than dayjs's duration plugin: that plugin normalises a
+ * duration into years and months, so its `hours()` is the component of a year/month/day breakdown
+ * and does not line up with a total day count. Mixing the two reports 31,086,099 s as
+ * `359d 5h 1m 39s` instead of `359d 19h 1m 39s`.
+ *
+ * @param {number|null|undefined} seconds total seconds; fractions are floored.
+ * @param {string} [placeholder] returned for `null`, `undefined`, negative and non-finite values.
+ * @returns {string}
+ */
+export function formatDuration(seconds, placeholder = '—') {
+    if (seconds === null || seconds === undefined) {
+        return placeholder;
+    }
+
+    const total = Math.floor(seconds);
+    if (!Number.isFinite(total) || total < 0) {
+        return placeholder;
+    }
+
+    const parts = [
+        [Math.floor(total / SECONDS_IN_DAY), 'd'],
+        [Math.floor((total % SECONDS_IN_DAY) / SECONDS_IN_HOUR), 'h'],
+        [Math.floor((total % SECONDS_IN_HOUR) / SECONDS_IN_MINUTE), 'm'],
+        [total % SECONDS_IN_MINUTE, 's'],
+    ].filter(([amount]) => amount > 0);
+
+    return parts.length === 0 ? '0s' : parts.map(([amount, unit]) => `${amount}${unit}`).join(' ');
+}
+
 export function nowInTimezone(tz = 'UTC', format = 'YYYY-MM-DD HH:mm:ss') {
     return dayjs().tz(tz).format(format);
 }