@conduction/nextcloud-vue 2.56.0-beta.62 → 2.56.0-beta.63

package/src/components/CnDuplicateWarning/CnDuplicateWarning.vue

@@ -0,0 +1,318 @@
+<!--
+  - SPDX-FileCopyrightText: 2026 Conduction B.V.
+  - SPDX-License-Identifier: EUPL-1.2
+-->
+<template>
+	<CnDialog
+		:name="text(title) || t('nextcloud-vue', 'This may already exist')"
+		width="form"
+		data-testid="cn-duplicate-warning"
+		@closing="close">
+		<div class="cn-duplicate-warning">
+			<NcNoteCard :type="affordances.blocked ? 'error' : 'warning'" data-testid="cn-duplicate-warning-note">
+				{{ headlineText }}
+			</NcNoteCard>
+
+			<ul class="cn-duplicate-warning__matches">
+				<li v-for="row in rows"
+					:key="row.uuid"
+					class="cn-duplicate-warning__match"
+					data-testid="cn-duplicate-warning-match">
+					<a v-if="row.href" :href="row.href" class="cn-duplicate-warning__title">{{ row.title }}</a>
+					<span v-else class="cn-duplicate-warning__title">{{ row.title }}</span>
+					<span v-if="row.meta" class="cn-duplicate-warning__meta">{{ row.meta }}</span>
+					<span class="cn-duplicate-warning__meta">{{ row.matchedOn }} ({{ row.percentage }}%)</span>
+				</li>
+			</ul>
+
+			<NcTextField v-if="affordances.needsReason"
+				:label="text(reasonLabel) || t('nextcloud-vue', 'Why file it anyway')"
+				:modelValue="reason"
+				data-testid="cn-duplicate-warning-reason"
+				@update:modelValue="reason = $event" />
+
+			<p v-if="affordances.blocked && !affordances.mayContinue"
+				class="cn-duplicate-warning__hint"
+				data-testid="cn-duplicate-warning-blocked">
+				{{ text(blockedText) || t('nextcloud-vue', 'This cannot be filed twice. Open the one it matches, or ask a coordinator.') }}
+			</p>
+		</div>
+
+		<template #actions>
+			<NcButton variant="tertiary" data-testid="cn-duplicate-warning-cancel" @click="close">
+				{{ t('nextcloud-vue', 'Cancel') }}
+			</NcButton>
+			<NcButton v-if="affordances.mayContinue"
+				variant="primary"
+				:disabled="!canFile"
+				data-testid="cn-duplicate-warning-continue"
+				@click="fileAnyway">
+				{{ text(continueLabel) || t('nextcloud-vue', 'File it anyway') }}
+			</NcButton>
+		</template>
+	</CnDialog>
+</template>
+
+<script>
+import { translatePlural as n, translate as t } from '@nextcloud/l10n'
+import { generateUrl } from '@nextcloud/router'
+import { NcButton, NcNoteCard, NcTextField } from '@nextcloud/vue'
+import { duplicateAffordances } from '../../utils/duplicateWarning.js'
+import { fillTemplate } from '../../utils/fillTemplate.js'
+import { CnDialog } from '../CnDialog/index.js'
+
+/**
+ * CnDuplicateWarning — "this may already exist", before a record is filed.
+ * It renders OpenRegister's scored matches (`{ uuid, score, matchedOn }`),
+ * never scoring anything itself, with each matched record's title, a meta
+ * line, what it matched on and how strongly. Under a `warn` policy anyone may
+ * file it anyway; under `block` only a user who `mayOverride`, and they say
+ * why. A match the user may not read is reported without disclosing it.
+ * dossiq's case intake is the first consumer; pipelinq contacts share it.
+ *
+ * Open it in a template, or from code with `openDuplicateWarning(props)`,
+ * which resolves with `{ reason, over }` or null.
+ *
+ * ```vue
+ * <CnDuplicateWarning
+ *   :matches="matches"
+ *   :records="readableCases"
+ *   policy="block"
+ *   :may-override="isCoordinator"
+ *   record-url="/apps/dossiq/cases/{uuid}"
+ *   :field-labels="{ requester: 'Requester', title: 'Subject' }"
+ *   @file="save"
+ *   @close="cancel" />
+ * ```
+ */
+export default {
+	name: 'CnDuplicateWarning',
+
+	components: { CnDialog, NcButton, NcNoteCard, NcTextField },
+
+	inject: {
+		/** The host app's translate (CnAppRoot `cnTranslate`). */
+		cnTranslate: { default: () => (key) => key },
+	},
+
+	props: {
+		/**
+		 * The scored matches, as OpenRegister answered: `{ uuid, score, matchedOn }`.
+		 *
+		 * @type {Array<object>}
+		 */
+		matches: {
+			type: Array,
+			default: () => [],
+		},
+
+		/**
+		 * The matched records the user may read, matched by `id`, `uuid` or `@self.id`.
+		 *
+		 * @type {Array<object>}
+		 */
+		records: {
+			type: Array,
+			default: () => [],
+		},
+
+		/** `warn` lets anyone file it anyway; `block` only a user who `mayOverride`. */
+		policy: {
+			type: String,
+			default: 'warn',
+		},
+
+		/** Whether this user may file over a block (and must say why). */
+		mayOverride: {
+			type: Boolean,
+			default: false,
+		},
+
+		/** A record's title, a template filled from it. */
+		rowTitle: {
+			type: String,
+			default: '{title}',
+		},
+
+		/** A record's meta line, a template filled from it. */
+		rowMeta: {
+			type: String,
+			default: '{identifier}',
+		},
+
+		/** A record's page, a template with `{uuid}`; empty draws no link. */
+		recordUrl: {
+			type: String,
+			default: '',
+		},
+
+		/**
+		 * Words for the matched fields (`{ requester: "Requester" }`), through the host translate.
+		 *
+		 * @type {object}
+		 */
+		fieldLabels: {
+			type: Object,
+			default: () => ({}),
+		},
+
+		/** The dialog title; defaults to "This may already exist". */
+		title: {
+			type: String,
+			default: '',
+		},
+
+		/** The note's sentence, `{count}` filled; defaults to "%n existing record looks like this one.". */
+		headline: {
+			type: String,
+			default: '',
+		},
+
+		/** The sentence under a block the user may not pass. */
+		blockedText: {
+			type: String,
+			default: '',
+		},
+
+		/** The reason field's label. */
+		reasonLabel: {
+			type: String,
+			default: '',
+		},
+
+		/** The continue button's label; defaults to "File it anyway". */
+		continueLabel: {
+			type: String,
+			default: '',
+		},
+	},
+
+	emits: ['close', 'file'],
+
+	data() {
+		return {
+			reason: '',
+		}
+	},
+
+	computed: {
+		/**
+		 * What to draw and offer.
+		 *
+		 * @spec openspec/changes/duplicate-warning/specs/duplicate-warning/spec.md#requirement-a-generic-duplicate-warning
+		 * @return {{show: boolean, blocked: boolean, mayContinue: boolean, needsReason: boolean}}
+		 */
+		affordances() {
+			return duplicateAffordances({ matches: this.matches, policy: this.policy, mayOverride: this.mayOverride })
+		},
+
+		/** @return {boolean} Whether "file it anyway" may be pressed. */
+		canFile() {
+			return this.affordances.mayContinue && (!this.affordances.needsReason || this.reason.trim() !== '')
+		},
+
+		/** @return {string} The note's sentence. */
+		headlineText() {
+			const count = this.matches.length
+			if (this.headline) {
+				return fillTemplate(this.cnTranslate(this.headline), { count })
+			}
+			return n('nextcloud-vue', '%n existing record looks like this one.', '%n existing records look like this one.', count)
+		},
+
+		/**
+		 * One row per match: the readable record's title and meta and link, or
+		 * a neutral name for one the user may not read.
+		 *
+		 * @spec openspec/changes/duplicate-warning/specs/duplicate-warning/spec.md#requirement-a-generic-duplicate-warning
+		 * @return {Array<object>}
+		 */
+		rows() {
+			return this.matches.map((match) => {
+				const uuid = String((match && match.uuid) || '')
+				const record = this.records.find((row) => String((row && (row.id || row.uuid || (row['@self'] && row['@self'].id))) || '') === uuid)
+				const fields = Array.isArray(match && match.matchedOn) ? match.matchedOn : []
+				const score = Number(match && match.score)
+				return {
+					uuid,
+					title: record ? (fillTemplate(this.rowTitle, record).trim() || uuid) : t('nextcloud-vue', 'A record you may not open'),
+					meta: record ? fillTemplate(this.rowMeta, record).trim() : '',
+					href: record && this.recordUrl ? generateUrl(fillTemplate(this.recordUrl, { uuid: encodeURIComponent(uuid) })) : '',
+					matchedOn: fields.length
+						? fields.map((field) => (this.fieldLabels[field] ? this.cnTranslate(this.fieldLabels[field]) : field)).join(', ')
+						: t('nextcloud-vue', 'Matched on the score, not on a single field'),
+					percentage: Number.isFinite(score) ? Math.max(0, Math.min(100, Math.round(score * 100))) : 0,
+				}
+			})
+		},
+	},
+
+	methods: {
+		t,
+
+		/**
+		 * A prop text through the host translate.
+		 *
+		 * @param {string} value The text.
+		 * @return {string}
+		 */
+		text(value) {
+			return value ? this.cnTranslate(value) : ''
+		},
+
+		/** File it over the warning, carrying the reason and what it was filed over. */
+		fileAnyway() {
+			if (!this.canFile) {
+				return
+			}
+			/** @event file The user files it anyway. Payload: `{ reason, over }`, `over` the matched uuids. */
+			this.$emit('file', { reason: this.reason.trim(), over: this.matches.map((m) => String((m && m.uuid) || '')).filter(Boolean) })
+		},
+
+		/** Go back without filing. */
+		close() {
+			/** @event close The user went back without filing. */
+			this.$emit('close')
+		},
+	},
+}
+</script>
+
+<style scoped>
+.cn-duplicate-warning {
+	display: flex;
+	flex-direction: column;
+	gap: 12px;
+}
+
+.cn-duplicate-warning__matches {
+	display: flex;
+	flex-direction: column;
+	gap: 8px;
+	margin: 0;
+	padding: 0;
+	list-style: none;
+}
+
+.cn-duplicate-warning__match {
+	display: flex;
+	flex-wrap: wrap;
+	gap: 4px 12px;
+	padding: 8px 12px;
+	border: 1px solid var(--color-border);
+	border-radius: var(--border-radius-large, 8px);
+}
+
+.cn-duplicate-warning__title {
+	font-weight: 600;
+}
+
+.cn-duplicate-warning__meta,
+.cn-duplicate-warning__hint {
+	color: var(--color-text-maxcontrast);
+}
+
+.cn-duplicate-warning__hint {
+	margin: 0;
+}
+</style>

