@conduction/nextcloud-vue 2.147.0 → 2.149.0

package/dist/esm/components/CnFactsWidget/CnFactsWidget.vue2.js

@@ -15,6 +15,7 @@ import { useRefLabels } from '../../composables/useRefLabels.js';
 import { dispatchAction } from '../../utils/actionsDispatcher.js';
 import { isBadgeVariant } from '../../utils/badgeVariants.js';
 import { formatBoardDate } from '../../utils/boardDate.js';
+import { formatTermDuration } from '../../utils/builtInFormatters.js';
 import { conditionalLine } from '../../utils/conditionalLine.js';
 import { parseDateValue } from '../../utils/dateVariant.js';
 import { fetchListTotal } from '../../utils/fetchFilterCounts.js';
@@ -238,7 +239,7 @@ var script = {
 		 * - `headerPill` — a status pill in the card header (reported through the `header` event): `{ path?, text?, map?, variant?, variantMap?, colorMap? }`, read from the record like a `pill` entry (DqBezwaar "Advies ontvangen"); nothing shows while the value is empty.
 		 * - `notice` — `{ text, variant? }`, a note band inside the card under the facts (`info` by default; `success`, `warning` or `error`); the text is translated.
 		 * - `footnote` — a plain muted line under the facts, without a band (DqZaakBesluiten "Na het ondertekenen ..."); the text is translated.
-		 *   `format` is `text` (default), `date` (board short date), `date-long` (always with the year), `longdate` (the month written out, the year only outside this year: "3 oktober"), `year` ("2026"), `list` (an array joined by ", ", each item read at `itemPath` and written in `itemFormat`), `group` (a Nextcloud group by its display name), `bytes` (a size, "1.5 MB"), `number` (in the reader's language, `decimals` fraction digits when set), `months` (a number of months in words, whole years as years: 240 is "20 jaar") or `currency` (a money amount in the reader's language, "€ 1.234,50": the code in `currency`, else the record's `currencyField`, else the app's reporting currency, else EUR; `decimals` defaults to 2).
+		 *   `format` is `text` (default), `date` (board short date), `date-long` (always with the year), `longdate` (the month written out, the year only outside this year: "3 oktober"), `duration` (an ISO period in words, "4 weken"; `extendBy` names the extension period on the record: "4 weken, te verdagen met 2"), `year` ("2026"), `list` (an array joined by ", ", each item read at `itemPath` and written in `itemFormat`), `group` (a Nextcloud group by its display name), `bytes` (a size, "1.5 MB"), `number` (in the reader's language, `decimals` fraction digits when set), `months` (a number of months in words, whole years as years: 240 is "20 jaar") or `currency` (a money amount in the reader's language, "€ 1.234,50": the code in `currency`, else the record's `currencyField`, else the app's reporting currency, else EUR; `decimals` defaults to 2).
 		 *   `map` turns a raw value into a label (translated). `parts` (on a `line`) lists paths, or `{ path, label?, format? }`, joined by `separator` (default " · "); empty parts are dropped.
 		 * - `source` — `{ register, schema, id }` or `{ url }`; omitted = the current object. `{ register, schema, filter, sort? }` without `id` reads the first object that matches `filter` in `sort` order (`{ field, dir }`): the latest count of a shift. An entry with `from: "object"` reads the current object even then (a client card that also shows the ticket's channel).
 		 * - `endpointSource` — `{ url, method?, params?, responsePath? }`, the block a stat or chart takes: the facts read an app endpoint, shared and cached like those.
@@ -619,18 +620,19 @@ var script = {
 			if (!link || typeof link !== 'object' || !link.label) {
 				return null
 			}
+			const linkView = this.linkWords(link);
 			if (typeof link.sidebarTab === 'string' && link.sidebarTab !== '') {
 				return this.objectSidebarState
-					? { label: this.tr(link.label), sidebarTab: link.sidebarTab, icon: typeof link.icon === 'string' ? link.icon : '' }
+					? { ...linkView, sidebarTab: link.sidebarTab, icon: typeof link.icon === 'string' ? link.icon : '' }
 					: null
 			}
 			if (link.route) {
 				const to = this.resolveRoute(link.route, this.record);
-				return to ? { label: this.tr(link.label), to } : null
+				return to ? { ...linkView, to } : null
 			}
 			if (typeof link.href === 'string' && link.href !== '') {
 				const href = this.linkHref(link, this.record);
-				return href ? { label: this.tr(link.label), href, target: link.target === '_blank' ? '_blank' : '', icon: typeof link.icon === 'string' ? link.icon : '' } : null
+				return href ? { ...linkView, href, target: link.target === '_blank' ? '_blank' : '', icon: typeof link.icon === 'string' ? link.icon : '' } : null
 			}
 			return null
 		},
@@ -769,6 +771,23 @@ var script = {
 	},
 
 	methods: {
+		/**
+		 * A link's label and the muted note under it, their `{path}` and
+		 * `{path:format}` placeholders filled from the record ("{page:last-segment}").
+		 *
+		 * @param {object} link The configured link.
+		 * @return {{label: string, note: string}}
+		 * @spec openspec/changes/facts-link-label-from-record/specs/facts-widget/spec.md#requirement-a-facts-link-can-take-its-words-from-the-record
+		 */
+		linkWords(link) {
+			const fill = (text) => (text.includes('{') && this.record ? this.templateValue(this.record, text) : this.tr(text));
+			const label = fill(String(link.label));
+			return {
+				label: label || this.tr(String(link.label)),
+				note: typeof link.note === 'string' && link.note !== '' ? fill(link.note) : '',
+			}
+		},
+
 		/**
 		 * Open the page's object sidebar on one of its tabs.
 		 *
@@ -1646,7 +1665,16 @@ var script = {
 				const date = parseDateValue(raw);
 				return date === null ? '' : String(date.getFullYear())
 			}
+			// A term in words, with the extension at `extendBy` on the record: "4 weken, te verdagen met 2".
+			if (format === 'duration') {
+				return formatTermDuration(raw, typeof spec.extendBy === 'string' && record ? readPath(record, spec.extendBy) : null)
+			}
 			// The month written out, the year only outside this year: "3 oktober".
+			// One segment of a path ("Team/Page"): its first or its last.
+			if (format === 'first-segment' || format === 'last-segment') {
+				const segments = String(raw).split('/').map((part) => part.trim()).filter((part) => part !== '');
+				return (format === 'first-segment' ? segments[0] : segments[segments.length - 1]) || ''
+			}
 			if (format === 'longdate') {
 				return formatLongDate(raw)
 			}