@conduction/nextcloud-vue 2.108.0 → 2.110.0

package/src/components/CnNcDashboardList/index.js

@@ -0,0 +1,12 @@
+/**
+ * SPDX-FileCopyrightText: 2026 Conduction B.V.
+ * SPDX-License-Identifier: EUPL-1.2
+ *
+ * CnNcDashboardList — the compact list a Nextcloud Dashboard widget shows,
+ * read from OpenRegister or an endpoint.
+ */
+
+import CnNcDashboardList from './CnNcDashboardList.vue'
+
+export { CnNcDashboardList }
+export default CnNcDashboardList

package/src/components/CnObjectListWidget/CnObjectListWidget.vue

@@ -286,20 +286,20 @@
 			data-testid="object-list-upload-input"
 			@change="onUploadFilesSelected">
 		<CnFormDialog
-			v-if="showCreate && createSchema"
+			v-if="(showCreate || editingRow) && createSchema"
 			ref="createDialog"
 			:schema="createSchema"
-			:item="null"
+			:item="editingRow"
 			:register="content.register || ''"
-			:initialData="createInitialData"
+			:initialData="editingRow ? null : createInitialData"
 			:lockedFields="createLockedFields"
 			:size="formSize"
 			:columns="formColumns"
 			:includeFields="formIncludeFields"
 			:excludeFields="formExcludeFields"
 			:fieldOverrides="formFieldOverrides"
-			@confirm="onCreateConfirm"
-			@close="showCreate = false" />
+			@confirm="editingRow ? onEditConfirm($event) : onCreateConfirm($event)"
+			@close="closeForm" />
 	</div>
 </template>
 
@@ -320,6 +320,7 @@ import { objectDisplayName, objectFieldValue } from '../../utils/objectName.js'
 import { moveIndex, renumberRows, rowIdOf } from '../../utils/reorderRows.js'
 import { dropOptionalUnresolved, hasUnresolvedTokens, resolveFilterTokens } from '../../utils/resolveFilterTokens.js'
 import { markNewTabHandled } from '../../utils/rowAuxClick.js'
+import { changedKeys } from '../../utils/saveEdited.js'
 import { dispatchObjectCreated } from '../../utils/walkthroughSignals.js'
 import { CnRowActions } from '../CnRowActions/index.js'
 
@@ -458,7 +459,7 @@ export default {
 		},
 	},
 