package/src/components/CnDuplicateWarning/index.js

@@ -0,0 +1,12 @@
+/**
+ * SPDX-FileCopyrightText: 2026 Conduction B.V.
+ * SPDX-License-Identifier: EUPL-1.2
+ *
+ * CnDuplicateWarning — "this may already exist", before a record is filed,
+ * from OpenRegister's scored matches.
+ */
+
+import CnDuplicateWarning from './CnDuplicateWarning.vue'
+
+export { CnDuplicateWarning }
+export default CnDuplicateWarning

package/src/components/CnFormDialog/CnFormDialog.vue

@@ -961,7 +961,7 @@ import { computeAssignments } from '../../utils/formAssign.js'
 import { resolveNextcloudGroup, searchNextcloudGroups } from '../../utils/groupAutocomplete.js'
 import { durationSeconds } from '../../utils/isoDuration.js'
 import { objectDisplayName } from '../../utils/objectName.js'
-import { fieldWithOptionsFrom, filterOptions, isOptionsFrom, loadOptionsFrom } from '../../utils/optionsFrom.js'
+import { fieldWithOptionsFrom, filterOptions, formTokenKeys, isOptionsFrom, loadOptionsFrom, resolveFormTokens } from '../../utils/optionsFrom.js'
 import { languageOptions, resolveDefaultToken, timezoneOptions } from '../../utils/pickerOptions.js'
 import { getDotted, planPropertySourceFill } from '../../utils/propertySourceFill.js'
 import { pruneRows } from '../../utils/pruneRows.js'
