@conduction/nextcloud-vue 2.115.0 → 2.116.0

package/l10n/en.json

@@ -1932,7 +1932,25 @@
     "no": "no",
     "Recompute nomination": "Recompute nomination",
     "Recompute": "Recompute",
-    "Task deadline": "Deadline"
+    "Task deadline": "Deadline",
+    "The note could not be recorded. It is kept here; try again.": "The note could not be recorded. It is kept here; try again.",
+    "This field is not available here.": "This field is not available here.",
+    "filled in, not recorded yet": "filled in, not recorded yet",
+    "Why are you opening this?": "Why are you opening this?",
+    "This record holds special categories of personal data. Your purpose is recorded with your name and the time.": "This record holds special categories of personal data. Your purpose is recorded with your name and the time.",
+    "Purpose": "Purpose",
+    "Describe your purpose": "Describe your purpose",
+    "State a purpose to open this": "State a purpose to open this",
+    "This record holds special categories of personal data. It opens once your purpose is recorded.": "This record holds special categories of personal data. It opens once your purpose is recorded.",
+    "State a purpose": "State a purpose",
+    "This page cannot record a purpose, so the record stays closed.": "This page cannot record a purpose, so the record stays closed.",
+    "Your purpose could not be recorded, so the record stays closed.": "Your purpose could not be recorded, so the record stays closed.",
+    "Hand back": "Hand back",
+    "Pick up": "Pick up",
+    "Task completed": "Task completed",
+    "This could not be done. Try again.": "This could not be done. Try again.",
+    "{done} of {total} done": "{done} of {total} done",
+    "Nothing to check off": "Nothing to check off"
   },
   "plurals": {
     "{count} member": [

package/l10n/nl.json

@@ -2149,7 +2149,25 @@
     "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"
+    "Execute": "Uitvoeren",
+    "The note could not be recorded. It is kept here; try again.": "De notitie kon niet worden vastgelegd. Ze blijft hier staan; probeer het opnieuw.",
+    "This field is not available here.": "Dit veld is hier niet beschikbaar.",
+    "filled in, not recorded yet": "ingevuld, nog niet vastgelegd",
+    "Why are you opening this?": "Waarom open je dit?",
+    "This record holds special categories of personal data. Your purpose is recorded with your name and the time.": "Hierin staan bijzondere persoonsgegevens. Je doel wordt vastgelegd met je naam en het tijdstip.",
+    "Purpose": "Doel",
+    "Describe your purpose": "Beschrijf je doel",
+    "State a purpose to open this": "Geef een doel op om dit te openen",
+    "This record holds special categories of personal data. It opens once your purpose is recorded.": "Hierin staan bijzondere persoonsgegevens. Het opent zodra je doel is vastgelegd.",
+    "State a purpose": "Doel opgeven",
+    "This page cannot record a purpose, so the record stays closed.": "Deze pagina kan geen doel vastleggen, dus het blijft gesloten.",
+    "Your purpose could not be recorded, so the record stays closed.": "Je doel kon niet worden vastgelegd, dus het blijft gesloten.",
+    "Hand back": "Teruggeven",
+    "Pick up": "Oppakken",
+    "Task completed": "Taak afgerond",
+    "This could not be done. Try again.": "Dit lukte niet. Probeer het opnieuw.",
+    "{done} of {total} done": "{done} van {total} klaar",
+    "Nothing to check off": "Niets af te vinken"
   },
   "plurals": {
     "{count} member": [
@@ -2279,6 +2297,10 @@
     "%n passage found. Review each one.": [
       "%n passage gevonden. Beoordeel elke passage.",
       "%n passages gevonden. Beoordeel elke passage."
+    ],
+    "{count} change: {list}": [
+      "{count} wijziging: {list}",
+      "{count} wijzigingen: {list}"
     ]
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@conduction/nextcloud-vue",
-  "version": "2.115.0",
+  "version": "2.116.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/CnActionButtons/CnActionButtons.vue

@@ -171,7 +171,7 @@
 			v-if="formEntry && formSchema && !formEntry.advanced"
 			ref="formDialog"
 			:schema="formSchema"
-			:item="null"
+			:item="formItem"
 			:register="formRegister"
 			:initialData="formInitialValues || {}"
 			:dialogTitle="tr(formEntry.formTitle) || ''"
@@ -247,6 +247,11 @@ import { CnIcon } from '../CnIcon/index.js'
  *    `excludeFields` / `fieldOverrides` narrow what the button asks for, which
  *    is how one schema serves both a full editor and a quick-create button.
  *    `advanced: true` swaps in the properties/JSON table for a power user.
+ *    With `endpoint: { url, method?, loadUrl?, responsePath? }` and
+ *    `formProperties` (JSON-schema properties) it edits a record that is not a
+ *    register object instead: it reads the record from the endpoint, shows the
+ *    declared fields filled in, and sends them back with PATCH (or PUT). With
+ *    `method: "POST"` it creates one: an empty form, posted to the endpoint.
  *  - **`toggle`** — a two-way state button: `GET`s `stateSource` on mount,
  *    renders `labelOn` / `labelOff`, and on click `writes` the flipped
  *    value OPTIMISTICALLY, reverting on failure.
@@ -428,6 +433,8 @@ export default {
 			formEntry: null,
 			/** The fetched schema object for the open-form dialog (null until loaded). */
 			formSchema: null,
+			/** The record an endpoint form edits (null for a create form). */
+			formItem: null,
 			/** The run-node action currently in flight / showing its dialog (null = closed). */
 			runNodeEntry: null,
 			/** The target node's declared config-form fields, from the describe GET. */
@@ -993,6 +1000,11 @@ export default {
 		async openForm(entry) {
 			this.formEntry = entry
 			this.formSchema = null
+			this.formItem = null
+			if (entry.endpoint && typeof entry.endpoint.url === 'string' && entry.endpoint.url !== '') {
+				await this.openEndpointForm(entry)
+				return
+			}
 			const register = entry.register || this.objectCtx.register || ''
 			const schema = entry.schema || ''
 			if (!schema) {
@@ -1015,6 +1027,81 @@ export default {
 			}
 		},
 
+		/**
+		 * Open an `open-form` action with an `endpoint` as an edit form over a
+		 * record that is not a register object (an OpenRegister organisation):
+		 * the fields are the action's `formProperties`, the values are read from
+		 * `endpoint.loadUrl` (else `endpoint.url`) at `endpoint.responsePath`,
+		 * and the save sends the changed fields to `endpoint.url`. A failed
+		 * read toasts and opens nothing.
+		 *
+		 * @param {object} entry The open-form action with `endpoint` and `formProperties`.
+		 * @return {Promise<void>}
+		 * @spec openspec/changes/open-form-endpoint/specs/open-form-endpoint/spec.md#requirement-an-open-form-action-can-edit-a-record-through-an-endpoint
+		 */
+		async openEndpointForm(entry) {
+			const properties = entry.formProperties && typeof entry.formProperties === 'object' && !Array.isArray(entry.formProperties) ? entry.formProperties : {}
+			if (String(entry.endpoint.method || '').toUpperCase() === 'POST') {
+				this.formSchema = { type: 'object', properties }
+				return
+			}
+			const loadUrl = entry.endpoint.loadUrl || entry.endpoint.url
+			const record = await fetchEndpointSource({ url: loadUrl, responsePath: entry.endpoint.responsePath || '' }, this.tokenCtx, { force: true })
+				.catch(() => null)
+			if (!record || typeof record !== 'object') {
+				const { showError } = await import('@nextcloud/dialogs')
+				if (typeof showError === 'function') {
+					showError(t('nextcloud-vue', 'Could not open the form.'))
+				}
+				this.formEntry = null
+				return
+			}
+			this.formItem = record
+			this.formSchema = { type: 'object', properties }
+		},
+
+		/**
+		 * Save an endpoint form: send the declared fields to `endpoint.url`
+		 * with `endpoint.method` (`PATCH` by default, or `PUT`), then toast and
+		 * refresh the page as an object save does.
+		 *
+		 * @param {object} entry The open-form action.
+		 * @param {object} formData The form's values.
+		 * @return {Promise<void>}
+		 * @spec openspec/changes/open-form-endpoint/specs/open-form-endpoint/spec.md#requirement-an-open-form-action-can-edit-a-record-through-an-endpoint
+		 */
+		async saveEndpointForm(entry, formData) {
+			const dialog = this.$refs.formDialog
+			const keys = Object.keys(this.formSchema?.properties || {})
+			const body = Object.fromEntries(keys.filter((key) => key in formData).map((key) => [key, formData[key]]))
+			const verb = String(entry.endpoint.method || 'PATCH').toUpperCase()
+			const method = verb === 'PUT' ? 'put' : (verb === 'POST' ? 'post' : 'patch')
+			try {
+				const [{ default: axios }, { generateUrl }] = await Promise.all([
+					import('@nextcloud/axios'),
+					import('@nextcloud/router'),
+				])
+				const url = interpolateActionTarget(entry.endpoint.url, this.tokenCtx)
+				const response = await axios[method](/^https?:\/\//i.test(url) ? url : generateUrl(url), body)
+				if (dialog && typeof dialog.setResult === 'function') {
+					dialog.setResult({ success: true })
+				}
+				const { showSuccess } = await import('@nextcloud/dialogs')
+				if (typeof showSuccess === 'function') {
+					showSuccess(this.tr(entry.successMessage) || t('nextcloud-vue', 'Saved.'))
+				}
+				const { emit } = await import('@nextcloud/event-bus')
+				emit('cn:page:refresh', {})
+				this.$emit('created', response && response.data)
+			} catch (error) {
+				const serverMessage = error && error.response && error.response.data
+					&& (error.response.data.error || error.response.data.message)
+				if (dialog && typeof dialog.setResult === 'function') {
+					dialog.setResult({ error: serverMessage || this.tr(entry.errorMessage) || t('nextcloud-vue', 'Save failed.') })
+				}
+			}
+		},
+
 		/**
 		 * Open (or skip) the `run-node` config dialog: GET the target node's
 		 * describe endpoint (`or-flow-run-node`'s `GET .../{flowId}/{nodeId}/run`),
@@ -1125,6 +1212,10 @@ export default {
 		 */
 		async onFormConfirm(formData, dynamic = null) {
 			const entry = this.formEntry
+			if (entry && entry.endpoint) {
+				await this.saveEndpointForm(entry, formData)
+				return
+			}
 			const dialog = this.$refs.formDialog
 			const register = this.formRegister
 			const schema = (entry && entry.schema) || ''
@@ -1267,6 +1358,7 @@ export default {
 		closeForm() {
 			this.formEntry = null
 			this.formSchema = null
+			this.formItem = null
 		},
 	},
 }

package/src/components/CnChecklistWidget/CnChecklistWidget.vue

@@ -0,0 +1,206 @@
+<!--
+  - SPDX-FileCopyrightText: 2026 Conduction B.V.
+  - SPDX-License-Identifier: EUPL-1.2
+-->
+
+<template>
+	<div class="cn-checklist-widget" data-testid="cn-checklist-widget">
+		<p v-if="items.length === 0" class="cn-checklist-widget__muted" data-testid="cn-checklist-empty">
+			{{ emptyLabel }}
+		</p>
+		<template v-else>
+			<p class="cn-checklist-widget__summary" data-testid="cn-checklist-summary">
+				{{ summary }}
+			</p>
+			<ul class="cn-checklist-widget__items">
+				<li v-for="item in items" :key="item.id" class="cn-checklist-widget__item">
+					<NcCheckboxRadioSwitch
+						:modelValue="item.checked"
+						:disabled="!writable || busy"
+						:data-testid="`cn-checklist-item-${item.id}`"
+						@update:modelValue="toggle(item, $event)">
+						{{ item.label }}
+					</NcCheckboxRadioSwitch>
+					<p v-if="item.description" class="cn-checklist-widget__description">
+						{{ item.description }}
+					</p>
+				</li>
+			</ul>
+		</template>
+	</div>
+</template>
+
+<script>
+import { translate as t } from '@nextcloud/l10n'
+import { NcCheckboxRadioSwitch } from '@nextcloud/vue'
+import { readPath } from '../../utils/readPath.js'
+
+/**
+ * CnChecklistWidget — the checklist a record carries, ticked in place.
+ *
+ * The items are read off the record in view (`content.path`, `checklist` by
+ * default), each `{ id, label, description, checked }` unless `content`
+ * names other fields. A tick is written through the detail page's record
+ * source (`cnRecordChecklist`, provided by CnDetailPage when its source can
+ * check items, as the `tasks` source does through the task engine). The box
+ * follows the record the write answers with, so a refused tick leaves the
+ * item as it was. Without a source that can write, or on a record the source
+ * says can no longer be ticked, the list is read-only.
+ *
+ * An item without an id is left out: the write addresses an item by its id,
+ * and a box that cannot be saved would look saved.
+ */
+export default {
+	name: 'CnChecklistWidget',
+
+	components: { NcCheckboxRadioSwitch },
+
+	inject: {
+		cnTranslate: { default: () => (key) => key },
+		cnObjectContext: { default: null },
+		cnRecordChecklist: { default: null },
+	},
+
+	props: {
+		/**
+		 * The widget configuration: `path` (where the items sit on the record,
+		 * default `checklist`), `idField` / `labelField` / `descriptionField` /
+		 * `checkedField` (default `id`, `label`, `description`, `checked`),
+		 * `emptyText` (shown when the record carries no items).
+		 */
+		content: {
+			type: Object,
+			default: () => ({}),
+		},
+
+		/** The record in view, as the detail page hands it to a widget. */
+		objectData: {
+			type: Object,
+			default: null,
+		},
+	},
+
+	data() {
+		return {
+			/** Whether a tick is being written, so two cannot cross. */
+			busy: false,
+		}
+	},
+
+	computed: {
+		/**
+		 * The record: the prop, else the page's injected context.
+		 *
+		 * @return {object|null}
+		 */
+		record() {
+			if (this.objectData) {
+				return this.objectData
+			}
+			const context = this.cnObjectContext
+			const value = context && typeof context === 'object' && 'value' in context ? context.value : context
+			return value?.object || null
+		},
+
+		/**
+		 * The items, normalised, without the ones that have no id.
+		 *
+		 * @return {Array<{id: string, label: string, description: string, checked: boolean}>}
+		 */
+		items() {
+			const content = this.content || {}
+			const list = this.record ? readPath(this.record, content.path || 'checklist') : null
+			if (!Array.isArray(list)) {
+				return []
+			}
+			return list
+				.filter((item) => item && typeof item === 'object' && String(item[content.idField || 'id'] ?? '').trim() !== '')
+				.map((item) => {
+					const id = String(item[content.idField || 'id']).trim()
+					return {
+						id,
+						label: String(item[content.labelField || 'label'] ?? '').trim() || id,
+						description: String(item[content.descriptionField || 'description'] ?? '').trim(),
+						checked: item[content.checkedField || 'checked'] === true,
+					}
+				})
+		},
+
+		/**
+		 * "2 of 4 done".
+		 *
+		 * @return {string}
+		 */
+		summary() {
+			const done = this.items.filter((item) => item.checked).length
+			return t('nextcloud-vue', '{done} of {total} done', { done, total: this.items.length })
+		},
+
+		/**
+		 * Whether a tick can be written for this record.
+		 *
+		 * @return {boolean}
+		 */
+		writable() {
+			return Boolean(this.cnRecordChecklist && this.cnRecordChecklist.canCheck === true)
+		},
+
+		/** @return {string} The empty text, through the app's catalogue. */
+		emptyLabel() {
+			const text = this.content?.emptyText
+			return typeof text === 'string' && text !== '' ? this.cnTranslate(text) : t('nextcloud-vue', 'Nothing to check off')
+		},
+	},
+
+	methods: {
+		/**
+		 * Write one tick through the page's record source.
+		 *
+		 * @param {{id: string}} item The item.
+		 * @param {boolean} checked The new state.
+		 * @return {Promise<void>}
+		 */
+		async toggle(item, checked) {
+			if (!this.writable || this.busy) {
+				return
+			}
+			this.busy = true
+			try {
+				await this.cnRecordChecklist.check(item.id, checked === true)
+			} finally {
+				this.busy = false
+			}
+		},
+	},
+}
+</script>
+
+<style scoped>
+.cn-checklist-widget {
+	display: flex;
+	flex-direction: column;
+	gap: 8px;
+	min-width: 0;
+}
+
+.cn-checklist-widget__summary,
+.cn-checklist-widget__muted {
+	margin: 0;
+	color: var(--color-text-maxcontrast);
+}
+
+.cn-checklist-widget__items {
+	margin: 0;
+	padding: 0;
+	list-style: none;
+}
+
+.cn-checklist-widget__item {
+	min-width: 0;
+}
+
+.cn-checklist-widget__description {
+	margin: 0 0 4px 36px;
+	color: var(--color-text-maxcontrast);
+}
+</style>

package/src/components/CnChecklistWidget/index.js

@@ -0,0 +1,27 @@
+/**
+ * SPDX-FileCopyrightText: 2026 Conduction B.V.
+ * SPDX-License-Identifier: EUPL-1.2
+ *
+ * CnChecklistWidget — self-registers the `checklist` widget type (the
+ * checklist a record carries, ticked in place through the page's record
+ * source) into the shared dashboardWidgetRegistry at module load. Renderer
+ * only: the items come from the record, so the Add-widget picker does not
+ * offer it.
+ */
+
+import CnChecklistWidget from './CnChecklistWidget.vue'
+import { registerDashboardWidget } from '../CnWidgetGrid/dashboardWidgetRegistry.js'
+
+registerDashboardWidget('checklist', {
+	renderer: CnChecklistWidget,
+	form: null,
+	defaultContent: {
+		path: 'checklist',
+	},
+	displayName: 'Checklist',
+	icon: 'CheckboxMarkedOutline',
+	surfaces: ['detail-page'],
+})
+
+export { CnChecklistWidget }
+export default CnChecklistWidget

package/src/components/CnDashboardPage/CnDashboardPage.vue

@@ -37,7 +37,7 @@
 				<CnHeaderTrail
 					:breadcrumb="breadcrumb"
 					:current="title ? resolvedTitle : ''"
-					:meta="headerMeta ? effectiveTranslate(headerMeta) : ''" />
+					:meta="resolvedHeaderMeta" />
 				<!-- `dateRange.placement: "description"`: the segmented period
 				     group ends the description line ("Week 41 · alle teams ·
 				     [Deze week | Dit kwartaal | Dit jaar]"). -->
@@ -2178,6 +2178,31 @@ export default {
 		 * @spec openspec/changes/dashboard-greeting-label/specs/dashboard-page/spec.md#requirement-the-header-subtitle-can-lead-with-a-label-or-the-date
 		 * @return {string}
 		 */
+		/**
+		 * `headerMeta` through the host translate, with `{today}` written out as
+		 * today's date (DqDagAfsluiten "Dag afsluiten, woensdag 7 oktober").
+		 *
+		 * @spec openspec/changes/record-list-notes/specs/record-list-notes/spec.md#requirement-a-dashboard-header-meta-can-name-today
+		 * @return {string}
+		 */
+		resolvedHeaderMeta() {
+			if (!this.headerMeta) {
+				return ''
+			}
+			const meta = this.effectiveTranslate(this.headerMeta)
+			if (!meta.includes('{today}')) {
+				return meta
+			}
+			const options = { weekday: 'long', day: 'numeric', month: 'long' }
+			let today
+			try {
+				today = new Intl.DateTimeFormat(getCanonicalLocale() || undefined, options).format(new Date())
+			} catch {
+				today = new Intl.DateTimeFormat(undefined, options).format(new Date())
+			}
+			return meta.split('{today}').join(today)
+		},
+
 		subtitleText() {
 			const description = this.description ? this.resolvedDescription : ''
 			const dateOnly = this.greeting === 'date'

package/src/components/CnDetailPage/CnDetailPage.md

@@ -428,6 +428,8 @@ Four levels of action and the case surfaces around them. All opt in. See [the re
 | `sideColumn` | Array | `[]` | Widget definitions or widget ids, rendered as a column of cards beside the body. An entry with `tabs` shows only while one of those body tabs is open. |
 | `sideColumnFrom` | String | `''` | A field path, read like a `visibleWhen` field (e.g. `@context.caseType.sideCards`), whose list of ids picks the `sideColumn` entries this record shows and their order. Any other value keeps `sideColumn` as declared. |
 | `tabsFrom` | String | `''` | A field path, read like a `visibleWhen` field, whose list of tab ids picks the tabs of the page's `tabs` widgets and their order for this record: `@context.caseType.tabs` reads the list a case type keeps (DqAanbesteding: Inschrijvingen, Publicaties, Bestanden, Historie). A tab's id is its `id`, else its `widgetId`, or the string entry. An empty or missing list keeps the declared tabs; edit mode shows them all. |
+| `verbEndpoints` | Object | `null` | App routes that replace a record source's own route for a verb, by verb id (manifest `config.verbEndpoints`), such as `{ "complete": "/apps/dossiq/api/case-tasks/{id}/complete" }` for an app that checks something of its own before the engine completes the task. `{id}` is the record id. Only read with `entitySource`. |
+| `accessPurpose` | Object | `null` | Ask for a purpose before the record opens (manifest `config.accessPurpose`): `{ when, options, url, title?, description? }`. `when` is a `visibleWhen` condition on the record and its `visibilityContext` records; `options` are the purposes offered (`{ value, label }`; "Other" with a written purpose is always added); `url` is the app endpoint that records the purpose (POST `{ purpose, note }`, `{objectId}` filled in). Nothing of the record shows until the endpoint accepts, and the same record is not asked again in the same browser session. A refusal keeps the record closed. `null` asks nothing. |
 | `isAdmin` | Boolean \| null | `null` | Shows `adminOnly` header actions. `null` reads it from Nextcloud. |
 
 ## The record as a place