@conduction/nextcloud-vue 2.97.0 → 2.99.0

package/src/components/CnWorkingCalendarWidget/index.js

@@ -0,0 +1,26 @@
+/**
+ * SPDX-FileCopyrightText: 2026 Conduction B.V.
+ * SPDX-License-Identifier: EUPL-1.2
+ *
+ * CnWorkingCalendarWidget — self-registers the `working-calendar` widget type
+ * (one month of a working calendar kept as an OpenRegister object, with its
+ * closed dates and Add day) into the shared dashboardWidgetRegistry at module
+ * load. Renderer only: the calendar object is named in the manifest.
+ */
+
+import CnWorkingCalendarWidget from './CnWorkingCalendarWidget.vue'
+import { registerDashboardWidget } from '../CnWidgetGrid/dashboardWidgetRegistry.js'
+
+registerDashboardWidget('working-calendar', {
+	renderer: CnWorkingCalendarWidget,
+	form: null,
+	defaultContent: {
+		calendar: { register: 'flow-timers', schema: 'working-calendar', filter: {} },
+	},
+	displayName: 'Working calendar',
+	icon: 'CalendarMonthOutline',
+	surfaces: ['app-dashboard', 'detail-page'],
+})
+
+export { CnWorkingCalendarWidget }
+export default CnWorkingCalendarWidget

package/src/components/index.js

@@ -13,6 +13,8 @@ export { CnStatusBadge } from './CnStatusBadge/index.js'
 export { CnPagination } from './CnPagination/index.js'
 export { CnSettingsCard } from './CnSettingsCard/index.js'
 export { CnSettingsSection } from './CnSettingsSection/index.js'
+export { CnSettingsField } from './CnSettingsField/index.js'
+export { CnSettingsFieldsSection } from './CnSettingsFieldsSection/index.js'
 export { CnLeafDependencySettings } from './CnLeafDependencySettings/index.js'
 export { CnStatsBlock } from './CnStatsBlock/index.js'
 export { CnStructuredDocReview } from './CnStructuredDocReview/index.js'
@@ -27,6 +29,7 @@ export { CnCardGrid } from './CnCardGrid/index.js'
 export { CnDateAxisView } from './CnDateAxisView/index.js'
 export { CnObjectRow } from './CnObjectRow/index.js'
 export { CnObjectList } from './CnObjectList/index.js'
+export { CnOrderedListField } from './CnOrderedListField/index.js'
 export { CnObjectKanban } from './CnObjectKanban/index.js'
 export { CnObjectCalendar } from './CnObjectCalendar/index.js'
 export { CnFolderTree } from './CnFolderTree/index.js'
@@ -221,6 +224,8 @@ export { CnTasksWidgetForm } from './CnTasksWidgetForm/index.js'
 export { CnSectionsWidget } from './CnSectionsWidget/index.js'
 export { CnFactsWidget } from './CnFactsWidget/index.js'
 export { CnDeviceFramesWidget } from './CnDeviceFramesWidget/index.js'
+export { CnChecklistRunWidget } from './CnChecklistRunWidget/index.js'
+export { CnWorkingCalendarWidget } from './CnWorkingCalendarWidget/index.js'
 export { CnPartyActionsWidget } from './CnPartyActionsWidget/index.js'
 export { CnFieldListWidget } from './CnFieldListWidget/index.js'
 export { CnSettingsFormWidget } from './CnSettingsFormWidget/index.js'

package/src/composables/indexSources.js

@@ -3,7 +3,7 @@
  * SPDX-FileCopyrightText: 2026 Conduction B.V. <info@conduction.nl>
  */
 
-import { translate as t } from '@nextcloud/l10n'
+import { getCanonicalLocale, translate as t } from '@nextcloud/l10n'
 import { generateOcsUrl, generateUrl } from '@nextcloud/router'
 import { reactive } from 'vue'
 import CalendarClock from 'vue-material-design-icons/CalendarClock.vue'
