@conduction/nextcloud-vue 2.114.0 → 2.115.0

package/l10n/en.json

@@ -1929,7 +1929,10 @@
     "or": "or",
     "no value": "no value",
     "yes": "yes",
-    "no": "no"
+    "no": "no",
+    "Recompute nomination": "Recompute nomination",
+    "Recompute": "Recompute",
+    "Task deadline": "Deadline"
   },
   "plurals": {
     "{count} member": [

package/l10n/nl.json

@@ -2141,7 +2141,15 @@
     "or": "of",
     "no value": "geen waarde",
     "yes": "ja",
-    "no": "nee"
+    "no": "nee",
+    "Recompute nomination": "Nominatie herberekenen",
+    "Recompute": "Herberekenen",
+    "Task deadline": "Deadline",
+    "The macro did not run: {error}": "De macro is niet uitgevoerd: {error}",
+    "Last run: {name}, {date}": "Laatst uitgevoerd: {name}, {date}",
+    "This record has no macros": "Er zijn geen macro's voor dit item",
+    "Running …": "Bezig …",
+    "Execute": "Uitvoeren"
   },
   "plurals": {
     "{count} member": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@conduction/nextcloud-vue",
-  "version": "2.114.0",
+  "version": "2.115.0",
   "description": "Shared Vue component library for Conduction Nextcloud apps — complements @nextcloud/vue with higher-level components, OpenRegister integration, and NL Design System support",
   "homepage": "https://github.com/ConductionNL/nextcloud-vue#readme",
   "bugs": {

package/src/components/CnAdvancedFormDialog/CnPropertyValueCell.vue

@@ -251,7 +251,7 @@ export default {
 		/** Full JSON schema object */
 		schema: { type: Object, default: null },
 		/** Resolved current value (formData[key] ?? objectValue) */
-		value: { type: [Boolean, String, Number, Object, Array], default: null },
+		value: { type: [String, Number, Boolean, Object, Array], default: null }, // eslint-disable-line vue/prefer-prop-type-boolean-first -- an empty field value must stay a string
 		/** Whether this property is editable at all */
 		isEditable: { type: Boolean, default: true },
 		/** Whether this row is currently selected for editing */

package/src/components/CnCellRenderer/CnCellRenderer.vue

@@ -456,9 +456,13 @@ export default {
 	},
 
 	props: {
-		/** The raw cell value */
+		/**
+		 * The raw cell value. String precedes Boolean: with Boolean first Vue
+		 * casts an empty string to `true`, and an empty cell drew a check mark.
+		 */
 		value: {
-			type: [Boolean, String, Number, Array, Object],
+			// eslint-disable-next-line vue/prefer-prop-type-boolean-first -- an empty string must stay a string
+			type: [String, Number, Boolean, Array, Object],
 			default: null,
 		},
 

package/src/components/CnChoiceCards/CnChoiceCards.vue

@@ -180,7 +180,8 @@ export default {
 		 * @type {string|number|boolean|Array|null}
 		 */
 		modelValue: {
-			type: [Boolean, String, Number, Array, Object],
+			// eslint-disable-next-line vue/prefer-prop-type-boolean-first -- an option value of '' must stay a string
+			type: [String, Number, Boolean, Array, Object],
 			default: null,
 		},
 

package/src/components/CnDashboardPage/CnDashboardPage.vue

@@ -42,11 +42,28 @@
 				     group ends the description line ("Week 41 · alle teams ·
 				     [Deze week | Dit kwartaal | Dit jaar]"). -->
 				<div
-					v-if="datePeriodInDescription || descriptionPageFilters.length > 0"
+					v-if="datePeriodInDescription || descriptionPageFilters.length > 0 || descriptionSelectFilters.length > 0"
 					class="cn-dashboard-page__description cn-dashboard-page__description--with-period"
 					data-testid="cn-dashboard-page-subtitle">
 					<span v-if="subtitleText">{{ subtitleText }}</span>
 					<span v-if="subtitleText" aria-hidden="true">&middot;</span>
+					<!-- A select page filter with `placement: "description"`
+					     (DqDoorlooptijd "alle zaaktypen"): a compact select on the
+					     description line, before the period group. -->
+					<template v-for="pf in descriptionSelectFilters" :key="pf.key">
+						<NcSelect
+							class="cn-dashboard-page__description-select"
+							:modelValue="selectedPageFilterOption(pf)"
+							:options="pageFilterSegments(pf)"
+							:clearable="pf.clearable === true"
+							:placeholder="pf.placeholder ? effectiveTranslate(pf.placeholder) : undefined"
+							:loading="pageFilterLoading[pf.key] === true"
+							:ariaLabelCombobox="pf.label ? effectiveTranslate(pf.label) : pf.key"
+							label="label"
+							:data-testid="'cn-page-filter-' + pf.key"
+							@update:modelValue="onPageFilterChange(pf, $event)" />
+						<span aria-hidden="true">&middot;</span>
+					</template>
 					<CnSegmentedControl
 						v-if="datePeriodInDescription"
 						size="compact"
@@ -1721,7 +1738,8 @@ export default {
 		 * mount. The control is a select, or with `control: 'segmented'` a
 		 * compact segmented group; `placement: 'description'` puts a segmented
 		 * group on the header's description line, after the period group
-		 * (DqProcesanalyse "Gemiddeld | Mediaan"). An endpoint widget can read
+		 * (DqProcesanalyse "Gemiddeld | Mediaan"), and a select before it
+		 * (DqDoorlooptijd "alle zaaktypen"). An endpoint widget can read
 		 * the value in its `responsePath` too (`phaseDays.@workspace.measure`).
 		 * `optionsFrom` reads the options instead of listing them: `{ url,
 		 * params?, responsePath?, valueField?, labelField? }` from an app
@@ -2446,10 +2464,26 @@ export default {
 		 * @return {Array<object>}
 		 */
 		rowPageFilters() {
-			const inDescription = this.descriptionPageFilters
+			const inDescription = [...this.descriptionPageFilters, ...this.descriptionSelectFilters]
 			return (this.pageFilters || []).filter((pf) => pf && pf.key && !inDescription.includes(pf))
 		},
 
+		/**
+		 * The select page filters drawn on the description line
+		 * (`placement: "description"`, any control but `segmented`), before
+		 * the period group: DqDoorlooptijd's "alle zaaktypen". Without a
+		 * header row they fall back to the filter row.
+		 *
+		 * @spec openspec/changes/dashboard-select-filter-in-description/specs/dashboard-select-filter-in-description/spec.md#requirement-a-select-page-filter-can-sit-on-the-description-line
+		 * @return {Array<object>}
+		 */
+		descriptionSelectFilters() {
+			if (!this.showHeader) {
+				return []
+			}
+			return (this.pageFilters || []).filter((pf) => pf && pf.key && pf.control !== 'segmented' && pf.placement === 'description')
+		},
+
 		/**
 		 * The edit button's label through the app's translate: a manifest's
 		 * `editLabel` ("Edit layout", DqDashboard) reads in the user's language.
@@ -5186,6 +5220,14 @@ export default {
 	gap: 8px;
 }
 
+/* A select on the description line takes the width of its choice, not a
+   form field's, and no margin of its own. */
+.cn-dashboard-page__description-select {
+	min-width: 180px;
+	max-width: 280px;
+	margin: 0;
+}
+
 .cn-dashboard-page__date-segmented {
 	display: flex;
 	align-items: center;

package/src/components/CnDetailWidgetHost/CnDetailWidgetHost.vue

@@ -333,7 +333,7 @@ import CnDetailWidgetHeaderItems from './CnDetailWidgetHeaderItems.vue'
 import { useIntegrationRegistry } from '../../composables/useIntegrationRegistry.js'
 import { normalizeLook } from '../../composables/useLook.js'
 import { isAppInstalled } from '../../utils/appInstalled.js'
-import { widgetHeaderLink } from '../../utils/contentHeaderLink.js'
+import { resolveHeaderLink, widgetHeaderLink } from '../../utils/contentHeaderLink.js'
 import { pickDeclaredProps } from '../../utils/declaredProps.js'
 import { unwrapAppConfig } from '../../utils/formatMetric.js'
 import { isActivityWidget } from '../../utils/headerMeta.js'
@@ -712,7 +712,7 @@ export default {
 		 * @return {object|null} `{ label, route?, params?, query?, href? }` or null.
 		 */
 		cardHeaderLink() {
-			return this.rendererHeader.link || (this.showHeaderLink ? widgetHeaderLink(this.widget) : null)
+			return this.rendererHeader.link || (this.showHeaderLink ? resolveHeaderLink(widgetHeaderLink(this.widget), { objectId: this.objectId, object: this.object }) : null)
 		},
 
 		/**

package/src/components/CnIndexPage/CnIndexPage.vue

@@ -1431,6 +1431,7 @@ import { buildDefaultActions } from './defaultActions.js'
 import { dispatchAction } from './manifestActionDispatch.js'
 import { applyManualOrder, dropInOrder, manualOrderKey, moveInOrder, visibleIdsOf } from './manualOrder.js'
 import { orderColumns, personalColumnsKey, reconcilePersonalColumns } from './personalColumns.js'
+import { rowsToCsv } from './rowsToCsv.js'
 import { createSelfModeActions, resolveRowTarget } from './selfModeActions.js'
 import { applyRowPatches, normalisePaneWidth, rowIdOf, splitLayoutFor } from './splitView.js'
 import { useNamedSource } from './useNamedSource.js'
@@ -9510,6 +9511,8 @@ export default {
 					this.onHeaderAction({ action: button.run, id: button.run })
 				} else if (this.register && this.exportSchemaSlug) {
 					this.onExportClick(button.format)
+				} else if (this.isNamedSource && !this.hasMassExportListener()) {
+					this.downloadNamedRows()
 				} else {
 					this.showExportDialog = true
 				}
@@ -9536,13 +9539,46 @@ export default {
 		 * @return {boolean}
 		 */
 		headerExportAvailable(button) {
-			if (!this.isNamedSource || (button && button.run)) {
+			if (!this.isNamedSource || (button && button.run) || this.hasMassExportListener()) {
 				return true
 			}
+			// A named source exports the rows it holds as CSV (downloadNamedRows).
+			return this.renderedColumns.some((col) => col && typeof col.key === 'string' && col.key !== '')
+		},
+
+		/**
+		 * Whether the consumer listens to `@mass-export`.
+		 *
+		 * @return {boolean}
+		 */
+		hasMassExportListener() {
 			const props = this.$ && this.$.vnode && this.$.vnode.props
 			return Boolean(props && typeof props.onMassExport === 'function')
 		},
 
+		/**
+		 * Download the rows of a named or endpoint source as CSV: every row the
+		 * source holds for the current query, with the table's columns. Such a
+		 * source has no server export, and a Download that does nothing is
+		 * worse than none.
+		 *
+		 * @spec openspec/changes/index-named-source-export/specs/index-named-source-export/spec.md#requirement-a-named-source-list-downloads-its-rows
+		 * @return {void}
+		 */
+		downloadNamedRows() {
+			const csv = rowsToCsv(this.namedRows, this.renderedColumns)
+			const blob = new Blob(['\uFEFF' + csv], { type: 'text/csv;charset=utf-8' })
+			const url = URL.createObjectURL(blob)
+			const link = document.createElement('a')
+			const name = String(this.title || this.entitySource || 'export').trim().toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, '') || 'export'
+			link.href = url
+			link.download = `${name}.csv`
+			document.body.appendChild(link)
+			link.click()
+			link.remove()
+			URL.revokeObjectURL(url)
+		},
+
 		/**
 		 * Click dispatch from CnActionsBar's `@header-action`. Looks
 		 * up the resolved entry by id, invokes its handler if any,

package/src/components/CnIndexPage/rowsToCsv.js

@@ -0,0 +1,87 @@
+/**
+ * SPDX-FileCopyrightText: 2026 Conduction B.V.
+ * SPDX-License-Identifier: EUPL-1.2
+ *
+ * The rows a list shows, as a CSV file: one column per table column, headed by
+ * its label. Used by an index page whose rows come from a named or endpoint
+ * source, which has no server export of its own.
+ *
+ * @spec openspec/changes/index-named-source-export/specs/index-named-source-export/spec.md#requirement-a-named-source-list-downloads-its-rows
+ */
+
+/**
+ * A value as the text of one CSV cell. A list joins its items, a record reads
+ * its name, an empty value is an empty cell.
+ *
+ * @param {unknown} value The cell value.
+ * @return {string} The cell text.
+ */
+export function cellText(value) {
+	if (value === null || value === undefined) {
+		return ''
+	}
+	if (Array.isArray(value)) {
+		return value.map(cellText).filter((item) => item !== '').join('; ')
+	}
+	if (typeof value === 'object') {
+		for (const key of ['title', 'name', 'label', 'displayName', 'id']) {
+			if (value[key] !== undefined && value[key] !== null && typeof value[key] !== 'object') {
+				return String(value[key])
+			}
+		}
+		return JSON.stringify(value)
+	}
+	return String(value)
+}
+
+/**
+ * One CSV field: quoted when it holds a separator, a quote or a line break,
+ * and a leading `=`, `+`, `-` or `@` is neutralised with a `'` so a
+ * spreadsheet does not read the cell as a formula.
+ *
+ * @param {string} text The cell text.
+ * @return {string} The field.
+ */
+export function csvField(text) {
+	let out = String(text)
+	if (/^[=+\-@\t\r]/.test(out)) {
+		out = `'${out}`
+	}
+	return /[",\r\n]/.test(out) ? `"${out.replace(/"/g, '""')}"` : out
+}
+
+/**
+ * The value of a column in a row: a dotted key reads a nested field, a flat
+ * key falls back to the row's `@self`, as the table reads it.
+ *
+ * @param {object} row The row.
+ * @param {string} key The column key.
+ * @return {unknown} The value.
+ */
+function columnValue(row, key) {
+	if (key.includes('.')) {
+		return key.split('.').reduce((obj, part) => obj?.[part], row)
+	}
+	if (row?.[key] === undefined && row?.['@self'] && typeof row['@self'] === 'object') {
+		return row['@self'][key]
+	}
+	return row?.[key]
+}
+
+/**
+ * The rows as CSV text, a header line of the column labels first. Columns
+ * without a key (selection, row actions) are left out.
+ *
+ * @param {Array<object>} rows The rows.
+ * @param {Array<{key: string, label?: string}>} columns The table columns.
+ * @return {string} The CSV text, lines ended with CRLF.
+ */
+export function rowsToCsv(rows, columns) {
+	const cols = (Array.isArray(columns) ? columns : [])
+		.filter((col) => col && typeof col.key === 'string' && col.key !== '' && col.widget !== 'actions')
+	const lines = [cols.map((col) => csvField(col.label || col.key)).join(',')]
+	for (const row of Array.isArray(rows) ? rows : []) {
+		lines.push(cols.map((col) => csvField(cellText(columnValue(row, col.key)))).join(','))
+	}
+	return lines.join('\r\n') + '\r\n'
+}

package/src/components/CnMacrosWidget/CnMacrosWidget.md

@@ -0,0 +1,30 @@
+# CnMacrosWidget
+
+The macros a record's schema declares, each with a button that runs it: `type: "macros"` on a detail page.
+
+A macro is an OpenRegister declared action (`configuration['x-openregister-action']`) with `macro: true` and a bound
+manual flow. The widget lists them in declaration order and runs the pressed one through
+`POST /api/objects/{register}/{schema}/{id}/actions/{action}`, as the person and under the action's own right. After a
+run it asks the page to refresh (`cn:page:refresh`). The last run is read from the record's audit trail
+(`action.macro`); when the trail cannot be read the line is left out.
+
+## Content
+
+| Key | Type | Description |
+|---|---|---|
+| `description` | `string` | The line under the title, translated. |
+| `emptyText` | `string` | Shown when the schema declares no macros, translated. |
+
+## Example
+
+```json
+{ "id": "case-macros", "type": "macros", "title": "Macros", "content": { "description": "Several steps at once; then you see what changed" } }
+```
+
+## Props
+
+| Prop | Type | Default | Description |
+|------|------|---------|-------------|
+| `content` | Object | `{}` | The widget's content above: `description` and `emptyText`, both translated |
+| `objectData` | Object | `null` | The bound record |
+| `objectId` | String \| Number | `''` | The bound record's id |

package/src/components/CnMacrosWidget/CnMacrosWidget.vue

@@ -0,0 +1,266 @@
+<!--
+  - SPDX-FileCopyrightText: 2026 Conduction B.V.
+  - SPDX-License-Identifier: EUPL-1.2
+-->
+
+<!--
+  CnMacrosWidget — the macros a record's schema declares, each with a button
+  that runs it (`type: "macros"`, DqZaakAssistent "Macro's").
+
+  A macro is a declared action (`configuration['x-openregister-action']`) with
+  `macro: true` and a bound manual flow; OpenRegister runs it as the person,
+  under the action's own right, through
+  `POST /api/objects/{register}/{schema}/{id}/actions/{action}`. The widget
+  lists what the schema declares and runs what is pressed: it adds no rights and
+  no list of its own. The last run comes from the record's audit trail
+  (`action.macro`), and after a run the page is asked to refresh.
+-->
+<template>
+	<div class="cn-macros-widget" data-testid="cn-macros-widget">
+		<p v-if="content.description" class="cn-macros-widget__description">
+			{{ tr(content.description) }}
+		</p>
+		<p v-if="loading" class="cn-macros-widget__muted">
+			{{ t('nextcloud-vue', 'Loading …') }}
+		</p>
+		<p v-else-if="macros.length === 0" class="cn-macros-widget__muted" data-testid="cn-macros-widget-empty">
+			{{ content.emptyText ? tr(content.emptyText) : t('nextcloud-vue', 'This record has no macros') }}
+		</p>
+		<ul v-else class="cn-macros-widget__list">
+			<li
+				v-for="macro in macros"
+				:key="macro.key"
+				class="cn-macros-widget__row"
+				:data-testid="`cn-macros-widget-row-${macro.key}`">
+				<div class="cn-macros-widget__text">
+					<span class="cn-macros-widget__name">{{ macro.name }}</span>
+					<span v-if="macro.description" class="cn-macros-widget__hint">{{ macro.description }}</span>
+				</div>
+				<NcButton
+					:disabled="running !== ''"
+					:data-testid="`cn-macros-widget-run-${macro.key}`"
+					@click="run(macro)">
+					{{ running === macro.key ? t('nextcloud-vue', 'Running …') : t('nextcloud-vue', 'Execute') }}
+				</NcButton>
+			</li>
+		</ul>
+		<NcNoteCard
+			v-if="error"
+			type="error"
+			data-testid="cn-macros-widget-error">
+			{{ error }}
+		</NcNoteCard>
+		<NcNoteCard
+			v-else-if="lastRun"
+			type="success"
+			data-testid="cn-macros-widget-last-run">
+			{{ t('nextcloud-vue', 'Last run: {name}, {date}', { name: lastRun.name, date: lastRun.date }) }}
+		</NcNoteCard>
+	</div>
+</template>
+
+<script>
+import axios from '@nextcloud/axios'
+import { emit } from '@nextcloud/event-bus'
+import { translate as t } from '@nextcloud/l10n'
+import { generateUrl } from '@nextcloud/router'
+import { NcButton, NcNoteCard } from '@nextcloud/vue'
+import { declaredMacros } from '../../utils/declaredMacros.js'
+
+export default {
+	name: 'CnMacrosWidget',
+
+	components: {
+		NcButton,
+		NcNoteCard,
+	},
+
+	inject: {
+		cnTranslate: { default: null },
+	},
+
+	props: {
+		/**
+		 * The widget's content: `description` (the line under the title),
+		 * `emptyText`, both translated.
+		 */
+		content: {
+			type: Object,
+			default: () => ({}),
+		},
+
+		/** The bound record. */
+		objectData: {
+			type: Object,
+			default: null,
+		},
+
+		/** The bound record's id. */
+		objectId: {
+			type: [String, Number],
+			default: '',
+		},
+	},
+
+	data() {
+		return {
+			macros: [],
+			loading: false,
+			running: '',
+			error: '',
+			lastRun: null,
+		}
+	},
+
+	computed: {
+		/** @return {{register: string, schema: string, id: string}} Where the record lives. */
+		target() {
+			const self = this.objectData?.['@self'] || {}
+			return {
+				register: String(self.register ?? ''),
+				schema: String(self.schema ?? ''),
+				id: String(this.objectId || self.id || this.objectData?.id || ''),
+			}
+		},
+	},
+
+	watch: {
+		'target.schema': {
+			immediate: true,
+			handler() {
+				this.load()
+			},
+		},
+	},
+
+	methods: {
+		t,
+
+		/**
+		 * Translate an app-supplied text through the host app when it offers it.
+		 *
+		 * @param {string} text The text.
+		 * @return {string} The translated text.
+		 */
+		tr(text) {
+			return typeof this.cnTranslate === 'function' ? this.cnTranslate(text) : text
+		},
+
+		/**
+		 * Read the schema's macros and the record's last macro run.
+		 *
+		 * @return {Promise<void>}
+		 */
+		async load() {
+			const { register, schema, id } = this.target
+			if (schema === '' || id === '') {
+				this.macros = []
+				return
+			}
+			this.loading = true
+			try {
+				const res = await axios.get(generateUrl('/apps/openregister/api/schemas/{schema}', { schema }), register ? { params: { register } } : undefined)
+				this.macros = declaredMacros(res?.data || null)
+			} catch {
+				this.macros = []
+			} finally {
+				this.loading = false
+			}
+			if (this.macros.length > 0) {
+				await this.loadLastRun()
+			}
+		},
+
+		/**
+		 * The record's most recent macro run, from its audit trail. Left empty
+		 * when the trail cannot be read: it is a convenience, not a fact the
+		 * widget may invent.
+		 *
+		 * @return {Promise<void>}
+		 */
+		async loadLastRun() {
+			const { register, schema, id } = this.target
+			try {
+				const res = await axios.get(
+					generateUrl('/apps/openregister/api/objects/{register}/{schema}/{id}/audit-trails', { register, schema, id }),
+					{ params: { action: 'action.macro', _limit: 1, '_sort[created]': 'DESC' } },
+				)
+				const entry = (res?.data?.results || [])[0]
+				const key = entry?.changed?.declaredAction
+				const macro = this.macros.find((candidate) => candidate.key === key)
+				this.lastRun = macro && entry.created
+					? { name: macro.name, date: new Date(entry.created).toLocaleString() }
+					: null
+			} catch {
+				this.lastRun = null
+			}
+		},
+
+		/**
+		 * Run one macro as the person, then ask the page to refresh.
+		 *
+		 * @param {{key: string, name: string}} macro The macro.
+		 * @return {Promise<void>}
+		 */
+		async run(macro) {
+			const { register, schema, id } = this.target
+			this.running = macro.key
+			this.error = ''
+			try {
+				await axios.post(generateUrl('/apps/openregister/api/objects/{register}/{schema}/{id}/actions/{action}', { register, schema, id, action: macro.key }))
+				this.lastRun = { name: macro.name, date: new Date().toLocaleString() }
+				emit('cn:page:refresh', { source: 'cn-macros-widget' })
+			} catch (e) {
+				this.error = t('nextcloud-vue', 'The macro did not run: {error}', { error: e?.response?.data?.error || e?.message || '' })
+			} finally {
+				this.running = ''
+			}
+		},
+	},
+}
+</script>
+
+<style scoped>
+.cn-macros-widget {
+	display: flex;
+	flex-direction: column;
+	gap: 12px;
+}
+
+.cn-macros-widget__description,
+.cn-macros-widget__muted {
+	margin: 0;
+	color: var(--color-text-maxcontrast);
+}
+
+.cn-macros-widget__list {
+	margin: 0;
+	padding: 0;
+	list-style: none;
+}
+
+.cn-macros-widget__row {
+	display: flex;
+	align-items: center;
+	justify-content: space-between;
+	gap: 12px;
+	padding-block: 10px;
+	border-top: 1px solid var(--color-border);
+}
+
+.cn-macros-widget__text {
+	display: flex;
+	flex-direction: column;
+	gap: 2px;
+	min-width: 0;
+}
+
+.cn-macros-widget__name {
+	font-weight: 600;
+}
+
+.cn-macros-widget__hint {
+	color: var(--color-text-maxcontrast);
+	font-size: 13px;
+}
+</style>

package/src/components/CnMacrosWidget/index.js

@@ -0,0 +1,6 @@
+/**
+ * SPDX-FileCopyrightText: 2026 Conduction B.V.
+ * SPDX-License-Identifier: EUPL-1.2
+ */
+
+export { default as CnMacrosWidget, default } from './CnMacrosWidget.vue'