@conduction/nextcloud-vue 2.69.0 → 2.71.0

package/src/components/CnWeekStripWidget/CnWeekStripWidget.vue

@@ -3,7 +3,7 @@
   SPDX-License-Identifier: EUPL-1.2
 -->
 <template>
-	<div class="cn-week-strip" data-testid="cn-week-strip">
+	<div class="cn-week-strip" :class="{ 'cn-week-strip--inset': inset }" data-testid="cn-week-strip">
 		<div v-if="loading" class="cn-week-strip__state" role="status">
 			<NcLoadingIcon :size="20" />
 			<span class="cn-week-strip__state-text">{{ loadingLabel }}</span>
@@ -118,9 +118,11 @@ export default {
 		 * today), `lateField` a boolean field that marks a record late.
 		 * `items` are static entries `{ title, meta?, date, route?, href?, late? }`.
 		 * `emptyText` is the text of a day without items. `weekOffset` moves
-		 * the strip whole weeks from the current one.
+		 * the strip whole weeks from the current one. `inset: true` draws the
+		 * strip inside the board's inset (16px above, 24px at the sides, 22px
+		 * below) instead of from card edge to card edge.
 		 *
-		 * @type {{days?: (5|7), source?: {register?: string, schema?: string, filter?: object, limit?: number}, dateField?: string, titleField?: string, metaFields?: Array<string>, itemRoute?: string, lateWhen?: {op?: string, value?: number}, lateField?: string, items?: Array<{title: string, meta?: string, date: string, route?: (string|object), href?: string, late?: boolean}>, emptyText?: string, weekOffset?: number}}
+		 * @type {{days?: (5|7), inset?: boolean, source?: {register?: string, schema?: string, filter?: object, limit?: number}, dateField?: string, titleField?: string, metaFields?: Array<string>, itemRoute?: string, lateWhen?: {op?: string, value?: number}, lateField?: string, items?: Array<{title: string, meta?: string, date: string, route?: (string|object), href?: string, late?: boolean}>, emptyText?: string, weekOffset?: number}}
 		 */
 		content: {
 			type: Object,
@@ -159,6 +161,17 @@ export default {
 	},
 
 	computed: {
+		/**
+		 * Whether the widget draws the board's inset (`content.inset`). Off
+		 * by default, which keeps it edge to edge as before.
+		 *
+		 * @spec openspec/changes/zuiddrecht-pixel-gaps-3/specs/zuiddrecht-pixel-gaps-3/spec.md#requirement-a-strip-and-a-stacked-bar-can-take-the-board-inset
+		 * @return {boolean}
+		 */
+		inset() {
+			return Boolean(this.content && this.content.inset === true)
+		},
+
 		/**
 		 * The translate function in use.
 		 *
@@ -542,6 +555,14 @@ export default {
 	width: 100%;
 }
 
+/* `content.inset: true`: the board's inset inside the card (zuiddrecht-pixel-
+   gaps-3). A dashboard renders its widgets flush, so without it the strip ran
+   from card edge to card edge. Theme hook: --cn-widget-board-inset. */
+.cn-week-strip--inset {
+	box-sizing: border-box;
+	padding: var(--cn-widget-board-inset, 16px 24px 22px);
+}
+
 .cn-week-strip__state {
 	display: flex;
 	align-items: center;

package/src/composables/useWalkthrough.js

@@ -216,11 +216,13 @@ export function walkthroughProgressKey(configKey) {
 
 /**
  * Normalise stored progress (an object, or the JSON string a preference
- * holds) into `{ tourId, stepId, index, version }`, or null.
+ * holds) into `{ tourId, stepId, index, version }`, plus `paused: true`
+ * when the user paused the tour, or null.
  *
  * @spec openspec/changes/walkthrough-advance-pause-resume/specs/cn-walkthrough/spec.md
+ * @spec openspec/changes/audit-round-lib-fixes/specs/cn-walkthrough/spec.md
  * @param {unknown} value The stored value.
- * @return {{tourId: string, stepId: string, index: number, version: string}|null} The progress.
+ * @return {{tourId: string, stepId: string, index: number, version: string, paused: (boolean|undefined)}|null} The progress.
  */
 export function normaliseWalkthroughProgress(value) {
 	let data = value
@@ -237,12 +239,18 @@ export function normaliseWalkthroughProgress(value) {
 	if (!isPlainObject(data) || typeof data.tourId !== 'string' || data.tourId === '') {
 		return null
 	}
-	return {
+	const progress = {
 		tourId: data.tourId,
 		stepId: typeof data.stepId === 'string' ? data.stepId : '',
 		index: Number.isInteger(data.index) && data.index >= 0 ? data.index : 0,
 		version: typeof data.version === 'string' ? data.version : '',
 	}
+	// A paused tour stays hidden on the next visit until the user picks
+	// "Continue". Only written when true, so older values read unchanged.
+	if (data.paused === true) {
+		progress.paused = true
+	}
+	return progress
 }
 
 /**

package/src/css/dashboard.css

@@ -129,3 +129,47 @@
 .cn-requires-app.cn-requires-app .empty-content__action {
 	margin-top: var(--default-grid-baseline, 4px);
 }
+
+/* NcEmptyContent forces its icon's svg to 64px with !important while the
+ * rule above lets the icon box shrink, so the svg spilled out of its box and
+ * over the name. Hold the svg to the size the caller asked for. */
+.cn-requires-app.cn-requires-app .empty-content__icon svg {
+	width: 32px !important;
+	height: 32px !important;
+	max-width: 32px !important;
+	max-height: 32px !important;
+}
+
+/* The dashboard's compact "Install <app>" placeholder: two lines of text and
+ * the button, nothing else, so it fits a two-row tile even under a title row.
+ * `safe center` keeps the top in view when a tile is smaller still, and the
+ * body scrolls rather than clipping the button. */
+.cn-requires-app--compact {
+	display: flex;
+	flex-direction: column;
+	align-items: center;
+	justify-content: safe center;
+	gap: calc(2 * var(--default-grid-baseline, 4px));
+	box-sizing: border-box;
+	height: 100%;
+	min-height: 0;
+	overflow: auto;
+	padding: calc(2 * var(--default-grid-baseline, 4px));
+	text-align: center;
+}
+
+.cn-requires-app--compact .cn-requires-app__description {
+	display: -webkit-box;
+	margin: 0;
+	overflow: hidden;
+	color: var(--color-text-maxcontrast);
+	font-size: 0.9em;
+	line-height: 1.4;
+	-webkit-box-orient: vertical;
+	-webkit-line-clamp: 2;
+	line-clamp: 2;
+}
+
+.cn-requires-app--compact .button-vue {
+	flex-shrink: 0;
+}

package/src/css/detail-page.css

@@ -46,6 +46,16 @@
 	row-gap: var(--cn-detail-header-row-gap, 22px);
 }
 
+/* That wrap must not take the actions off the title row. With `flex-basis:
+   auto` a long title claimed its whole text width, so the actions wrapped
+   under it. From a zero basis the title takes what the actions leave and
+   wraps (two lines, then an ellipsis) inside it; only on a page too narrow
+   for 16rem of title beside the actions do the actions drop a row. */
+.cn-detail-page__header--with-widget > :first-child {
+	flex: 1 1 0;
+	min-width: min(100%, 16rem);
+}
+
 .cn-detail-page__header-widget {
 	flex: 1 0 100%;
 	min-width: 0;

package/src/css/index-page.css

@@ -10,6 +10,18 @@
 	padding: calc(5 * var(--default-grid-baseline));
 }
 
+/* The board's header buttons (`headerButtons`) at the end of the title row,
+   centred on the title and its count line. They wrap under the title on a
+   narrow page. */
+.cn-index-page__header-buttons {
+	display: flex;
+	flex-wrap: wrap;
+	align-items: center;
+	align-self: center;
+	gap: calc(2 * var(--default-grid-baseline));
+	margin-inline-start: auto;
+}
+
 .cn-index-page__below-header {
     margin-bottom: calc(4 * var(--default-grid-baseline));
 }

package/src/css/kpi-card.css

@@ -414,6 +414,21 @@ a.cn-kpi-card--stacked:focus-visible {
 	text-decoration: none !important;
 }
 
+/* A stacked stats block (CnStatsBlock `layout: "stacked"`): its unit
+   ("decisions") goes on a muted line of its own under the number, where the
+   stat tile puts its caption (zuiddrecht-pixel-gaps-3). */
+.cn-kpi-card--stacked .cn-stats-block__count {
+	flex-direction: column;
+	align-items: flex-start;
+	gap: var(--cn-kpi-stacked-gap, 6px);
+}
+
+.cn-kpi-card--stacked .cn-stats-block__count-label {
+	font-size: var(--cn-kpi-label-size, 13px);
+	font-weight: 500;
+	color: var(--color-text-maxcontrast);
+}
+
 /* Filled: the card draws its own grey box, for a KPI that is NOT already
    inside a wrapper that draws one. Opt-in via `content.flat: false`. */
 .cn-kpi-card--filled {

package/src/schemas/app-manifest-v2.schema.json

@@ -3,7 +3,7 @@
 	"$id": "https://raw.githubusercontent.com/ConductionNL/nextcloud-vue/main/src/schemas/app-manifest-v2.schema.json",
 	"title": "Conduction App Manifest v2",
 	"description": "v2 schema for the JSON-driven page and navigation manifest consumed by @conduction/nextcloud-vue. Introduces a uniform widgets[] array on every page type with a per-slot grid coordinate system, a typed actions[] discriminator, and the required $schema field for version detection. v1 manifests continue to validate against app-manifest.schema.json (unchanged).",
-	"version": "2.51.0",
+	"version": "2.53.0",
 	"type": "object",
 	"required": ["$schema", "version"],
 	"allOf": [
@@ -64,6 +64,7 @@
 				"enabled": { "type": "boolean", "default": true, "description": "Whether the setup wizard is active for this app." },
 				"version": { "type": "integer", "default": 1, "description": "Setup contract version; bump to re-trigger setup after a breaking change." },
 				"completionConfigKey": { "type": "string", "description": "App-config key storing the completed setup version." },
+				"dismissAction": { "type": "string", "pattern": "^[a-z0-9][a-z0-9-]*$", "description": "Setup action that records a closed or finished setup wizard on the server, so it stays closed in every browser. CnAppRoot posts `/apps/{appId}/api/setup/action/{dismissAction}` with `{ finished }` once when the user closes or finishes the wizard. The app either answers the outstanding optional steps or reports `dismissed` (true, or the setup version it was closed at) in `GET /api/setup/status`. Without it, the close is remembered only in the browser (localStorage), as before." },
 				"steps": {
 					"type": "array",
 					"description": "Ordered setup steps rendered by CnSetupWizard.",
@@ -1569,6 +1570,11 @@
 						"href": { "type": "string" }
 					}
 				},
+				"showButtons": {
+					"type": "boolean",
+					"default": true,
+					"description": "`false` drops the widget's footer links (its definition's `buttons`, e.g. a calendar's \"More events\"), for a placement whose card says enough without them (zuiddrecht-pixel-gaps-3)."
+				},
 				"sizeToContent": {
 					"type": ["boolean", "integer"],
 					"minimum": 1,
@@ -2195,7 +2201,8 @@
 												}
 											},
 											"emptyText": { "type": "string", "description": "Text of a day without items." },
-											"weekOffset": { "type": "integer", "description": "Whole weeks from the current one (1 = next week)." }
+											"weekOffset": { "type": "integer", "description": "Whole weeks from the current one (1 = next week)." },
+											"inset": { "type": "boolean", "default": false, "description": "Draw the strip inside the board's inset (16px above, 24px at the sides, 22px below) instead of from card edge to card edge (zuiddrecht-pixel-gaps-3). Theme hook --cn-widget-board-inset." }
 										}
 									}
 								}
@@ -2246,7 +2253,8 @@
 											},
 											"order": { "type": "array", "items": { "type": "string" }, "description": "Group keys in the order they render. Unlisted groups follow; a listed key without records shows 0." },
 											"labels": { "type": "object", "additionalProperties": { "type": "string" }, "description": "The label of a group key." },
-											"emptyText": { "type": "string", "description": "Shown when the total is 0." }
+											"emptyText": { "type": "string", "description": "Shown when the total is 0." },
+											"inset": { "type": "boolean", "default": false, "description": "Draw the bar and legend inside the board's inset (16px above, 24px at the sides, 22px below) instead of from card edge to card edge (zuiddrecht-pixel-gaps-3). Theme hook --cn-widget-board-inset." }
 										}
 									}
 								}