@@ -12,8 +12,10 @@ import LightningBolt from 'vue-material-design-icons/LightningBolt.vue'
 import Pencil from 'vue-material-design-icons/Pencil.vue'
 import { formatRelativeDate } from '../utils/boardDate.js'
 import { FLOW_RUN_ERROR_STATUSES, flowRunStatuses } from '../utils/flowRunStatus.js'
+import { fetchGroupMembers, fetchPresence, fetchStatuses } from '../utils/nextcloudDirectory.js'
 import { readPath } from '../utils/readPath.js'
 import { useFlowStore } from './useFlowStore.js'
+import { organisationRecord, useOrganisationStore } from './useOrganisationStore.js'
 import { useTaskInboxStore } from './useTaskInboxStore.js'
 
 /**
@@ -891,6 +893,210 @@ function searchSource(config = {}) {
 	}
 }
 
+/**
+ * The users source: the members of a Nextcloud group, with their function,
+ * roles, e-mail and whether they are in today (`entitySource: "users"`,
+ * DqAfdelingen). Pair it with `folderSidebar: { source: 'groups',
+ * filterField: 'group' }`, which lists the groups as the folder tree; the
+ * selected group arrives as `group`. `sourceConfig.group` is the group shown
+ * before one is picked.
+ *
+ * Today is the dav app's out-of-office period when one runs now ("Absent
+ * until 14 Oct"), else the user status (present, away) and its message. The
+ * function is the profile `headline`, the roles the profile `role`, unless
+ * `sourceConfig.functionField` / `rolesField` name other user fields.
+ * Listing a group needs an admin or the group's sub-admin; a refused request
+ * leaves the list empty.
+ *
+ * @return {object} The source adapter.
+ * @spec openspec/changes/index-groups-users-source/specs/index-page/spec.md#requirement-an-index-page-can-list-nextcloud-groups-and-their-members
+ */
+function usersSource() {
+	const state = reactive({ rows: [], loading: false })
+	let seq = 0
+	const presenceLabels = {
+		present: t('nextcloud-vue', 'Present'),
+		away: t('nextcloud-vue', 'Away'),
+	}
+	const presenceColors = {
+		[presenceLabels.present]: 'success',
+		[presenceLabels.away]: 'info',
+	}
+
+	return {
+		/**
+		 * Load the group's members and their presence.
+		 *
+		 * @param {object} config The page's source config with the picked `group`.
+		 * @return {Promise<void>} Resolves when loaded.
+		 */
+		load: async (config) => {
+			const group = String((config && (config.group || config.defaultGroup)) || '')
+			const mine = ++seq
+			if (group === '') {
+				state.rows = []
+				return
+			}
+			state.loading = true
+			try {
+				const { default: axios } = await import('@nextcloud/axios')
+				const [members, statuses] = await Promise.all([fetchGroupMembers(axios, group), fetchStatuses(axios)])
+				const functionField = (config && config.functionField) || 'headline'
+				const rolesField = (config && config.rolesField) || 'role'
+				const rows = await Promise.all(members.map(async (user) => {
+					const presence = await fetchPresence(axios, user.id, statuses[user.id] || null)
+					let today = ''
+					if (presence.state === 'absent') {
+						const until = presence.until ? new Date(`${presence.until}T12:00:00`) : null
+						today = until
+							? t('nextcloud-vue', 'Absent until {date}', { date: until.toLocaleDateString(getCanonicalLocale() || undefined, { day: 'numeric', month: 'short' }) })
+							: t('nextcloud-vue', 'Absent')
+					} else if (presence.message) {
+						today = presence.message
+					} else if (presenceLabels[presence.state]) {
+						today = presenceLabels[presence.state]
+					}
+					return {
+						id: user.id,
+						displayname: user.displayname || user['display-name'] || user.id,
+						function: String(user[functionField] || ''),
+						roles: String(user[rolesField] || ''),
+						email: user.email || '',
+						today,
+						presence: presence.state,
+					}
+				}))
+				if (mine === seq) {
+					state.rows = rows.sort((a, b) => a.displayname.localeCompare(b.displayname))
+				}
+			} catch (error) {
+				if (mine === seq) {
+					state.rows = []
+				}
+				throw error
+			} finally {
+				if (mine === seq) {
+					state.loading = false
+				}
+			}
+		},
+
+		/**
+		 * @return {Array<object>} The members.
+		 */
+		rows: () => state.rows,
+
+		/**
+		 * @return {boolean} Whether a load is in flight.
+		 */
+		loading: () => state.loading,
+
+		columns: [
+			{ key: 'displayname', label: t('nextcloud-vue', 'Employee'), secondary: 'function' },
+			{ key: 'roles', label: t('nextcloud-vue', 'Roles') },
+			{ key: 'email', label: t('nextcloud-vue', 'E-mail') },
+			{ key: 'today', label: t('nextcloud-vue', 'Today'), widget: 'badge', widgetProps: { colorMap: presenceColors, variant: 'warning' } },
+		],
+
+		searchFields: {
+			group: { param: 'group', single: true },
+		},
+
+		showAdd: false,
+	}
+}
+
+/**
+ * The organisations source: OpenRegister organisations, which are not
+ * register/schema objects.
+ *
+ * The list is the viewer's own organisations and the single read refuses an
+ * organisation the viewer has no access to; both are decided by OpenRegister
+ * from the session. The adapter forwards nothing that could widen that.
+ *
+ * It is a RECORD source as well (`loadRecord` + `record`), so a
+ * `type: "detail"` page with the same `entitySource` shows one organisation
+ * with the header, pills, facts and `@objectId` / `@object.*` tokens an object
+ * page has.
+ *
+ * @return {object} The source adapter.
+ * @spec openspec/changes/organisations-entity-source/specs/organisations-entity-source/spec.md
+ */
+function organisationsSource() {
+	const store = useOrganisationStore()
+
+	const statusLabels = {
+		provisioning: t('nextcloud-vue', 'Provisioning'),
+		active: t('nextcloud-vue', 'Active'),
+		suspended: t('nextcloud-vue', 'Suspended'),
+		deprovisioning: t('nextcloud-vue', 'Deprovisioning'),
+		archived: t('nextcloud-vue', 'Archived'),
+		retained: t('nextcloud-vue', 'Retained'),
+	}
+
+	return {
+		store,
+
+		/**
+		 * Load the viewer's organisations. The endpoint takes no parameters.
+		 *
+		 * @return {Promise<void>} Resolves when loaded.
+		 */
+		load: () => store.load(),
+
+		/**
+		 * @return {Array<object>} The rows, keyed on the organisation uuid.
+		 */
+		rows: () => (store.organisations || []).map(organisationRecord),
+
+		/**
+		 * @return {boolean} Whether a load is in flight.
+		 */
+		loading: () => !!store.loading,
+
+		/**
+		 * Read one organisation for a detail page.
+		 *
+		 * @param {string} id The organisation uuid.
+		 * @return {Promise<object|null>} The organisation, or null when it could not be read.
+		 */
+		loadRecord: (id) => store.fetchRecord(id),
+
+		/**
+		 * @param {string} id The organisation uuid.
+		 * @return {object|null} The organisation read for this id, keyed on its uuid, or null.
+		 */
+		record: (id) => {
+			const organisation = store.records?.[String(id)]
+			return organisation ? organisationRecord(organisation) : null
+		},
+
+		/**
+		 * @param {string} id The organisation uuid.
+		 * @return {number|null} The HTTP status of a failed read of this id, or null.
+		 */
+		recordError: (id) => store.recordErrors?.[String(id)] ?? null,
+
+		columns: [
+			{ key: 'name', label: t('nextcloud-vue', 'Name') },
+			{
+				key: 'status',
+				label: t('nextcloud-vue', 'Status'),
+				enum: Object.keys(statusLabels),
+				enumLabels: statusLabels,
+				colorMap: { active: 'success', provisioning: 'info', suspended: 'warning', deprovisioning: 'error', archived: 'default', retained: 'default' },
+			},
+			{ key: 'type', label: t('nextcloud-vue', 'Type') },
+			{ key: 'created', label: t('nextcloud-vue', 'Created'), type: 'string', format: 'date-time' },
+		],
+
+		// Creating an organisation is not the index's object form, and
+		// OpenRegister has no delete for one, so neither action is offered.
+		showAdd: false,
+		title: t('nextcloud-vue', 'Organisations'),
+	}
+}
+
 /**
  * The registered sources, by the name a manifest uses.
  *
@@ -904,6 +1110,8 @@ export const indexSources = {
 	tasks: tasksSource,
 	endpoint: endpointSource,
 	search: searchSource,
+	users: usersSource,
+	organisations: organisationsSource,
 }
 
 /**
@@ -935,3 +1143,31 @@ export function resolveIndexSource(name, config) {
 
 	return factory(config || {})
 }
+
+/**
+ * Resolve a named source for ONE record, for a `type: "detail"` page.
+ *
+ * The same registry as the index: a source that can also read a single record
+ * supplies `loadRecord(id)` and `record(id)`, and the detail page names it with
+ * the same `entitySource`. A name that is unknown, or a source that cannot read
+ * one record, resolves to null with a console warning, and the page shows no
+ * record rather than the wrong one.
+ *
+ * @param {string} name The source name from `config.entitySource`.
+ * @return {object|null} The adapter, or null.
+ * @spec openspec/changes/organisations-entity-source/specs/organisations-entity-source/spec.md
+ */
+export function resolveRecordSource(name) {
+	const key = String(name || '')
+	if (!key) {
+		return null
+	}
+	const factory = indexSources[key]
+	const source = typeof factory === 'function' ? factory() : null
+	if (!source || typeof source.loadRecord !== 'function' || typeof source.record !== 'function') {
+		// eslint-disable-next-line no-console
+		console.warn(`[CnDetailPage] entitySource "${key}" is not a source that reads one record. The page shows no record.`)
+		return null
+	}
+	return source
+}

