@conduction/nextcloud-vue 2.79.0 → 2.81.0

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

@@ -0,0 +1,867 @@
+import { emit } from '@nextcloud/event-bus';
+import { translate } from '@nextcloud/l10n';
+import { NcLoadingIcon } from '@nextcloud/vue';
+import Check from 'vue-material-design-icons/Check.vue';
+import ContentCopy from 'vue-material-design-icons/ContentCopy.vue';
+import EyeOutline from 'vue-material-design-icons/EyeOutline.vue';
+import __sfc_main from '../CnIcon/CnIcon.vue.js';
+import __sfc_main$1 from '../CnStatusBadge/CnStatusBadge.vue.js';
+import { resolveEndpointRequest } from '../../composables/useEndpointSource.js';
+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 { parseDateValue } from '../../utils/dateVariant.js';
+import { readPath } from '../../utils/readPath.js';
+import { resolveDeepTokens, hasUnresolvedDeepTokens } from '../../utils/resolveFilterTokens.js';
+
+/** Kinds of entry a `fields[]` item can be. A labelled item without `as` is a row. */
+const KINDS = Object.freeze(['row', 'title', 'line', 'pill', 'lead', 'text']);
+
+/**
+ * The label resolver every facts widget on the page shares, made on first use
+ * (the object store needs an active pinia). One batched request per register and
+ * schema for the ids it has not seen; a label it has read stays until the page
+ * reloads, and an object the store already holds is not fetched at all.
+ *
+ * @type {{resolve: Function}|null}
+ */
+let refLabels = null;
+
+/** The page-wide reference label resolver. */
+function sharedRefLabels() {
+	if (!refLabels) {
+		refLabels = useRefLabels();
+	}
+	return refLabels
+}
+
+/**
+ * Key of a resolved reference in the widget's `labels` data.
+ *
+ * @param {{register: string, schema: string, labelField?: string}} resolve The entry's `resolve` config.
+ * @param {string} id The referenced object's id.
+ * @return {string} The key.
+ */
+function refKey(resolve, id) {
+	return `${resolve.register}/${resolve.schema}/${resolve.labelField || ''}/${id}`
+}
+
+/** Event-bus channel a reveal of a masked value is announced on, so an app can log it. */
+const FACTS_REVEAL_CHANNEL = 'cn:facts:reveal';
+
+/**
+ * CnFactsWidget — the `facts` widget: a card of facts about ONE object.
+ *
+ * Renders the configured fields of the current detail-page object, or of one
+ * other object named by `content.source`, as the side cards on the screens
+ * draw them: label/value rows (a two-column grid, label muted), a bold title
+ * line that may link, muted meta lines that join several fields with " · ",
+ * a status pill, and one link at the foot.
+ *
+ * Everything is configuration; nothing in it knows an app:
+ *
+ * ```json
+ * {
+ *   "type": "facts",
+ *   "title": "Zaak",
+ *   "content": {
+ *     "source": { "register": "dossiq", "schema": "case", "id": "@object.case" },
+ *     "fields": [
+ *       { "as": "title", "path": "title", "route": { "name": "CaseDetail", "params": { "id": "@source.id" } } },
+ *       { "as": "line", "parts": ["identifier", "caseTypeTitle"] },
+ *       { "as": "pill", "path": "status", "map": { "open": "In behandeling" } },
+ *       { "path": "deadline", "label": "Termijn", "format": "date" }
+ *     ],
+ *     "link": { "label": "Naar de zaak", "route": { "name": "CaseDetail", "params": { "id": "@source.id" } } },
+ *     "emptyText": "Geen zaak"
+ *   }
+ * }
+ * ```
+ *
+ * Tokens: `source.id` takes the shared filter tokens; `source.url` takes them
+ * inside the url, the endpoint grammar (`/apps/x/api/y/@objectId`)
+ * (`@objectId`, `@object.<field>`, `@workspace.<key>`, `@me`, ...). Routes
+ * and the link also take `@source.<field>` (a field of the object shown).
+ * A source whose id token does not resolve renders the empty text, never a
+ * request for the literal token.
+ *
+ * Labels, map values, the link label and the empty text go through the host
+ * app's translate (`cnTranslate`).
+ */
+var script = {
+	name: 'CnFactsWidget',
+
+	components: { Check, CnIcon: __sfc_main, CnStatusBadge: __sfc_main$1, ContentCopy, EyeOutline, NcLoadingIcon },
+
+	inject: {
+		cnTranslate: { default: () => (key) => key },
+		cnObjectContext: { default: null },
+		cnWorkspaceContext: { default: null },
+		/** Pre-bound action dispatcher of CnPageRenderer, for `action` / `headerAction`. */
+		cnDispatchAction: { default: null },
+	},
+
+	props: {
+		/**
+		 * The widget configuration.
+		 *
+		 * - `fields` — the entries, in order. Each is `{ path, label?, as?, format?, map?, itemPath?, parts?, separator?, route?, variant?, variantMap?, icon?, copy?, reveal?, text?, title?, subtitle?, initialsPath?, tone? }`.
+		 *   `as` is `row` (default when `label` or `icon` is set), `title`, `line`, `text` (a line in the normal ink), `lead` (an icon tile or initials beside `title` and `subtitle`) or `pill`.
+		 *   A row's `format` may also be `email`, `phone` or `url` (a link) or `masked` (the last four characters; `reveal: true` adds Show). `copy: true` adds a copy button; `icon` replaces the label.
+		 *   A part may be `{ text }`, a constant; a `line` or `text` entry without `path` or `parts` shows its `text`.
+		 *   `resolve: { register, schema, labelField? }` on an entry or a part turns a value that is a reference (an id, or a list of ids) into the label of the referenced object (`labelField`, else `title`, then `name`): the case type or status of a task shows its name, not its uuid. The ids are fetched once per register and schema through the object store and shared by every facts widget on the page; the entry stays empty until its label is known, and when no label can be read.
+		 * - `action` — an action drawn as a button under the facts; `headerAction` — one drawn in the card header (reported through the `header` event).
+		 *   `format` is `text` (default), `date` (board short date), `date-long` (always with the year) or `list` (an array joined by ", ", each item read at `itemPath`).
+		 *   `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.
+		 * - `link` — `{ label, route? | href? }` at the foot.
+		 * - `hideEmpty` — drop an entry whose value is empty (default true).
+		 * - `emptyText` — shown when no entry has a value.
+		 *
+		 * @type {{fields?: Array<object>, source?: object, link?: object, hideEmpty?: boolean, emptyText?: string}}
+		 */
+		content: {
+			type: Object,
+			default: () => ({}),
+		},
+
+		/**
+		 * The current detail-page object, passed by the detail page host.
+		 * Read when `content.source` is not set.
+		 */
+		objectData: {
+			type: Object,
+			default: null,
+		},
+
+		/** The current detail-page object id, for the `@objectId` token. */
+		objectId: {
+			type: [String, Number],
+			default: null,
+		},
+	},
+
+	emits: ['header', 'reveal'],
+
+	data() {
+		return {
+			fetched: null,
+			loading: false,
+			error: false,
+			/** Keys of the masked rows the reader chose to show. */
+			revealed: {},
+			/** Key of the row whose value was just copied. */
+			copied: '',
+			/** Labels of the referenced objects read so far, by `refKey`. */
+			labels: {},
+		}
+	},
+
+	computed: {
+		/**
+		 * The token context: the detail object (prop, else the injected context)
+		 * and the page workspace.
+		 *
+		 * @return {object}
+		 */
+		tokenCtx() {
+			const unwrap = (c) => (c && typeof c === 'object' && 'value' in c ? c.value : c);
+			const injected = unwrap(this.cnObjectContext) || {};
+			return {
+				...injected,
+				objectId: this.objectId ?? injected.objectId ?? this.objectData?.id ?? null,
+				object: this.objectData || injected.object || null,
+				workspace: unwrap(this.cnWorkspaceContext) || {},
+			}
+		},
+
+		/**
+		 * The source declaration with its tokens resolved, or null for the current object.
+		 *
+		 * @return {object|null}
+		 */
+		resolvedSource() {
+			const source = this.content?.source;
+			if (!source || typeof source !== 'object') {
+				return null
+			}
+			if (typeof source.url === 'string' && source.url !== '') {
+				// The endpoint grammar: tokens INSIDE the url, and a request
+				// that is blocked while one leaves an empty path segment.
+				const request = resolveEndpointRequest({ url: source.url }, this.tokenCtx);
+				return { url: request.blocked ? '' : request.url }
+			}
+			return resolveDeepTokens(source, this.tokenCtx)
+		},
+
+		/**
+		 * A stable key of the resolved source, so the widget refetches only when it changes.
+		 *
+		 * @return {string}
+		 */
+		sourceKey() {
+			return this.resolvedSource ? JSON.stringify(this.resolvedSource) : ''
+		},
+
+		/**
+		 * The object the facts are read from.
+		 *
+		 * @return {object|null}
+		 */
+		record() {
+			return this.resolvedSource ? this.fetched : this.objectData
+		},
+
+		/**
+		 * The entries to draw, consecutive rows grouped into one list.
+		 *
+		 * @return {Array<object>}
+		 */
+		blocks() {
+			const record = this.record;
+			if (!record) {
+				return []
+			}
+			const fields = Array.isArray(this.content?.fields) ? this.content.fields : [];
+			const hideEmpty = this.content?.hideEmpty !== false;
+			const out = [];
+			fields.forEach((field, index) => {
+				if (!field || typeof field !== 'object') {
+					return
+				}
+				const kind = this.kindOf(field);
+				const key = String(field.key || field.path || `${kind}-${index}`).replace(/[^\w-]/g, '-');
+				const value = this.entryValue(record, field, kind);
+				if (value === '' && (hideEmpty || kind === 'lead')) {
+					return
+				}
+				if (kind === 'row') {
+					const last = out[out.length - 1];
+					const row = { key, label: this.tr(field.label || ''), value, ...this.rowExtras(record, field, value) };
+					if (last && last.kind === 'rows') {
+						last.rows.push(row);
+					} else {
+						out.push({ kind: 'rows', key: `rows-${index}`, rows: [row] });
+					}
+					return
+				}
+				const block = { kind, key, value };
+				if (kind === 'lead') {
+					block.subtitle = this.partsValue(record, field.subtitle);
+					block.icon = typeof field.icon === 'string' ? field.icon : '';
+					block.initials = block.icon ? '' : this.initialsOf(readPath(record, field.initialsPath));
+					block.tone = ['success', 'info', 'warning', 'error'].includes(field.tone) ? field.tone : 'neutral';
+				}
+				if (kind === 'title' && field.route) {
+					block.to = this.resolveRoute(field.route, record);
+				}
+				if (kind === 'pill') {
+					const raw = readPath(record, field.path);
+					const variant = (field.variantMap && field.variantMap[raw]) || field.variant;
+					block.variant = isBadgeVariant(variant) ? variant : 'default';
+				}
+				out.push(block);
+			});
+			return out
+		},
+
+		/**
+		 * The foot link, resolved, or null.
+		 *
+		 * @return {{label: string, to?: object, href?: string}|null}
+		 */
+		link() {
+			const link = this.content?.link;
+			if (!link || typeof link !== 'object' || !link.label) {
+				return null
+			}
+			if (link.route) {
+				const to = this.resolveRoute(link.route, this.record);
+				return to ? { label: this.tr(link.label), to } : null
+			}
+			if (typeof link.href === 'string' && link.href !== '') {
+				const href = this.resolveTemplate(link.href, this.record);
+				return href ? { label: this.tr(link.label), href } : null
+			}
+			return null
+		},
+
+		/**
+		 * The action under the facts, as drawn: `{ label, icon }`, or null.
+		 *
+		 * @return {{label: string, icon: string}|null}
+		 * @spec openspec/changes/screens-relation-pages/specs/relation-pages/spec.md#requirement-the-facts-card-draws-contact-details-identity-and-a-lead
+		 */
+		action() {
+			return this.actionView(this.content?.action)
+		},
+
+		/**
+		 * The header action, as drawn: `{ label, icon }`, or null.
+		 *
+		 * @return {{label: string, icon: string}|null}
+		 * @spec openspec/changes/screens-relation-pages/specs/relation-pages/spec.md#requirement-the-facts-card-draws-contact-details-identity-and-a-lead
+		 */
+		headerAction() {
+			return this.actionView(this.content?.headerAction)
+		},
+
+		/** @return {string} The reveal button's text. */
+		showLabel() {
+			return translate('nextcloud-vue', 'Show')
+		},
+
+		/**
+		 * The empty line.
+		 *
+		 * @return {string}
+		 */
+		emptyLabel() {
+			return this.tr(this.content?.emptyText || 'Nothing to show yet')
+		},
+	},
+
+	watch: {
+		sourceKey: {
+			immediate: true,
+			handler() {
+				this.load();
+			},
+		},
+
+		record: {
+			immediate: true,
+			handler() {
+				this.loadLabels();
+			},
+		},
+
+		headerAction: {
+			immediate: true,
+			handler() {
+				this.emitHeader();
+			},
+		},
+	},
+
+	methods: {
+		/**
+		 * Translate through the host app.
+		 *
+		 * @param {string} text The text.
+		 * @return {string}
+		 */
+		tr(text) {
+			if (typeof text !== 'string' || text === '') {
+				return ''
+			}
+			return typeof this.cnTranslate === 'function' ? this.cnTranslate(text) : text
+		},
+
+		/**
+		 * The kind of a field entry.
+		 *
+		 * @param {object} field The entry.
+		 * @return {string} `row`, `title`, `line` or `pill`.
+		 */
+		kindOf(field) {
+			if (KINDS.includes(field.as)) {
+				return field.as
+			}
+			return field.label || field.icon ? 'row' : 'line'
+		},
+
+		/**
+		 * The display text of an entry of any kind: a lead's title, the parts of
+		 * a line or text, a constant `text`, else the value at `path`.
+		 *
+		 * @param {object} record The object.
+		 * @param {object} field The entry.
+		 * @param {string} kind The entry's kind.
+		 * @return {string}
+		 * @spec openspec/changes/screens-relation-pages/specs/relation-pages/spec.md#requirement-the-facts-card-draws-contact-details-identity-and-a-lead
+		 */
+		entryValue(record, field, kind) {
+			if (kind === 'lead') {
+				return this.partsValue(record, field.title)
+			}
+			if ((kind === 'line' || kind === 'text') && Array.isArray(field.parts)) {
+				return this.lineValue(record, field)
+			}
+			if ((kind === 'line' || kind === 'text') && !field.path && typeof field.text === 'string') {
+				return this.tr(field.text)
+			}
+			return this.valueOf(record, field)
+		},
+
+		/**
+		 * A lead's title or subtitle: a path, a part spec, or an array of parts
+		 * joined as a line joins them.
+		 *
+		 * @param {object} record The object.
+		 * @param {string|object|Array} spec The declaration.
+		 * @return {string}
+		 */
+		partsValue(record, spec) {
+			if (typeof spec === 'string' && spec !== '') {
+				return this.valueOf(record, { path: spec })
+			}
+			if (Array.isArray(spec)) {
+				return this.lineValue(record, { parts: spec })
+			}
+			if (spec && typeof spec === 'object') {
+				return this.lineValue(record, { parts: [spec] })
+			}
+			return ''
+		},
+
+		/**
+		 * The initials of a name: "Sanne de Vries" reads "SV".
+		 *
+		 * @param {unknown} name The name.
+		 * @return {string}
+		 */
+		initialsOf(name) {
+			if (typeof name !== 'string' || name.trim() === '') {
+				return ''
+			}
+			const words = name.trim().split(/\s+/).filter((word) => /^\p{Lu}/u.test(word));
+			const picked = words.length ? words : name.trim().split(/\s+/);
+			const first = picked[0].charAt(0);
+			const last = picked.length > 1 ? picked[picked.length - 1].charAt(0) : '';
+			return (first + last).toUpperCase()
+		},
+
+		/**
+		 * What a row adds to its value: an icon, a link for the email, phone
+		 * and url formats, the masked text, and the copy and reveal buttons.
+		 *
+		 * @param {object} record The object.
+		 * @param {object} field The entry.
+		 * @param {string} value The display text.
+		 * @return {object}
+		 * @spec openspec/changes/screens-relation-pages/specs/relation-pages/spec.md#requirement-the-facts-card-draws-contact-details-identity-and-a-lead
+		 */
+		rowExtras(record, field, value) {
+			const extras = {
+				icon: typeof field.icon === 'string' ? field.icon : '',
+				path: field.path || '',
+				raw: readPath(record, field.path),
+				copy: field.copy === true && value !== '',
+				reveal: false,
+				masked: '',
+				href: '',
+				external: false,
+			};
+			if (value === '') {
+				return extras
+			}
+			if (field.format === 'email') {
+				extras.href = `mailto:${value}`;
+			} else if (field.format === 'phone') {
+				extras.href = `tel:${value.replace(/[^\d+]/g, '')}`;
+			} else if (field.format === 'url') {
+				extras.href = /^https?:\/\//i.test(value) ? value : `https://${value}`;
+				extras.external = true;
+			} else if (field.format === 'masked') {
+				extras.masked = value.length > 4 ? '*'.repeat(Math.min(value.length - 4, 5)) + value.slice(-4) : value;
+				extras.reveal = field.reveal === true && value.length > 4;
+			}
+			return extras
+		},
+
+		/**
+		 * Show a masked value, and say so: the `reveal` event and the event-bus
+		 * channel {@link FACTS_REVEAL_CHANNEL}, so an app can log who saw it.
+		 *
+		 * @param {object} row The row.
+		 * @spec openspec/changes/screens-relation-pages/specs/relation-pages/spec.md#requirement-the-facts-card-draws-contact-details-identity-and-a-lead
+		 */
+		reveal(row) {
+			this.revealed = { ...this.revealed, [row.key]: true };
+			const detail = { path: row.path };
+			/**
+			 * @event reveal Emitted when the reader shows a masked value.
+			 * @type {{path: string}} The path of the shown field.
+			 */
+			this.$emit('reveal', detail);
+			emit(FACTS_REVEAL_CHANNEL, { ...detail, objectId: this.tokenCtx.objectId, register: this.tokenCtx.register || null, schema: this.tokenCtx.schema || null });
+		},
+
+		/**
+		 * Copy a row's value to the clipboard.
+		 *
+		 * @param {object} row The row.
+		 * @return {Promise<void>}
+		 */
+		async copy(row) {
+			const text = row.raw === null || row.raw === undefined || typeof row.raw === 'object' ? row.value : String(row.raw);
+			try {
+				await navigator.clipboard.writeText(text);
+				this.copied = row.key;
+				setTimeout(() => {
+					if (this.copied === row.key) {
+						this.copied = '';
+					}
+				}, 2000);
+			} catch (e) {
+				// eslint-disable-next-line no-console
+				console.warn('[CnFactsWidget] could not copy:', e?.message || e);
+			}
+		},
+
+		/**
+		 * @param {object} row The row.
+		 * @return {string} The copy button's accessible name.
+		 */
+		copyLabel(row) {
+			return this.copied === row.key
+				? translate('nextcloud-vue', 'Copied')
+				: translate('nextcloud-vue', 'Copy {label}', { label: row.label || row.value })
+		},
+
+		/**
+		 * @param {object} row The row.
+		 * @return {string} The reveal button's accessible name.
+		 */
+		revealLabel(row) {
+			return translate('nextcloud-vue', 'Show {label}', { label: row.label || '' }).trim()
+		},
+
+		/**
+		 * The drawn part of an action declaration.
+		 *
+		 * @param {object} action The declaration.
+		 * @return {{label: string, icon: string}|null}
+		 */
+		actionView(action) {
+			if (!action || typeof action !== 'object' || typeof action.label !== 'string' || action.label === '') {
+				return null
+			}
+			return { label: this.tr(action.label), icon: typeof action.icon === 'string' ? action.icon : '' }
+		},
+
+		/**
+		 * Dispatch an action with the record's tokens resolved (`@objectId`,
+		 * `@object.<field>`), through the page's dispatcher when there is one.
+		 *
+		 * @param {object} action The declaration.
+		 * @return {unknown}
+		 * @spec openspec/changes/screens-relation-pages/specs/relation-pages/spec.md#requirement-the-facts-card-draws-contact-details-identity-and-a-lead
+		 */
+		runAction(action) {
+			if (!action || typeof action !== 'object') {
+				return undefined
+			}
+			const resolved = resolveDeepTokens(action, this.tokenCtx);
+			if (typeof this.cnDispatchAction === 'function') {
+				return this.cnDispatchAction(resolved)
+			}
+			return dispatchAction(resolved, { router: this.$router || null })
+		},
+
+		/** Tell the card around the facts what its header shows (the header action). */
+		emitHeader() {
+			const view = this.headerAction;
+			/**
+			 * @event header Emitted with the card header's parts: the header action, if any.
+			 * @type {{link: null, note: string, action: (object|null)}} `action` is `{ label, icon, run }`.
+			 */
+			this.$emit('header', {
+				link: null,
+				note: '',
+				action: view ? { ...view, run: () => this.runAction(this.content.headerAction) } : null,
+			});
+		},
+
+		/**
+		 * The text of a reference: the labels of the objects its id(s) name, joined
+		 * by ", ". An id whose label is not known yet (or cannot be read) adds nothing.
+		 *
+		 * @param {unknown} raw The id, or a list of ids (or of `{ id }` objects).
+		 * @param {object} spec `{ resolve: { register, schema, labelField? }, itemPath? }`.
+		 * @return {string}
+		 */
+		refText(raw, spec) {
+			return this.refIds(raw, spec)
+				.map((id) => this.labels[refKey(spec.resolve, id)])
+				.filter((label) => typeof label === 'string' && label !== '')
+				.join(', ')
+		},
+
+		/**
+		 * The ids a reference value holds.
+		 *
+		 * @param {unknown} raw The value.
+		 * @param {object} spec `{ itemPath? }`.
+		 * @return {string[]}
+		 */
+		refIds(raw, spec) {
+			return (Array.isArray(raw) ? raw : [raw])
+				.map((item) => (item && typeof item === 'object' ? (spec.itemPath ? readPath(item, spec.itemPath) : (item.id ?? item.uuid)) : item))
+				.filter((id) => id !== null && id !== undefined && id !== '' && typeof id !== 'object')
+				.map(String)
+		},
+
+		/**
+		 * Every entry or part that carries `resolve`, with the record's value at its path.
+		 *
+		 * @param {object} record The object.
+		 * @return {Array<{spec: object, raw: unknown}>}
+		 */
+		refSpecs(record) {
+			const fields = Array.isArray(this.content?.fields) ? this.content.fields : [];
+			const specs = [];
+			const visit = (spec) => {
+				if (!spec || typeof spec !== 'object') {
+					return
+				}
+				if (spec.resolve && typeof spec.resolve === 'object' && spec.path) {
+					specs.push({ spec, raw: readPath(record, spec.path) });
+				}
+				const nested = [...(Array.isArray(spec.parts) ? spec.parts : []), ...(Array.isArray(spec.title) ? spec.title : [spec.title]), ...(Array.isArray(spec.subtitle) ? spec.subtitle : [spec.subtitle])];
+				nested.forEach(visit);
+			};
+			fields.forEach(visit);
+			return specs
+		},
+
+		/**
+		 * Read the labels of the referenced objects, one batched request per
+		 * register and schema, and keep them in `labels`.
+		 *
+		 * @param {object|null} record The object shown (defaults to the current record).
+		 * @return {Promise<void>}
+		 */
+		async loadLabels(record = this.record) {
+			if (!record) {
+				return
+			}
+			const groups = new Map();
+			for (const { spec, raw } of this.refSpecs(record)) {
+				const { register, schema, labelField } = spec.resolve;
+				if (!register || !schema) {
+					continue
+				}
+				const groupKey = `${register}/${schema}/${labelField || ''}`;
+				const group = groups.get(groupKey) || { resolve: spec.resolve, ids: new Set() };
+				this.refIds(raw, spec).forEach((id) => group.ids.add(id));
+				groups.set(groupKey, group);
+			}
+			if (groups.size === 0) {
+				return
+			}
+			const resolver = sharedRefLabels();
+			const next = { ...this.labels };
+			await Promise.all([...groups.values()].map(async ({ resolve, ids }) => {
+				const found = await resolver.resolve(resolve.register, resolve.schema, [...ids], resolve.labelField);
+				Object.entries(found).forEach(([id, label]) => {
+					next[refKey(resolve, id)] = label;
+				});
+			}));
+			this.labels = next;
+		},
+
+		/**
+		 * Read the source object.
+		 *
+		 * @return {Promise<void>}
+		 */
+		async load() {
+			const source = this.resolvedSource;
+			this.error = false;
+			if (!source) {
+				this.fetched = null;
+				return
+			}
+			const url = this.sourceUrl(source);
+			if (!url) {
+				this.fetched = null;
+				return
+			}
+			this.loading = true;
+			try {
+				const [{ default: axios }, { generateUrl }] = await Promise.all([
+					import('@nextcloud/axios'),
+					import('@nextcloud/router'),
+				]);
+				const full = url.startsWith('/apps/') || url.startsWith('/ocs/') ? generateUrl(url) : url;
+				const response = await axios.get(full);
+				const data = response && response.data;
+				this.fetched = data && typeof data === 'object' && !Array.isArray(data) ? data : null;
+			} catch (e) {
+				// eslint-disable-next-line no-console
+				console.warn('[CnFactsWidget] the source could not be read:', e?.message || e);
+				this.fetched = null;
+				this.error = true;
+			} finally {
+				this.loading = false;
+			}
+		},
+
+		/**
+		 * The URL of a resolved source, or '' when it cannot be read yet.
+		 *
+		 * @param {object} source The resolved source.
+		 * @return {string}
+		 */
+		sourceUrl(source) {
+			if (typeof source.url === 'string') {
+				return source.url
+			}
+			if (hasUnresolvedDeepTokens(source)) {
+				return ''
+			}
+			const { register, schema, id } = source;
+			if (!register || !schema || id === undefined || id === null || id === '' || typeof id === 'object') {
+				return ''
+			}
+			return `/apps/openregister/api/objects/${encodeURIComponent(register)}/${encodeURIComponent(schema)}/${encodeURIComponent(String(id))}`
+		},
+
+		/**
+		 * The display text of one field.
+		 *
+		 * @param {object} record The object.
+		 * @param {object} field The entry.
+		 * @return {string}
+		 */
+		valueOf(record, field) {
+			const raw = readPath(record, field.path);
+			return this.format(raw, field)
+		},
+
+		/**
+		 * The text of a `line` entry that joins several parts.
+		 *
+		 * @param {object} record The object.
+		 * @param {object} field The entry.
+		 * @return {string}
+		 */
+		lineValue(record, field) {
+			const separator = typeof field.separator === 'string' ? field.separator : ' · ';
+			return field.parts
+				.map((part) => {
+					const spec = typeof part === 'string' ? { path: part } : (part || {});
+					// A constant part (`{ text }`): "Handelsregister" after the legal form.
+					if (!spec.path && typeof spec.text === 'string') {
+						return this.tr(spec.text)
+					}
+					const value = this.format(readPath(record, spec.path), spec);
+					if (value === '') {
+						return ''
+					}
+					return spec.label ? `${this.tr(spec.label)} ${value}` : value
+				})
+				.filter((value) => value !== '')
+				.join(separator)
+		},
+
+		/**
+		 * Format a raw value.
+		 *
+		 * @param {unknown} raw The value.
+		 * @param {object} spec `{ format?, map?, itemPath? }`.
+		 * @return {string} The text, '' when empty.
+		 */
+		format(raw, spec) {
+			if (raw === null || raw === undefined || raw === '') {
+				return ''
+			}
+			if (spec.resolve && typeof spec.resolve === 'object') {
+				return this.refText(raw, spec)
+			}
+			const format = spec.format || 'text';
+			if (format === 'list' || Array.isArray(raw)) {
+				const items = (Array.isArray(raw) ? raw : [raw])
+					.map((item) => (spec.itemPath && item && typeof item === 'object' ? readPath(item, spec.itemPath) : item))
+					.map((item) => this.format(item, { ...spec, format: 'text' }))
+					.filter((item) => item !== '');
+				return items.join(', ')
+			}
+			if (format === 'date' || format === 'date-long') {
+				const date = parseDateValue(raw);
+				if (date === null) {
+					return ''
+				}
+				// A year far from now forces the long form, so date-long reuses the board formatter.
+				return format === 'date-long'
+					? formatBoardDate(date, new Date(date.getFullYear() + 1, 0, 1))
+					: formatBoardDate(date)
+			}
+			if (typeof raw === 'object') {
+				const label = raw.title || raw.name || raw.label || raw.displayName;
+				return typeof label === 'string' ? label : ''
+			}
+			if (typeof raw === 'boolean') {
+				const mapped = spec.map && spec.map[String(raw)];
+				return mapped ? this.tr(mapped) : this.tr(raw ? 'Yes' : 'No')
+			}
+			if (spec.map && Object.hasOwn(spec.map, String(raw))) {
+				return this.tr(spec.map[String(raw)])
+			}
+			return String(raw)
+		},
+
+		/**
+		 * Replace `@source.<field>` / `@source.id` and the shared tokens in a string.
+		 *
+		 * @param {string} value The template.
+		 * @param {object|null} record The object shown.
+		 * @return {string} The value, '' when a token stays unresolved.
+		 */
+		resolveTemplate(value, record) {
+			if (typeof value !== 'string') {
+				return value
+			}
+			let unresolved = false;
+			const replaced = value.replace(/@source\.([\w.@]+)/g, (match, path) => {
+				const read = record ? (path === 'id' ? (record.id ?? readPath(record, '@self.id')) : readPath(record, path)) : undefined;
+				if (read === undefined || read === null || read === '') {
+					unresolved = true;
+					return match
+				}
+				return String(read)
+			});
+			if (unresolved) {
+				return ''
+			}
+			if (replaced.charAt(0) === '@') {
+				const resolved = resolveDeepTokens(replaced, this.tokenCtx);
+				return typeof resolved === 'string' && resolved.charAt(0) === '@' ? '' : String(resolved)
+			}
+			return replaced
+		},
+
+		/**
+		 * Resolve a route declaration (`{ name, params?, query? }`).
+		 *
+		 * @param {object} route The declaration.
+		 * @param {object|null} record The object shown.
+		 * @return {object|null} The route, or null when a param stays unresolved.
+		 */
+		resolveRoute(route, record) {
+			if (!route || typeof route !== 'object' || !route.name) {
+				return null
+			}
+			const out = { name: route.name };
+			for (const key of ['params', 'query']) {
+				if (route[key] && typeof route[key] === 'object') {
+					out[key] = {};
+					for (const [name, value] of Object.entries(route[key])) {
+						const resolved = this.resolveTemplate(value, record);
+						if (resolved === '') {
+							return null
+						}
+						out[key][name] = resolved;
+					}
+				}
+			}
+			return out
+		},
+	},
+};
+
+export { FACTS_REVEAL_CHANNEL, script as default };
+//# sourceMappingURL=CnFactsWidget.vue2.js.map