@@ -1573,6 +1573,8 @@ export default {
 			sourcedOptions: {},
 			// Whether a field's `optionsFrom` failed or gave no options, by field key: it falls back to text.
 			sourcedFailed: {},
+			// The resolved source each field's options were read from, by field key.
+			sourcedSignatures: {},
 			// Set while a save that passed its uniqueness check goes on.
 			uniqueChecked: false,
 			// The sections folded away (`sectionCollapsed` on one of their fields opens them folded).
@@ -1938,6 +1940,9 @@ export default {
 		visibleFields() {
 			return this.resolvedFields
 				.filter((field) => shouldShow(field, this.formData))
+				// `optionsFrom.hideWhenEmpty`: a select whose source gives nothing
+				// for the current values is left out (a type without formats).
+				.filter((field) => !(field.optionsFrom && field.optionsFrom.hideWhenEmpty === true && Array.isArray(this.sourcedOptions[field.key]) && this.sourcedOptions[field.key].length === 0))
 				// `requiredWhen`: required while its condition holds, so the
 				// asterisk, the board look's aria-required and validation follow.
 				.map((field) => (field.requiredWhen ? { ...field, required: conditionHolds(field.requiredWhen, this.formData, field.key) } : field))
@@ -2664,13 +2669,18 @@ export default {
 		 * @spec openspec/changes/form-field-options-from/specs/form-dialog/spec.md#requirement-a-select-field-can-read-its-options-from-a-source
 		 */
 		async fetchSourcedOptions(field, query) {
-			let all = this.sourcedOptions[field.key]
+			// A source that reads another field (`@answer.<key>`) is read again
+			// when that value changes: the cache is kept per resolved source.
+			const from = resolveFormTokens(field.optionsFrom, this.formData)
+			const signature = JSON.stringify(from)
+			let all = this.sourcedSignatures[field.key] === signature ? this.sourcedOptions[field.key] : null
 			if (!all) {
 				try {
-					all = await loadOptionsFrom(field.optionsFrom, resolveObjectTokenContext(this.cnObjectContext, this.cnDetailObjectContext) || {})
+					all = await loadOptionsFrom(from, resolveObjectTokenContext(this.cnObjectContext, this.cnDetailObjectContext) || {})
 				} catch {
 					all = []
 				}
+				this.sourcedSignatures = { ...this.sourcedSignatures, [field.key]: signature }
 				this.sourcedOptions = { ...this.sourcedOptions, [field.key]: all }
 				this.sourcedFailed = { ...this.sourcedFailed, [field.key]: all.length === 0 }
 				const labels = {}
@@ -2942,6 +2952,12 @@ export default {
 			// A hand edit ends this field's own rules; other fields may follow it.
 			delete this.assignedFrom[key]
 			this.runAssignments([key])
+			// A select whose source reads this field (`@answer.<key>`) reads it again.
+			for (const field of this.resolvedFields) {
+				if (isOptionsFrom(field.optionsFrom) && formTokenKeys(field.optionsFrom).includes(key)) {
+					this.loadAsyncOptions(field, '')
+				}
+			}
 		},
 
 		/**

package/src/components/CnIndexPage/CnIndexPage.vue

@@ -744,6 +744,28 @@
 					<NcLoadingIcon :size="32" :name="loadingText" />
 				</div>
 
+				<!-- A search the server refused for its grammar: the term with the
+				     character it stopped at, the server's reason, and what to do. -->
+				<div v-else-if="searchRefusal"
+					class="cn-index-page__search-refusal"
+					role="status"
+					data-testid="cn-index-page-search-refusal">
+					<NcNoteCard type="warning">
+						<p class="cn-index-page__search-refusal-headline">
+							{{ t('nextcloud-vue', 'This search could not be read from character {position}.', { position: searchRefusal.position }) }}
+						</p>
+						<p class="cn-index-page__search-refusal-term" data-testid="cn-index-page-search-refusal-term">
+							<span>{{ searchRefusal.before }}</span><mark v-if="searchRefusal.at">{{ searchRefusal.at }}</mark><span>{{ searchRefusal.after }}</span>
+						</p>
+						<p class="cn-index-page__search-refusal-muted">
+							{{ searchRefusal.message }}
+						</p>
+						<p class="cn-index-page__search-refusal-muted">
+							{{ searchRefusalHintText }}
+						</p>
+					</NcNoteCard>
+				</div>
+
 				<!-- Error state: the latest self-fetch failed (e.g. a search term the server rejects) -->
 				<div v-else-if="selfFetchFailed"
 					class="cn-index-page__empty"
@@ -1361,6 +1383,7 @@ import { buildRouteQueryFromViewState, buildViewCreatePayload, defaultFilterView
 import { savedViewBadge, savedViewOverrides } from '../../utils/savedViewOverrides.js'
 import { columnsFromSchema, fieldsFromSchema } from '../../utils/schema.js'
 import { resolveScopeLayout, resolveScopePresentation } from '../../utils/scopeListLayout.js'
+import { readSearchRefusal } from '../../utils/searchRefusal.js'
 import { orderToSortKeys } from '../../utils/sortOrder.js'
 import { annotateRows, filterSourceRows, pageSourceRows, rowsFromSourceBody } from '../../utils/sortSourceRows.js'
 import { dispatchObjectCreated } from '../../utils/walkthroughSignals.js'
@@ -2825,6 +2848,17 @@ export default {
 			default: null,
 		},
 
+		/**
+		 * What to do after a refused search, through the app's translate. The
+		 * default explains AND, OR, NOT and quotes.
+		 *
+		 * @spec openspec/changes/index-search-refusal/specs/index-search-refusal/spec.md#requirement-a-refused-search-is-said-where-it-was-typed
+		 */
+		searchRefusalHint: {
+			type: String,
+			default: '',
+		},
+
 		/** Accessible label for the loading spinner (NcLoadingIcon aria-label) */
 		loadingText: {
 			type: String,
@@ -4417,6 +4451,24 @@ export default {
 			return this.isSelfFetchMode && !!this.list.error?.value
 		},
 
+		/**
+		 * The failed fetch as a refused search, or null when it is not one.
+		 *
+		 * @spec openspec/changes/index-search-refusal/specs/index-search-refusal/spec.md#requirement-a-refused-search-is-said-where-it-was-typed
+		 * @return {object|null}
+		 */
+		searchRefusal() {
+			return this.selfFetchFailed ? readSearchRefusal(this.list.error.value, this.effectiveSearchValue) : null
+		},
+
+		/** @return {string} What to do after a refused search. */
+		searchRefusalHintText() {
+			if (this.searchRefusalHint) {
+				return typeof this.cnTranslate === 'function' ? this.cnTranslate(this.searchRefusalHint) : this.searchRefusalHint
+			}
+			return t('nextcloud-vue', 'Correct that character, or search for plain words. AND, OR and NOT work in capitals, and quotes make a phrase.')
+		},
+
 		/** Rows: store collection in self-fetch mode, else the `objects` prop. */
 		effectiveObjects() {
 			if (this.isNamedSource) {

package/src/components/CnNcDashboardList/CnNcDashboardList.vue

@@ -0,0 +1,218 @@
+<!--
+  - SPDX-FileCopyrightText: 2026 Conduction B.V.
+  - SPDX-License-Identifier: EUPL-1.2
+-->
+<template>
+	<div class="cn-nc-dashboard-list" data-testid="cn-nc-dashboard-list">
+		<p v-if="error"
+			class="cn-nc-dashboard-list__error"
+			role="status"
+			data-testid="cn-nc-dashboard-list-error">
+			{{ t('nextcloud-vue', 'This list could not be read.') }}
+		</p>
+		<CnDataTable v-else
+			:rows="rows"
+			:columns="columns"
+			:loading="loading"
+			hideHeader
+			borderless
+			:emptyText="text(config.emptyText) || t('nextcloud-vue', 'Nothing to show')"
+			@rowClick="onRowClick"
+			@rowAuxClick="onRowClick">
+			<template v-if="viewAllHref" #footer>
+				<a class="cn-data-table__view-all" :href="viewAllHref" data-testid="cn-nc-dashboard-list-view-all">
+					{{ text(config.viewAll.label) || t('nextcloud-vue', 'View all') }} →
+				</a>
+			</template>
+		</CnDataTable>
+	</div>
+</template>
+
+<script>
+import { translate as t } from '@nextcloud/l10n'
+import { generateUrl } from '@nextcloud/router'
+import { fetchEndpointSource } from '../../composables/useEndpointSource.js'
+import { fillTemplate } from '../../utils/fillTemplate.js'
+import { openRowTarget } from '../../utils/linkNavigation.js'
+import { readPath } from '../../utils/readPath.js'
+import { resolveDeepTokens } from '../../utils/resolveFilterTokens.js'
+import { CnDataTable } from '../CnDataTable/index.js'
+
+/** A name and a muted, right-aligned trailing line. */
+const COLUMNS = [
+	{ key: 'mainText', cellClass: 'cn-cell--strong' },
+	{ key: 'subText', cellClass: 'cn-cell--muted cn-cell--end' },
+]
+
+/**
+ * A url for an anchor: absolute and app-root paths as given, else through `generateUrl`.
+ *
+ * @param {string} url The url.
+ * @return {string}
+ */
+function appUrl(url) {
+	return /^(https?:)?\/\//i.test(url) || url.startsWith('/index.php') ? url : generateUrl(url)
+}
+
+/**
+ * CnNcDashboardList — the compact list a Nextcloud Dashboard widget shows:
+ * a bold name, a muted trailing line, and a "View all" link, read from
+ * OpenRegister or any endpoint. Each row opens its record in place (a
+ * modifier or middle click opens a new tab), because the Nextcloud Dashboard
+ * has no app router. `registerNcDashboardWidgets` mounts it per widget id, so
+ * an app's dashboard widgets are configuration rather than one component each.
+ *
+ * `config`:
+ * - `source`: `{ register, schema, params? }` (OpenRegister objects, rows in
+ *   `results`) or an endpointSource `{ url, params?, responsePath? }`. Filter
+ *   tokens (`@me`, `@today`, `@today-7d`) resolve in `params`, and an operator
+ *   map (`{ deadline: { lt: '@today' } }`) goes out as `deadline[lt]=…`.
+ * - `itemsPath`: the rows' path in the response, when not `results`.
+ * - `limit`: the most rows shown (default 7).
+ * - `title`, `subtitle`: templates filled from a row (default `{title}`, none).
+ * - `href`: a template for a row's page (`/apps/dossiq/cases/{id}`).
+ * - `viewAll`: `{ href, label? }`.
+ * - `emptyText`: text for an empty list.
+ *
+ * Texts go through the host translate.
+ */
+export default {
+	name: 'CnNcDashboardList',
+
+	components: { CnDataTable },
+
+	inject: {
+		/** The host app's translate (provided by `registerNcDashboardWidgets`). */
+		cnTranslate: { default: () => (key) => key },
+	},
+
+	props: {
+		/**
+		 * The list's configuration (see the component docs).
+		 *
+		 * @type {object}
+		 */
+		config: {
+			type: Object,
+			default: () => ({}),
+		},
+	},
+
+	data() {
+		return {
+			items: [],
+			loading: true,
+			error: false,
+			columns: COLUMNS,
+		}
+	},
+
+	computed: {
+		/** @return {number} The most rows shown. */
+		limit() {
+			return Number(this.config.limit) > 0 ? Number(this.config.limit) : 7
+		},
+
+		/**
+		 * The rows as the table draws them.
+		 *
+		 * @spec openspec/changes/nc-dashboard-widgets/specs/nc-dashboard-widgets/spec.md#requirement-dashboard-widgets-are-configuration
+		 * @return {Array<{id: string, mainText: string, subText: string, href: string}>}
+		 */
+		rows() {
+			return this.items.slice(0, this.limit).map((item, index) => {
+				const id = item.id ?? (item['@self'] && item['@self'].id) ?? index
+				return {
+					id: String(id),
+					mainText: this.fill(this.config.title || '{title}', item) || String(id),
+					subText: this.fill(this.config.subtitle, item),
+					href: this.config.href ? appUrl(fillTemplate(this.config.href, { ...item, id })) : '',
+				}
+			})
+		},
+
+		/** @return {string} The "View all" href, or ''. */
+		viewAllHref() {
+			const viewAll = this.config.viewAll
+			return viewAll && viewAll.href ? appUrl(viewAll.href) : ''
+		},
+	},
+
+	mounted() {
+		this.load()
+	},
+
+	methods: {
+		t,
+
+		/**
+		 * A config text through the host translate.
+		 *
+		 * @param {unknown} value The text.
+		 * @return {string}
+		 */
+		text(value) {
+			return typeof value === 'string' && value !== '' ? this.cnTranslate(value) : ''
+		},
+
+		/**
+		 * A template filled from a row, translated first.
+		 *
+		 * @param {unknown} template The template.
+		 * @param {object} item The row.
+		 * @return {string}
+		 */
+		fill(template, item) {
+			return typeof template === 'string' && template !== '' ? fillTemplate(this.cnTranslate(template), item).trim() : ''
+		},
+
+		/**
+		 * Read the rows: OpenRegister objects or an endpoint.
+		 *
+		 * @spec openspec/changes/nc-dashboard-widgets/specs/nc-dashboard-widgets/spec.md#requirement-dashboard-widgets-are-configuration
+		 * @return {Promise<void>}
+		 */
+		async load() {
+			const source = this.config.source || {}
+			this.loading = true
+			this.error = false
+			try {
+				// Tokens nested below an operator map (`'@self': { lastUserActivity: { lt: '@today-7d' } }`)
+				// resolve here; the endpoint path resolves one level only.
+				const params = resolveDeepTokens(source.params || {}, {})
+				const request = source.register && source.schema
+					? { url: `/apps/openregister/api/objects/${source.register}/${source.schema}`, params: { _limit: this.limit, ...params } }
+					: { ...source, params }
+				const data = await fetchEndpointSource(request, {}, { fresh: true })
+				const list = readPath(data, this.config.itemsPath || (source.register ? 'results' : '')) ?? data
+				this.items = Array.isArray(list) ? list.filter((item) => item && typeof item === 'object') : []
+			} catch {
+				this.error = true
+				this.items = []
+			} finally {
+				this.loading = false
+			}
+		},
+
+		/**
+		 * Open a row's page.
+		 *
+		 * @param {object} row The row.
+		 * @param {MouseEvent} event The click.
+		 */
+		onRowClick(row, event) {
+			if (row && row.href) {
+				openRowTarget(event, row.href)
+			}
+		},
+	},
+}
+</script>
+
+<style scoped>
+.cn-nc-dashboard-list__error {
+	margin: 0;
+	padding: 8px 0;
+	color: var(--color-text-maxcontrast);
+}
+</style>