@@ -3681,7 +3689,12 @@
 						"showWidgetActions": {
 							"type": "boolean",
 							"default": true,
-							"description": "type='dashboard': `false` drops the overflow Actions menu from every widget that does not set `showActions` itself, for a dashboard whose widget headers carry a header link and nothing else (zuiddrecht-pixel-gaps-2). Maps to CnDashboardPage `showWidgetActions`."
+							"description": "type='dashboard' and type='detail': `false` drops the overflow Actions menu from every widget that does not set `showActions` itself, for a dashboard whose widget headers carry a header link and nothing else (zuiddrecht-pixel-gaps-2), or a record page whose data cards carry none (zuiddrecht-pixel-gaps-3; a card with an Add action keeps it). Maps to CnDashboardPage / CnDetailPage `showWidgetActions`."
+						},
+						"gridFloat": {
+							"type": "boolean",
+							"default": true,
+							"description": "type='dashboard': `false` packs widgets upward (GridStack `float: false`), so a size-to-content widget that shrinks closes the gap under it instead of leaving an empty band (zuiddrecht-pixel-gaps-3). Maps to CnDashboardPage `gridFloat`."
 						},
 						"showTitle": {
 							"type": "boolean",
@@ -3692,6 +3705,33 @@
 							"type": "string",
 							"description": "type='index': an i18n key for the description line with `{total}` replaced by the collection's total, e.g. \"{total} open cases\" (zuiddrecht-pixel-gaps). Shown in place of `description` once a total is known. Maps to CnIndexPage `countSubtitle`."
 						},