-	emits: ['created', 'row-click', 'row-aux-click', 'view-all', 'files-dropped'],
+	emits: ['created', 'updated', 'row-click', 'row-aux-click', 'view-all', 'files-dropped'],
 
 	data() {
 		return {
@@ -484,6 +485,8 @@ export default {
 			fitStage: 0,
 			/** Whether the create dialog is open. */
 			showCreate: false,
+			/** The row the form edits (`content.editable`), or null while it creates. */
+			editingRow: null,
 			/**
 			 * The list's own schema definition, once fetched.
 			 *
@@ -732,6 +735,12 @@ export default {
 					...this.rowActionLink(action),
 					handler: (row) => this.runRowAction(action, row),
 				}))
+			if (this.content.editable === true) {
+				mapped.unshift({ label: t('nextcloud-vue', 'Edit'), icon: 'Pencil', handler: (row) => this.openEdit(row) })
+			}
+			if (this.content.deletable === true) {
+				mapped.push({ label: t('nextcloud-vue', 'Delete'), icon: 'TrashCanOutline', destructive: true, handler: (row) => this.deleteRow(row) })
+			}
 			if (this.reorderField === '') {
 				return mapped
 			}
@@ -1546,6 +1555,7 @@ export default {
 		forgetCreateSchema() {
 			this.createSchema = null
 			this.showCreate = false
+			this.editingRow = null
 		},
 
 		/**
@@ -1556,6 +1566,97 @@ export default {
 		 *
 		 * @return {Promise<void>}
 		 */
+		/**
+		 * Edit a row in the list's own form (`content.editable`): the form the
+		 * Add button opens, filled with the row.
+		 *
+		 * @param {object} row The row.
+		 * @return {Promise<void>}
+		 * @spec openspec/changes/object-list-edit-in-place/specs/object-list-widget/spec.md#requirement-a-list-can-edit-a-row-in-its-own-form
+		 */
+		async openEdit(row) {
+			try {
+				await this.ensureSchema()
+				this.showCreate = false
+				this.editingRow = row ? { ...row } : null
+			} catch (e) {
+				this.error = (e && e.message) || 'error'
+			}
+		},
+
+		/**
+		 * Delete a row of the list's own schema (`content.deletable`). The
+		 * toast offers Undo; a refusal toasts the server's message.
+		 *
+		 * @param {object} row The row.
+		 * @return {Promise<void>}
+		 * @spec openspec/changes/object-list-edit-in-place/specs/object-list-widget/spec.md#requirement-a-list-can-edit-a-row-in-its-own-form
+		 */
+		async deleteRow(row) {
+			const c = this.content || {}
+			const id = rowIdOf(row)
+			if (id === '') {
+				return
+			}
+			const pending = (async () => {
+				const [{ default: axios }, { generateUrl }] = await Promise.all([import('@nextcloud/axios'), import('@nextcloud/router')])
+				try {
+					await axios.delete(generateUrl('/apps/openregister/api/objects/{register}/{schema}/{id}', { register: c.register, schema: c.schema, id }))
+				} catch (e) {
+					const data = e && e.response && e.response.data
+					const refusal = data && (data.message || data.error)
+					throw new Error((typeof refusal === 'string' && refusal) || (e && e.message) || t('nextcloud-vue', 'The delete failed'), { cause: e })
+				}
+				return true
+			})()
+			await this.reportDelete(row, pending)
+			await pending.catch(() => {})
+			this.fetchRows()
+		},
+
+		/** Close the form, whether it created or edited. */
+		closeForm() {
+			this.showCreate = false
+			this.editingRow = null
+		},
+
+		/**
+		 * Save an edited row: a PATCH of the keys the form changed, so every
+		 * key it does not show keeps its stored value; nothing when nothing
+		 * changed. A refusal shows the server's message in the dialog.
+		 *
+		 * @param {object} formData The edited values.
+		 * @return {Promise<void>}
+		 * @spec openspec/changes/object-list-edit-in-place/specs/object-list-widget/spec.md#requirement-a-list-can-edit-a-row-in-its-own-form
+		 */
+		async onEditConfirm(formData) {
+			const c = this.content || {}
+			const row = this.editingRow
+			const id = rowIdOf(row)
+			const changes = changedKeys(row, formData)
+			try {
+				if (id !== '' && Object.keys(changes).length > 0) {
+					const [{ default: axios }, { generateUrl }] = await Promise.all([import('@nextcloud/axios'), import('@nextcloud/router')])
+					await axios.patch(generateUrl('/apps/openregister/api/objects/{register}/{schema}/{id}', { register: c.register, schema: c.schema, id }), changes)
+				}
+				if (this.$refs.createDialog) {
+					this.$refs.createDialog.setResult({ success: true })
+				}
+				/**
+				 * @event updated Emitted after a row was edited, with the keys that changed.
+				 * @type {object}
+				 */
+				this.$emit('updated', { id, changes })
+				this.fetchRows()
+			} catch (e) {
+				const data = e && e.response && e.response.data
+				const refusal = data && (data.message || data.error)
+				if (this.$refs.createDialog) {
+					this.$refs.createDialog.setResult({ error: (typeof refusal === 'string' && refusal) || (e && e.message) || 'error' })
+				}
+			}
+		},
+
 		async openCreate() {
 			const c = this.content || {}
 			if (!c.schema) {

package/src/components/CnPlanWidget/CnPlanWidget.vue

@@ -0,0 +1,246 @@
+<!--
+  - SPDX-FileCopyrightText: 2026 Conduction B.V.
+  - SPDX-License-Identifier: EUPL-1.2
+-->
+<template>
+	<div class="cn-plan" data-testid="cn-plan">
+		<NcLoadingIcon v-if="loading" :size="24" />
+		<NcEmptyContent v-else-if="error"
+			:name="t('nextcloud-vue', 'The plan is unavailable')"
+			:description="error"
+			data-testid="cn-plan-error">
+			<template #action>
+				<NcButton data-testid="cn-plan-retry" @click="load">
+					{{ t('nextcloud-vue', 'Try again') }}
+				</NcButton>
+			</template>
+		</NcEmptyContent>
+		<ul v-else-if="roots.length > 0" class="cn-plan__tree">
+			<li v-for="node in roots" :key="node.uuid" class="cn-plan__node">
+				<CnPlanWidgetRow :item="node"
+					:busy="busy"
+					@enable="enable"
+					@transition="transition" />
+				<ul v-if="node.children.length > 0" class="cn-plan__children">
+					<li v-for="child in node.children" :key="child.uuid" class="cn-plan__node">
+						<CnPlanWidgetRow :item="child"
+							:busy="busy"
+							@enable="enable"
+							@transition="transition" />
+					</li>
+				</ul>
+			</li>
+		</ul>
+		<p v-else class="cn-plan__empty" data-testid="cn-plan-empty">
+			{{ text(content.emptyText) || t('nextcloud-vue', 'This record has no plan') }}
+		</p>
+	</div>
+</template>
+
+<script>
+import axios from '@nextcloud/axios'
+import { emit, subscribe, unsubscribe } from '@nextcloud/event-bus'
+import { translate as t } from '@nextcloud/l10n'
+import { generateUrl } from '@nextcloud/router'
+import { NcButton, NcEmptyContent, NcLoadingIcon } from '@nextcloud/vue'
+import CnPlanWidgetRow from './CnPlanWidgetRow.vue'
+import { planTree } from '../../utils/planTree.js'
+
+/** The page refresh channel the built-in widgets listen on. */
+const PAGE_REFRESH = 'cn:page:refresh'
+
+/**
+ * CnPlanWidget — the `plan` detail widget: a record's planned steps (stages,
+ * tasks and milestones) as OpenRegister's case layer holds them, read from
+ * `/api/cases/{id}`, with the moves OpenRegister allows: start a
+ * discretionary item, complete or terminate one. It judges nothing:
+ * OpenRegister decides every move and its refusal is shown as it says it.
+ * A 404 means the record has no plan; any other failure is an error with a
+ * retry, never an empty plan. Any app whose records run on OpenRegister's
+ * case layer uses it; dossiq's case plan is the first.
+ *
+ * `content`: `emptyText`, through the host translate.
+ *
+ * The record's id comes from `objectId`, else the bound record.
+ */
+export default {
+	name: 'CnPlanWidget',
+
+	components: { CnPlanWidgetRow, NcButton, NcEmptyContent, NcLoadingIcon },
+
+	inject: {
+		/** The host app's translate (CnAppRoot `cnTranslate`). */
+		cnTranslate: { default: () => (key) => key },
+	},
+
+	props: {
+		/**
+		 * The widget's configuration: `{ emptyText? }`.
+		 *
+		 * @type {object}
+		 */
+		content: {
+			type: Object,
+			default: () => ({}),
+		},
+
+		/**
+		 * The bound record, on a detail page.
+		 *
+		 * @type {object|null}
+		 */
+		objectData: {
+			type: Object,
+			default: null,
+		},
+
+		/** The record's id (else the bound record's). */
+		objectId: {
+			type: [String, Number],
+			default: '',
+		},
+	},
+
+	data() {
+		return {
+			loading: true,
+			busy: false,
+			error: '',
+			roots: [],
+		}
+	},
+
+	computed: {
+		/** @return {string} The record id. */
+		id() {
+			const bound = this.objectData || {}
+			return String(this.objectId || bound.id || (bound['@self'] && bound['@self'].id) || '')
+		},
+	},
+
+	mounted() {
+		subscribe(PAGE_REFRESH, this.load)
+		this.load()
+	},
+
+	beforeUnmount() {
+		unsubscribe(PAGE_REFRESH, 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) : ''
+		},
+
+		/**
+		 * The server's sentence for a failure.
+		 *
+		 * @param {unknown} failure The rejection.
+		 * @return {string}
+		 */
+		messageOf(failure) {
+			const response = failure && failure.response
+			if (response && response.status === 403) {
+				return t('nextcloud-vue', 'You are not allowed to see this plan.')
+			}
+			const body = response && response.data
+			const detail = body && (body.error || body.message)
+			return typeof detail === 'string' && detail !== '' ? detail : t('nextcloud-vue', 'The plan could not be loaded. Try again.')
+		},
+
+		/**
+		 * Read the plan; 404 is "no plan", anything else an error.
+		 *
+		 * @spec openspec/changes/plan-widget/specs/plan-widget/spec.md#requirement-a-record-shows-its-planned-steps
+		 * @return {Promise<void>}
+		 */
+		async load() {
+			if (!this.id) {
+				this.loading = false
+				return
+			}
+			this.loading = true
+			this.error = ''
+			try {
+				const { data } = await axios.get(generateUrl(`/apps/openregister/api/cases/${encodeURIComponent(this.id)}`))
+				this.roots = data && Array.isArray(data.items) ? planTree(data.items) : []
+			} catch (failure) {
+				this.roots = []
+				if (!(failure && failure.response && failure.response.status === 404)) {
+					this.error = this.messageOf(failure)
+				}
+			} finally {
+				this.loading = false
+			}
+		},
+
+		/**
+		 * Start a discretionary item.
+		 *
+		 * @param {object} item The plan item.
+		 * @return {Promise<void>}
+		 */
+		enable(item) {
+			return this.act(() => axios.post(generateUrl(`/apps/openregister/api/cases/items/${encodeURIComponent(item.uuid)}/enable`), {}))
+		},
+
+		/**
+		 * Move an item to a target state.
+		 *
+		 * @param {object} item The plan item.
+		 * @param {string} to The target state.
+		 * @return {Promise<void>}
+		 */
+		transition(item, to) {
+			return this.act(() => axios.post(generateUrl(`/apps/openregister/api/cases/items/${encodeURIComponent(item.uuid)}/transition`), { to, reason: '' }))
+		},
+
+		/**
+		 * Run one move, then read the plan again: a move can cascade, so the
+		 * next read is the plan, not the write's answer.
+		 *
+		 * @spec openspec/changes/plan-widget/specs/plan-widget/spec.md#requirement-a-record-shows-its-planned-steps
+		 * @param {() => Promise<unknown>} write The move.
+		 * @return {Promise<void>}
+		 */
+		async act(write) {
+			this.busy = true
+			try {
+				await write()
+				await this.load()
+				emit(PAGE_REFRESH, {})
+			} catch (failure) {
+				this.error = this.messageOf(failure)
+			} finally {
+				this.busy = false
+			}
+		},
+	},
+}
+</script>
+
+<style scoped>
+.cn-plan__tree,
+.cn-plan__children {
+	margin: 0;
+	padding: 0;
+	list-style: none;
+}
+
+.cn-plan__children {
+	padding-inline-start: 24px;
+}
+
+.cn-plan__empty {
+	margin: 0;
+	color: var(--color-text-maxcontrast);
+}
+</style>

package/src/components/CnPlanWidget/CnPlanWidgetRow.vue

@@ -0,0 +1,117 @@
+<!--
+  - SPDX-FileCopyrightText: 2026 Conduction B.V.
+  - SPDX-License-Identifier: EUPL-1.2
+-->
+<template>
+	<div class="cn-plan-row" :data-testid="`cn-plan-row-${item.key || item.uuid}`">
+		<span class="cn-plan-row__name">{{ item.name }}</span>
+		<span class="cn-plan-row__state" :data-state="item.state">{{ stateLabel(item.state) }}</span>
+		<NcButton v-if="item.state === 'enabled' && item.discretionary"
+			:disabled="busy"
+			:data-testid="`cn-plan-enable-${item.key || item.uuid}`"
+			@click="$emit('enable', item)">
+			{{ t('nextcloud-vue', 'Start') }}
+		</NcButton>
+		<NcButton v-for="target in targets"
+			:key="target"
+			:disabled="busy"
+			:data-testid="`cn-plan-${target}-${item.key || item.uuid}`"
+			@click="$emit('transition', item, target)">
+			{{ target === 'completed' ? t('nextcloud-vue', 'Complete') : t('nextcloud-vue', 'Stop') }}
+		</NcButton>
+	</div>
+</template>
+
+<script>
+import { translate as t } from '@nextcloud/l10n'
+import { NcButton } from '@nextcloud/vue'
+import { offeredTransitions } from '../../utils/planTree.js'
+
+/**
+ * One plan item in CnPlanWidget: its name, its state and the moves offered.
+ */
+export default {
+	name: 'CnPlanWidgetRow',
+
+	components: { NcButton },
+
+	props: {
+		/**
+		 * The plan item (`uuid`, `key`, `name`, `state`, `type`, `discretionary`).
+		 *
+		 * @type {object}
+		 */
+		item: {
+			type: Object,
+			required: true,
+		},
+
+		/** A move is running. */
+		busy: {
+			type: Boolean,
+			default: false,
+		},
+	},
+
+	emits: ['enable', 'transition'],
+
+	computed: {
+		/** @return {string[]} The moves offered. */
+		targets() {
+			return offeredTransitions(this.item)
+		},
+	},
+
+	methods: {
+		t,
+
+		/**
+		 * The word for a state.
+		 *
+		 * @param {string} state The state.
+		 * @return {string}
+		 */
+		stateLabel(state) {
+			const labels = {
+				available: t('nextcloud-vue', 'Waiting'),
+				enabled: t('nextcloud-vue', 'Can start'),
+				active: t('nextcloud-vue', 'In progress'),
+				completed: t('nextcloud-vue', 'Done'),
+				terminated: t('nextcloud-vue', 'Stopped'),
+				disabled: t('nextcloud-vue', 'Not needed'),
+			}
+			return labels[state] || String(state || '')
+		},
+	},
+}
+</script>
+
+<style scoped>
+.cn-plan-row {
+	display: flex;
+	flex-wrap: wrap;
+	align-items: center;
+	gap: 8px;
+	padding-block: 6px;
+}
+
+.cn-plan-row__name {
+	flex: 1 1 auto;
+	font-weight: 600;
+}
+
+.cn-plan-row__state {
+	padding: 2px 10px;
+	border-radius: 12px;
+	background: var(--color-background-dark);
+	font-size: 13px;
+}
+
+.cn-plan-row__state[data-state='active'] {
+	background: var(--color-primary-element-light);
+}
+
+.cn-plan-row__state[data-state='completed'] {
+	color: var(--color-success-text, var(--color-success));
+}
+</style>

package/src/components/CnPlanWidget/index.js

@@ -0,0 +1,12 @@
+/**
+ * SPDX-FileCopyrightText: 2026 Conduction B.V.
+ * SPDX-License-Identifier: EUPL-1.2
+ *
+ * CnPlanWidget — the `plan` detail widget: a record's planned steps from
+ * OpenRegister's case layer, with the moves OpenRegister allows.
+ */
+
+import CnPlanWidget from './CnPlanWidget.vue'
+
+export { CnPlanWidget }
+export default CnPlanWidget