package/src/composables/useFlowStore.js

@@ -23,6 +23,7 @@
 //      vocabulary.
 
 import axios from '@nextcloud/axios'
+import { translate as t } from '@nextcloud/l10n'
 import { generateUrl } from '@nextcloud/router'
 import { defineStore } from 'pinia'
 import { layoutFlowNodes, needsFullLayout, placeLooseNodes } from './flowGraphLayout.js'
@@ -968,7 +969,7 @@ export const useFlowStore = defineStore('cnFlow', {
 				// A new flow is runnable on demand until its author picks a real
 				// trigger, so the flow-level trigger and the seeded start node
 				// say the same thing.
-				this.flow = { ...emptyFlow(), name: 'New flow', app: app || 'openregister', trigger: 'manual' }
+				this.flow = { ...emptyFlow(), name: t('nextcloud-vue', 'New flow'), app: app || 'openregister', trigger: 'manual' }
 				this.seedStartNode()
 				this.dirty = false
 				return

package/src/composables/useOrganisationStore.js

@@ -0,0 +1,111 @@
+/**
+ * SPDX-License-Identifier: EUPL-1.2
+ * SPDX-FileCopyrightText: 2026 Conduction B.V. <info@conduction.nl>
+ */
+
+import axios from '@nextcloud/axios'
+import { generateUrl } from '@nextcloud/router'
+import { defineStore } from 'pinia'
+
+/**
+ * OpenRegister's organisation endpoints, behind the `organisations` entity source.
+ *
+ * An organisation is not a register/schema object, so the object store cannot
+ * read it. Both reads answer from the session: the list holds only the
+ * organisations the viewer belongs to, and one organisation answers 403 when
+ * the viewer has no access to it. This store adds no check of its own and
+ * skips none.
+ *
+ * @type {string}
+ */
+export const ORGANISATIONS_URL = '/apps/openregister/api/organisations'
+
+/**
+ * One organisation as a row or a record: the organisation as OpenRegister
+ * serialises it, with `id` set to its uuid. An OpenRegister object's `id` is
+ * its uuid as well, so `@object.id`, a row route and the page's `objectId`
+ * all name the same thing. The numeric database id stays out of sight.
+ *
+ * @param {object} organisation The organisation from the endpoint.
+ * @return {object} The organisation keyed on its uuid.
+ */
+export function organisationRecord(organisation) {
+	return { ...organisation, id: organisation?.uuid ?? organisation?.id ?? null }
+}
+
+/**
+ * The organisations store.
+ *
+ * @spec openspec/changes/organisations-entity-source/specs/organisations-entity-source/spec.md
+ */
+export const useOrganisationStore = defineStore('cnOrganisations', {
+	state: () => ({
+		/** @type {Array<object>} The viewer's organisations, as the list endpoint returned them. */
+		organisations: [],
+		/** @type {boolean} Whether the list load is in flight. */
+		loading: false,
+		/** @type {string|null} The last list failure, for the console trail. */
+		error: null,
+		/** @type {Record<string, object>} Single organisations read so far, by uuid. */
+		records: {},
+		/** @type {Record<string, number|null>} The HTTP status of a failed single read, by uuid. */
+		recordErrors: {},
+	}),
+
+	actions: {
+		/**
+		 * Load the viewer's organisations. The endpoint takes no parameters and
+		 * returns every organisation the viewer belongs to in one response.
+		 *
+		 * @return {Promise<void>} Resolves when the rows are in the store.
+		 */
+		async load() {
+			this.loading = true
+			this.error = null
+			try {
+				const response = await axios.get(generateUrl(ORGANISATIONS_URL))
+				this.organisations = Array.isArray(response.data?.results) ? response.data.results : []
+			} catch (error) {
+				this.error = error?.message || String(error)
+				this.organisations = []
+				// eslint-disable-next-line no-console
+				console.error('[useOrganisationStore] Loading the organisations failed', error)
+			} finally {
+				this.loading = false
+			}
+		},
+
+		/**
+		 * Read one organisation into `records`. A refusal (403) or a missing
+		 * organisation (404) leaves no record and keeps the status in
+		 * `recordErrors`, so the page can tell "not found" from "still loading".
+		 *
+		 * @param {string} uuid The organisation uuid.
+		 * @return {Promise<object|null>} The organisation, or null when it could not be read.
+		 */
+		async fetchRecord(uuid) {
+			const key = String(uuid || '')
+			if (key === '') {
+				return null
+			}
+			try {
+				const response = await axios.get(generateUrl(`${ORGANISATIONS_URL}/${encodeURIComponent(key)}`))
+				const organisation = response.data?.organisation || null
+				const { [key]: dropped, ...errors } = this.recordErrors
+				this.recordErrors = errors
+				if (!organisation) {
+					return null
+				}
+				this.records = { ...this.records, [key]: organisation }
+				return organisation
+			} catch (error) {
+				const { [key]: dropped, ...records } = this.records
+				this.records = records
+				this.recordErrors = { ...this.recordErrors, [key]: error?.response?.status ?? null }
+				// eslint-disable-next-line no-console
+				console.error(`[useOrganisationStore] Loading organisation "${key}" failed`, error)
+				return null
+			}
+		},
+	},
+})

package/src/css/badge.css

@@ -31,84 +31,100 @@
 
 /* Color variants */
 .cn-status-badge--default {
+	--cn-status-badge-ink: var(--color-main-text);
 	background-color: var(--color-background-dark);
-	color: var(--color-main-text);
+	color: var(--cn-status-badge-ink);
 }
 
 .cn-status-badge--primary {
+	--cn-status-badge-ink: var(--color-primary-element);
 	background-color: var(--color-primary-element-light);
-	color: var(--color-primary-element);
+	color: var(--cn-status-badge-ink);
 }
 
 .cn-status-badge--success {
+	--cn-status-badge-ink: var(--color-success-text, var(--color-success));
 	background-color: var(--color-success-light, rgba(70, 186, 97, 0.15));
-	color: var(--color-success-text, var(--color-success));
+	color: var(--cn-status-badge-ink);
 }
 
 .cn-status-badge--warning {
+	--cn-status-badge-ink: var(--color-warning-text, var(--color-warning));
 	background-color: var(--color-warning-light, rgba(232, 163, 39, 0.15));
-	color: var(--color-warning-text, var(--color-warning));
+	color: var(--cn-status-badge-ink);
 }
 
 .cn-status-badge--error {
+	--cn-status-badge-ink: var(--color-error-text, var(--color-error));
 	background-color: var(--color-error-light, rgba(224, 68, 68, 0.15));
-	color: var(--color-error-text, var(--color-error));
+	color: var(--cn-status-badge-ink);
 }
 
 .cn-status-badge--info {
+	--cn-status-badge-ink: var(--color-info-text, var(--color-info, #0082c9));
 	background-color: var(--color-info-light, rgba(0, 130, 201, 0.15));
-	color: var(--color-info-text, var(--color-info, #0082c9));
+	color: var(--cn-status-badge-ink);
 }
 
 /* Work in progress ("In behandeling"), a board tone. */
 .cn-status-badge--purple {
+	--cn-status-badge-ink: var(--cn-status-purple-text);
 	background-color: var(--cn-status-purple-bg);
-	color: var(--cn-status-purple-text);
+	color: var(--cn-status-badge-ink);
 }
 
 /* Handed on ("Omgezet naar een zaak"), a board tone. */
 .cn-status-badge--teal {
+	--cn-status-badge-ink: var(--cn-status-teal-text);
 	background-color: var(--cn-status-teal-bg);
-	color: var(--cn-status-teal-text);
+	color: var(--cn-status-badge-ink);
 }
 
 /* Solid variants — solid background with white text for use on colored backgrounds */
 .cn-status-badge--solid.cn-status-badge--default {
+	--cn-status-badge-ink: var(--color-main-text);
 	background-color: var(--color-background-dark);
-	color: var(--color-main-text);
+	color: var(--cn-status-badge-ink);
 }
 
 .cn-status-badge--solid.cn-status-badge--primary {
+	--cn-status-badge-ink: white;
 	background-color: var(--color-primary-element);
-	color: white;
+	color: var(--cn-status-badge-ink);
 }
 
 .cn-status-badge--solid.cn-status-badge--success {
+	--cn-status-badge-ink: white;
 	background-color: var(--color-success);
-	color: white;
+	color: var(--cn-status-badge-ink);
 }
 
 .cn-status-badge--solid.cn-status-badge--warning {
+	--cn-status-badge-ink: var(--color-primary-text);
 	background-color: var(--color-warning);
-	color: var(--color-primary-text);
+	color: var(--cn-status-badge-ink);
 }
 
 .cn-status-badge--solid.cn-status-badge--error {
+	--cn-status-badge-ink: white;
 	background-color: var(--color-error);
-	color: white;
+	color: var(--cn-status-badge-ink);
 }
 
 .cn-status-badge--solid.cn-status-badge--info {
+	--cn-status-badge-ink: white;
 	background-color: var(--color-info, #0082c9);
-	color: white;
+	color: var(--cn-status-badge-ink);
 }
 
 .cn-status-badge--solid.cn-status-badge--purple {
+	--cn-status-badge-ink: white;
 	background-color: var(--cn-status-purple-text);
-	color: white;
+	color: var(--cn-status-badge-ink);
 }
 
 .cn-status-badge--solid.cn-status-badge--teal {
+	--cn-status-badge-ink: white;
 	background-color: var(--cn-status-teal-text);
-	color: white;
+	color: var(--cn-status-badge-ink);
 }