+						"showTitleIcon": {
+							"type": "boolean",
+							"default": true,
+							"description": "type='index': `false` drops the icon before the page title, for a title that stands alone as the board draws it (zuiddrecht-pixel-gaps-3). Maps to CnIndexPage `showTitleIcon`."
+						},
+						"showCount": {
+							"type": "boolean",
+							"default": true,
+							"description": "type='index': `false` drops the actions bar's \"Showing 20 of 258\" line, for a page whose title line already gives the total through `countSubtitle` (zuiddrecht-pixel-gaps-3). Maps to CnIndexPage `showCount`."
+						},
+						"headerButtons": {
+							"type": "array",
+							"description": "type='index': buttons beside the page title, as the board's \"Export\" and \"New case\" (zuiddrecht-pixel-gaps-3). `action` is `add` (the Add flow; the label defaults to the Add label), `export` (the export leaf in `format`, else the export dialog), `import`, `refresh`, or the id of a `headerActions` entry. Shown only with `showTitle`; when they show, the actions bar drops its Views and Actions menus, and the Add button and Export menu when a button takes their action. Maps to CnIndexPage `headerButtons`.",
+							"items": {
+								"type": "object",
+								"additionalProperties": false,
+								"required": ["action"],
+								"properties": {
+									"id": { "type": "string", "minLength": 1 },
+									"label": { "type": "string", "minLength": 1, "description": "i18n key; optional for `add`." },
+									"action": { "type": "string", "minLength": 1 },
+									"variant": { "type": "string", "enum": ["primary", "secondary"], "default": "secondary" },
+									"icon": { "type": "string", "minLength": 1, "description": "MDI icon name." },
+									"format": { "type": "string", "enum": ["csv", "excel"], "default": "csv", "description": "For `export`." }
+								}
+							}
+						},
 						"showTypeEyebrow": {
 							"type": "boolean",
 							"default": true,
@@ -3707,7 +3747,9 @@
 								"route": { "type": "string" },
 								"params": { "type": "object", "additionalProperties": true },
 								"href": { "type": "string" },
-								"icon": { "type": "string", "minLength": 1, "description": "Optional MDI icon name (e.g. `Home`) drawn as the first crumb instead of the label, which then becomes its accessible name (zuiddrecht-pixel-gaps-2). Without it the label shows as text." }
+								"icon": { "type": "string", "minLength": 1, "description": "Optional MDI icon name (e.g. `Home`) drawn as the first crumb instead of the label, which then becomes its accessible name (zuiddrecht-pixel-gaps-2). Without it the label shows as text." },
+								"currentField": { "type": "string", "minLength": 1, "description": "A field of the record (dotted path, e.g. `identifier`) whose value is the current crumb instead of the display name; an empty value falls back to the display name (zuiddrecht-pixel-gaps-3)." },
+								"separator": { "type": "string", "minLength": 1, "maxLength": 3, "description": "Text drawn between the crumbs (e.g. `/`) instead of the chevron (zuiddrecht-pixel-gaps-3)." }
 							}
 						},
 						"headerCard": {

package/src/utils/capabilityComparison.js

@@ -22,6 +22,34 @@
  * @module utils/capabilityComparison
  */
 
+/*
+ * `process.env.NODE_ENV` is substituted by every consuming app's bundler at
+ * build time (webpack's DefinePlugin, rollup's replace); see NcSelectTags.js.
+ */
+/* global process */
+
+let deprecationWarned = false
+
+/**
+ * Warn once per page load, in a development build only, that the in-app
+ * capability comparison is deprecated. Called by CnFeaturesAndRoadmapPage,
+ * CnFeaturesAndRoadmapView and CnCapabilityTable when a comparison is
+ * actually given, so an app that passes none hears nothing.
+ *
+ * @spec openspec/changes/zuiddrecht-pixel-gaps-3/specs/zuiddrecht-pixel-gaps-3/spec.md#requirement-the-in-app-capability-comparison-is-deprecated
+ * @param {string} source What carried the comparison, for the message.
+ * @return {boolean} True when this call printed the warning.
+ */
+export function warnCapabilityComparisonDeprecated(source) {
+	if (deprecationWarned || process.env.NODE_ENV === 'production') {
+		return false
+	}
+	deprecationWarned = true
+	// eslint-disable-next-line no-console -- a deliberate deprecation notice to the developer integrating the component
+	console.warn(`[nextcloud-vue] ${source} is deprecated: the in-app capability comparison (capabilityComparison, the features_roadmap_capabilities initial state, CnCapabilityTable) will be removed in a future major version. Publish the comparison on the app's docs site and link to it instead.`)
+	return true
+}
+
 /**
  * Ratings in the order they are counted and rendered.
  *

package/src/utils/columnFilters.js

@@ -161,15 +161,65 @@ function referenceTarget(column, prop) {
 	return { schema, register, labelField }
 }
 
+/**
+ * Whether a schema lists its properties. Without that the table knows its
+ * columns but not what backs them.
+ *
+ * @param {object|null} schema The table's schema.
+ * @return {boolean} True when the schema has a properties map.
+ */
+function hasProperties(schema) {
+	return !!(schema && typeof schema === 'object' && schema.properties && typeof schema.properties === 'object')
+}
+
+/**
+ * A filter for a column when the table has no schema to read (a manifest
+ * page whose schema did not resolve, a host-fed table). The column's own
+ * hints decide the kind: an `fkResolve` widget gives a reference filter, a
+ * `type` or `format` on the column gives number, date or yes/no, and every
+ * other plain stored key gets a text filter on contains (`[like]`). A key
+ * that is a path (`a.b`) or a metadata field (`@self`, `_id`) gets none,
+ * because OpenRegister does not filter those by that name.
+ *
+ * @spec openspec/changes/audit-round-lib-fixes/specs/cn-data-table/spec.md
+ * @param {object} column The column definition.
+ * @param {object} base The shared part of the definition.
+ * @return {object|null} The filter definition.
+ */
+function columnHintFilterDef(column, base) {
+	const key = column.key
+	if (key.includes('.') || key.charAt(0) === '@' || key.charAt(0) === '_') {
+		return null
+	}
+	const reference = referenceTarget(column, null)
+	if (reference) {
+		return { ...base, kind: 'reference', reference }
+	}
+	const type = String(column.type || '').toLowerCase()
+	const format = String(column.format || '').toLowerCase()
+	if (type === 'boolean') {
+		return { ...base, kind: 'boolean' }
+	}
+	if (type === 'number' || type === 'integer') {
+		return { ...base, kind: 'number' }
+	}
+	if (type === 'date' || type === 'date-time' || format === 'date' || format === 'date-time') {
+		return { ...base, kind: 'date', dateTime: type === 'date-time' || format === 'date-time' }
+	}
+	return { ...base, kind: 'string' }
+}
+
 /**
  * How a column filters, or null when it does not.
  *
  * Kinds: `enum` (checkbox list), `boolean` (yes, no, any), `reference`
  * (searchable list of the referenced objects), `number` and `date` (from and
  * to), and `string` (contains, through OpenRegister's `[like]`). `filterable: false` on the column turns it
- * off. A column with no schema property behind it only filters when it
- * carries an enum hint (`enum`, or a badge widget's colour map), because the
- * server cannot filter on a value it does not store.
+ * off. When the schema lists its properties, a column with no property
+ * behind it only filters when it carries an enum hint (`enum`, or a badge
+ * widget's colour map), because the server cannot filter on a value it does
+ * not store. When there is no schema to read, the column's own hints decide
+ * (see `columnHintFilterDef`), falling back to a text filter on contains.
  *
  * @param {object} column The column definition.
  * @param {object|null} schema The table's schema.
@@ -191,7 +241,7 @@ export function columnFilterDef(column, schema) {
 		return { ...base, kind: 'enum', options }
 	}
 	if (!prop) {
-		return null
+		return hasProperties(schema) ? null : columnHintFilterDef(column, base)
 	}
 	const reference = referenceTarget(column, prop)
 	if (reference) {

package/src/utils/userAutocomplete.js

@@ -12,9 +12,50 @@
  * @module utils/userAutocomplete
  */
 
+import { getCurrentUser } from '@nextcloud/auth'
 import axios from '@nextcloud/axios'
 import { generateOcsUrl } from '@nextcloud/router'
 
+/**
+ * The signed-in user as a picker option, or null when nobody is signed in.
+ *
+ * Core autocomplete never returns the person who searches (it is built for
+ * sharing, and you do not share with yourself), so a picker backed by it
+ * alone cannot assign a task to yourself.
+ *
+ * @spec openspec/changes/audit-round-lib-fixes/specs/schema-utilities/spec.md
+ * @return {{id: string, label: string, displayName: string, subline: string}|null} The option.
+ */
+function currentUserOption() {
+	let user
+	try {
+		user = getCurrentUser()
+	} catch {
+		return null
+	}
+	if (!user || !user.uid) {
+		return null
+	}
+	const name = user.displayName || String(user.uid)
+	return { id: String(user.uid), label: name, displayName: name, subline: '' }
+}
+
+/**
+ * Whether the current-user option matches a search term (uid or display
+ * name contains the term, ignoring case). An empty term matches.
+ *
+ * @param {object} option The current-user option.
+ * @param {string} query The search term.
+ * @return {boolean} True when it matches.
+ */
+function matchesQuery(option, query) {
+	const q = String(query || '').trim().toLowerCase()
+	if (q === '') {
+		return true
+	}
+	return option.id.toLowerCase().includes(q) || option.label.toLowerCase().includes(q)
+}
+
 /**
  * Map one autocomplete suggestion to a picker option, keeping only user
  * results. The OCS payload uses `id` for the UID, `label` for the display
@@ -59,10 +100,11 @@ function toUserOption(suggestion) {
  * @param {string} [query] The search term (empty loads an initial page).
  * @param {object} [options] Tuning options.
  * @param {number} [options.limit] Max results (default 25).
+ * @param {boolean} [options.includeCurrentUser] Add the signed-in user when they match (default true; a mention list passes false).
  * @return {Promise<Array<{id: string, label: string, subline: string}>>} Picker options.
  */
 export async function searchNextcloudUsers(query = '', options = {}) {
-	const { limit = 25 } = options
+	const { limit = 25, includeCurrentUser = true } = options
 	try {
 		const url = generateOcsUrl('core/autocomplete/get')
 		const response = await axios.get(url, {
@@ -86,14 +128,32 @@ export async function searchNextcloudUsers(query = '', options = {}) {
 		const list = Array.isArray(data)
 			? data
 			: (Array.isArray(response && response.data) ? response.data : [])
-		return list
+		const found = list
 			.map(toUserOption)
 			.filter((opt) => opt !== null)
+		return includeCurrentUser ? withCurrentUser(found, query) : found
 	} catch {
 		return []
 	}
 }
 
+/**
+ * Put the signed-in user first in a result list when they match the search
+ * and the server left them out.
+ *
+ * @spec openspec/changes/audit-round-lib-fixes/specs/schema-utilities/spec.md
+ * @param {Array<object>} options The server's options.
+ * @param {string} query The search term.
+ * @return {Array<object>} The options, the current user included when they match.
+ */
+function withCurrentUser(options, query) {
+	const me = currentUserOption()
+	if (!me || !matchesQuery(me, query) || options.some((opt) => opt.id === me.id)) {
+		return options
+	}
+	return [me, ...options]
+}
+
 /**
  * Resolve a single user UID to a `{ id, label }` option for edit-mode display.
  * Tries the autocomplete endpoint with the UID as the query and matches the
@@ -108,6 +168,12 @@ export async function resolveNextcloudUser(uid) {
 	if (uid === undefined || uid === null || uid === '') {
 		return fallback
 	}
+	// The server never returns the signed-in user, so their own uid would
+	// otherwise fall back to the bare uid.
+	const me = currentUserOption()
+	if (me && me.id === String(uid)) {
+		return me
+	}
 	const results = await searchNextcloudUsers(String(uid))
 	const match = results.find((opt) => opt.id === String(uid))
 	return match || fallback