@conduction/nextcloud-vue 2.139.0 → 2.140.0

package/src/components/CnIndexPage/CnIndexPage.vue

@@ -4670,6 +4670,8 @@ export default {
 			savedViews: [],
 			savedViewsLoading: false,
 			showSaveViewDialog: false,
+			/** Whether the reader changed the view since it was opened or saved. */
+			viewChanged: false,
 			viewPendingDelete: null,
 			/** An `api-call` header action waiting on its confirmation, or null. */
 			headerApiCallPending: null,
@@ -8706,12 +8708,20 @@ export default {
 
 		/**
 		 * Whether the toolbar draws Save view: not when the page switches it
-		 * off (`savedViewSave: false`) or its header carries one.
+		 * off (`savedViewSave: false`) or its header carries one, and in the
+		 * board look only once the view has changed.
 		 *
+		 * @spec openspec/changes/board-save-view-only-when-changed/specs/saved-views/spec.md#requirement-the-board-look-offers-save-view-once-the-view-has-changed
 		 * @return {boolean}
 		 */
 		toolbarSavesView() {
-			return this.savedViewSave !== false && !this.headerSavesView
+			if (this.savedViewSave === false || this.headerSavesView) {
+				return false
+			}
+			// The board look offers it once the view differs from the one
+			// opened: changed by the reader, or, with no saved view open,
+			// filtered by the address.
+			return !this.isBoardLook || this.viewChanged || (!this.appliedSavedViewId && this.activeFilterChips.length > 0)
 		},
 
 		/**
@@ -10849,6 +10859,7 @@ export default {
 		 * @return {void}
 		 */
 		onSearchEvent(value) {
+			this.viewChanged = true
 			if (this.namedSourceSearches) {
 				this.namedSearchTerm = value || ''
 			}
@@ -10868,6 +10879,7 @@ export default {
 		 * @return {void}
 		 */
 		onQuickFilterChange(index) {
+			this.viewChanged = true
 			// `activeQuickFilterIndex` is a setup-returned ref; the
 			// Vue 2 ref-unwrap proxy makes plain assignment work.
 			this.activeQuickFilterIndex = index
@@ -10884,6 +10896,7 @@ export default {
 		 * @return {void}
 		 */
 		onQuickFilterMultiChange(indices) {
+			this.viewChanged = true
 			this.selectedQuickFilterIndices = Array.isArray(indices) ? indices : []
 			this.$emit('quick-filter-change', this.selectedQuickFilterIndices)
 		},
@@ -10899,6 +10912,7 @@ export default {
 		 * @return {void}
 		 */
 		onSidebarSortChange(keys, value) {
+			this.viewChanged = true
 			if (value !== undefined && this.selectSortOption(value)) {
 				return
 			}
@@ -10978,6 +10992,7 @@ export default {
 		 * @return {void}
 		 */
 		onSortEvent(payload) {
+			this.viewChanged = true
 			// An order by keys (a column header, a field in the Sort section)
 			// leaves an endpoint-ranked order.
 			if (this.sortSource.value) {
@@ -11181,6 +11196,7 @@ export default {
 		 * @return {void}
 		 */
 		onClearFilters() {
+			this.viewChanged = true
 			// "Clear all" on the Active line also undoes the quick filters it
 			// listed (a tab without an `activeLabel` is not a filter there).
 			for (const chip of this.quickFilterActiveChips) {
@@ -11289,6 +11305,7 @@ export default {
 		 * @spec openspec/changes/screens-board-reference-columns/specs/board-view/spec.md#requirement-a-board-can-switch-the-field-its-columns-come-from
 		 */
 		onBoardColumnFieldChange(field) {
+			this.viewChanged = true
 			this.boardColumnFieldChoice = field
 			/**
 			 * @event board-column-field-change The board's column switch picked another field. Payload: the field name.
@@ -11304,6 +11321,7 @@ export default {
 		 * @return {void}
 		 */
 		onBoardNarrowChange(value) {
+			this.viewChanged = true
 			this.onFilterEvent({ key: this.boardNarrow.field, values: value === '' ? [] : [value] })
 		},
 
@@ -11366,6 +11384,7 @@ export default {
 		 * @return {void}
 		 */
 		onFilterEvent(payload) {
+			this.viewChanged = true
 			if (this.isSelfFetchMode && typeof this.list.onFilterChange === 'function') {
 				this.list.onFilterChange(payload.key, payload.values)
 				this.persistViewStateToRoute(this.currentViewState())
@@ -11388,6 +11407,7 @@ export default {
 		 * @spec openspec/changes/screens-index-list-parity/specs/index-list-board-look/spec.md#requirement-the-toolbar-sits-on-the-ground-in-two-rows
 		 */
 		onRemoveActiveFilter(chip) {
+			this.viewChanged = true
 			if (chip && chip.searchTerm === true) {
 				this.onSearchEvent('')
 				return
@@ -12356,6 +12376,7 @@ export default {
 		 * @return {void}
 		 */
 		onColumnsEvent(columns) {
+			this.viewChanged = true
 			if (this.isSelfFetchMode && this.list.visibleColumns) {
 				this.list.visibleColumns.value = columns
 			}
@@ -12403,6 +12424,7 @@ export default {
 		 * @return {void}
 		 */
 		onColumnsReorder(columns) {
+			this.viewChanged = true
 			this.onColumnsEvent(columns)
 		},
 
@@ -12413,6 +12435,7 @@ export default {
 		 * @return {void}
 		 */
 		onPinChange(count) {
+			this.viewChanged = true
 			if (!this.personalColumns || Array.isArray(this.appliedViewColumns)) {
 				return
 			}
@@ -13316,6 +13339,10 @@ export default {
 				loadMyTeam().then(() => this.onApplySavedView(view, { keepSavedViewKey }))
 				return
 			}
+			// An opened view is unchanged until the reader changes it.
+			this.$nextTick(() => {
+				this.viewChanged = false
+			})
 			const ctx = typeof this.selfFetchTokenCtx === 'function' ? this.selfFetchTokenCtx() : {}
 			state.filters = dropOptionalUnresolved(resolveFilterTokens(state.filters, ctx))
 			this.appliedViewFiltersKey = this.viewFiltersKey(state.filters)
@@ -13441,6 +13468,7 @@ export default {
 				}
 				this.savedViews = [...this.savedViews, view]
 				this.showSaveViewDialog = false
+				this.viewChanged = false
 				this.sidebarActiveTab = 'filters-tab'
 				this.sidebarOpen = true
 				this.toastSavedView('success', t('nextcloud-vue', 'View "{name}" saved', { name }))

package/src/components/CnObjectDataWidget/CnObjectDataWidget.vue

@@ -720,6 +720,7 @@ export default {
 		 * - `hidden` (boolean) — Hide this property
 		 * - `editable` (boolean) — Override editability (default: based on schema readOnly)
 		 * - `label` (string) — Override the display label
+		 * - `emptyValue` (string) — Words shown, translated, for an empty or false value instead of a dash
 		 * - `widget` (string) — Override the widget type for editing
 		 * - `formatter` (string) — Display the value through the formatter
 		 *   registered under this id on CnAppRoot (`cnFormatters`), called as
@@ -739,7 +740,8 @@ export default {
 		},
 
 		/**
-		 * Number of grid columns.
+		 * Number of grid columns. The board look fits 200px columns instead,
+		 * except for one column, which it keeps.
 		 */
 		columns: {
 			type: Number,
@@ -1100,7 +1102,8 @@ export default {
 				// still showing the stored code — `submitted` under a Dutch
 				// label, beside a list that already read "Ingediend".
 				const enumLabel = this.enumDisplayLabel(field, raw)
-				values[field.key] = enumLabel !== null ? enumLabel : formatValue(raw, prop || {})
+				const empty = this.emptyValueFor(field, raw)
+				values[field.key] = empty !== null ? empty : (enumLabel !== null ? enumLabel : formatValue(raw, prop || {}))
 			}
 			return values
 		},
@@ -1116,8 +1119,12 @@ export default {
 		 * CSS grid template for the container.
 		 */
 		gridStyle() {
-			// The board look: as many 200px columns as the card has room for.
+			// The board look: as many 200px columns as the card has room for,
+			// unless the config asks for one column (a stacked list of pairs).
 			if (normalizeLook(this.cnLook) === 'board') {
+				if (this.columns === 1) {
+					return { 'grid-template-columns': 'minmax(0, 1fr)' }
+				}
 				return {
 					'grid-template-columns': 'repeat(auto-fit, minmax(200px, 1fr))',
 				}
@@ -1842,6 +1849,24 @@ export default {
 			return this.isPlainObject(raw)
 		},
 
+		/**
+		 * The words an override gives an empty or false value
+		 * (`overrides[key].emptyValue`, translated), or null to format it as usual.
+		 *
+		 * @param {object} field - Resolved field definition from resolvedFields
+		 * @param {*} raw - The field's value
+		 * @return {string|null}
+		 * @spec openspec/changes/data-widget-empty-value-one-column/specs/data-widget/spec.md
+		 */
+		emptyValueFor(field, raw) {
+			const override = this.resolvedOverrides[field.key]
+			const words = override && typeof override.emptyValue === 'string' ? override.emptyValue : ''
+			if (words === '' || !(raw === null || raw === undefined || raw === '' || raw === false)) {
+				return null
+			}
+			return this.cnTranslate(words)
+		},
+
 		/**
 		 * Check if a field is editable.
 		 *

package/src/components/CnRecordListWidget/CnRecordNoteRows.vue

@@ -117,6 +117,13 @@ import { readPath } from '../../utils/readPath.js'
 /** The bus channel every endpoint-bound widget on the page refetches on. */
 const PAGE_REFRESH_CHANNEL = 'cn:page:refresh'
 
+/**
+ * The document event a recorded note sends, so a row's leaf (humaniq's
+ * hours) can record what it holds for the same object at the same moment.
+ * `detail` is the row's leaf props plus `note`.
+ */
+const NOTE_RECORDED_EVENT = 'cn-record-notes:recorded'
+
 /**
  * The rows of a record list drawn as notes to record (`presentation:
  * "notes"`, DqDagAfsluiten "Nog open van vandaag"): per row its pill, title,
@@ -351,6 +358,9 @@ export default {
 			try {
 				const { default: axios } = await import('@nextcloud/axios')
 				await axios.post(prefixUrl(url), { [this.action.bodyField || 'message']: text })
+				if (this.leaf) {
+					document.dispatchEvent(new CustomEvent(NOTE_RECORDED_EVENT, { detail: { ...this.leafProps(item.row), note: text } }))
+				}
 				const { [item.key]: done, ...rest } = this.drafts
 				this.drafts = rest
 				if (refresh) {

package/src/components/CnStackedBarWidget/CnStackedBarWidget.vue

@@ -3,7 +3,7 @@
   SPDX-License-Identifier: EUPL-1.2
 -->
 <template>
-	<div class="cn-stacked-bar" :class="{ 'cn-stacked-bar--inset': inset }" data-testid="cn-stacked-bar">
+	<div class="cn-stacked-bar" :class="{ 'cn-stacked-bar--inset': inset, 'cn-stacked-bar--compact': compact }" data-testid="cn-stacked-bar">
 		<div v-if="isLoading" class="cn-stacked-bar__state" role="status">
 			<NcLoadingIcon :size="20" />
 			<span>{{ loadingLabel }}</span>
@@ -183,7 +183,7 @@ export default {
 		 * segments to the card (`header` event, `count`), for a chip after the
 		 * title or a `{count}` in it.
 		 *
-		 * @type {{inset?: boolean, headerCount?: boolean, source?: {register?: string, schema?: string, groupBy?: string, filter?: object}, segments?: Array<{key?: string, label: string, value: number}>, order?: Array<string>, labels?: {[key: string]: string}, emptyText?: string}}
+		 * @type {{inset?: boolean, compact?: boolean, headerCount?: boolean, source?: {register?: string, schema?: string, groupBy?: string, filter?: object}, segments?: Array<{key?: string, label: string, value: number}>, order?: Array<string>, labels?: {[key: string]: string}, emptyText?: string}}
 		 */
 		content: {
 			type: Object,
@@ -241,6 +241,17 @@ export default {
 			return Boolean(this.content && this.content.inset === true)
 		},
 
+		/**
+		 * Whether the widget is the compact summary box (`content.compact`):
+		 * a 15px heading, one thin bar and the legend on one line.
+		 *
+		 * @spec openspec/changes/stacked-bar-compact/specs/stacked-bar-compact/spec.md#requirement-a-stacked-bar-can-be-drawn-as-the-compact-summary-box
+		 * @return {boolean}
+		 */
+		compact() {
+			return Boolean(this.content && this.content.compact === true)
+		},
+
 		/**
 		 * The translate function in use.
 		 *
@@ -651,4 +662,59 @@ export default {
 	line-height: 1.2;
 	color: var(--color-main-text);
 }
+
+/* `content.compact: true`: the summary box (DqZaakDocumenten "4 van 7
+   beoordeeld"): the sunken ground, a 15px heading, one 8px bar of joined
+   segments and the legend on one line, each count beside its label. */
+.cn-stacked-bar--compact {
+	box-sizing: border-box;
+	gap: 10px;
+	padding: 14px 16px;
+	border-radius: 10px;
+	background: var(--cn-board-sunken-ground, var(--color-background-hover));
+}
+
+.cn-stacked-bar--compact .cn-stacked-bar__heading {
+	flex-wrap: wrap;
+	gap: 8px;
+	font-size: 15px;
+}
+
+.cn-stacked-bar--compact .cn-stacked-bar__bar {
+	gap: 0;
+	height: 8px;
+	border-radius: 4px;
+	overflow: hidden;
+}
+
+.cn-stacked-bar--compact .cn-stacked-bar__segment {
+	border-radius: 0;
+}
+
+.cn-stacked-bar--compact .cn-stacked-bar__legend {
+	display: flex;
+	flex-wrap: wrap;
+	gap: 8px 18px;
+	font-size: 14px;
+}
+
+.cn-stacked-bar--compact .cn-stacked-bar__legend-item {
+	flex-direction: row;
+	align-items: center;
+	gap: 8px;
+}
+
+.cn-stacked-bar--compact .cn-stacked-bar__label {
+	color: var(--color-main-text);
+	font-size: 1em;
+}
+
+.cn-stacked-bar--compact .cn-stacked-bar__dot {
+	border-radius: 50%;
+}
+
+.cn-stacked-bar--compact .cn-stacked-bar__count {
+	font-size: 1em;
+	line-height: inherit;
+}
 </style>

package/src/components/CnTransitionInputFields/CnTransitionInputFields.vue

@@ -162,6 +162,26 @@
 				</p>
 			</div>
 
+			<!-- A days input set as a date (`dateField`): today plus the days,
+			     and a chosen date sets the days. -->
+			<div v-if="field.input.dateField"
+				:key="`${field.key}-date`"
+				class="cn-transition-input-fields__field cn-transition-input-fields__wide"
+				:data-testid="field.input.dateField.testid || `cn-transition-input-date-${field.key}`">
+				<label class="cn-transition-input-fields__label"
+					:for="`${inputId(field)}-date`">{{ dateFieldLabel(field) }}</label>
+				<NcTextField :id="`${inputId(field)}-date`"
+					:modelValue="field.dateValue"
+					type="date"
+					:label="dateFieldLabel(field)"
+					:labelOutside="true"
+					:disabled="disabled"
+					@update:modelValue="setValue(field.key, daysUntilIso($event))" />
+				<span v-if="field.input.dateField.note" class="cn-transition-input-fields__muted">
+					{{ field.input.dateField.note }}
+				</span>
+			</div>
+
 			<!-- What the input means once filled in, such as the day a paused
 			     term comes back. Shown only once it can be worked out. -->
 			<div v-if="field.previewText"
@@ -209,7 +229,7 @@ import { NcCheckboxRadioSwitch, NcSelect, NcTextArea, NcTextField } from '@nextc
 import CnResourceSelect from '../CnResourceSelect/CnResourceSelect.vue'
 import CnTemplateSelect from '../CnTemplateSelect/CnTemplateSelect.vue'
 import { readPath } from '../../utils/readPath.js'
-import { applyTemplateText, isInputFilled, resolveInputFields } from '../../utils/transitionInputs.js'
+import { applyTemplateText, daysUntilIso, isInputFilled, resolveInputFields } from '../../utils/transitionInputs.js'
 import { CnIcon } from '../CnIcon/index.js'
 
 let uid = 0
@@ -505,6 +525,28 @@ export default {
 			return this.markOptional && !field.required ? `${field.label} (${t('nextcloud-vue', 'optional')})` : field.label
 		},
 
+		/**
+		 * The label of a days input's date field (`dateField`), with the
+		 * optional marker when asked for: the date is never required.
+		 *
+		 * @param {object} field The descriptor.
+		 * @return {string}
+		 */
+		dateFieldLabel(field) {
+			const label = String(field.input.dateField.label || '')
+			return this.markOptional ? `${label} (${t('nextcloud-vue', 'optional')})` : label
+		},
+
+		/**
+		 * The days a chosen date stands for.
+		 *
+		 * @param {string} iso The date input's value.
+		 * @return {string} The days, '' without a date.
+		 */
+		daysUntilIso(iso) {
+			return daysUntilIso(iso)
+		},
+
 		/**
 		 * Label of a sub-field, with the required marker.
 		 *

package/src/composables/indexSources.js

@@ -702,12 +702,15 @@ function tasksSource() {
 		 *
 		 * @param {string} key The column key.
 		 * @param {string} order `asc` or `desc`.
-		 * @return {{sort: string}|null} The parameter, or null for a column the inbox cannot sort by.
+		 * Open tasks come before finished ones (`openFirst`), each in that order.
+		 *
+		 * @return {{sort: string, openFirst: boolean}|null} The parameters, or null for a column the inbox cannot sort by.
 		 * @spec openspec/changes/tasks-source-sorts-on-server/specs/index-sources/spec.md#requirement-a-named-source-can-sort-on-the-server
+		 * @spec openspec/changes/tasks-source-open-first/specs/index-sources/spec.md#requirement-a-sorted-task-list-puts-open-tasks-first
 		 */
 		sortParam: (key, order) => {
 			const field = TASK_SORT_FIELDS[key]
-			return field ? { sort: (order === 'desc' ? '-' : '') + field } : null
+			return field ? { sort: (order === 'desc' ? '-' : '') + field, openFirst: true } : null
 		},
 
 		// The scope tabs. Each tab's filter is merged over the page's

package/src/composables/useTaskInboxStore.js

@@ -41,7 +41,8 @@ export const FLOW_TASKS_URL = '/apps/openregister/api/flow-tasks'
 // creating app named it, so it is the one filter that lets a Tasks page say
 // "the reminders" without the engine learning what a reminder is. It widens
 // nothing: it narrows within the inbox the session already decides.
-const ALLOWED_PARAMS = ['scope', 'state', 'isTerminal', 'priority', 'kind', 'overdue', 'dueAfter', 'dueBefore', 'objectUuid', 'sort', 'limit', 'offset']
+// `openFirst` asks open tasks before finished ones, a sort the engine applies.
+const ALLOWED_PARAMS = ['scope', 'state', 'isTerminal', 'priority', 'kind', 'overdue', 'dueAfter', 'dueBefore', 'objectUuid', 'sort', 'openFirst', 'limit', 'offset']
 
 /**
  * The flat body `POST /api/flow-tasks` takes for a task on a record.
@@ -178,7 +179,7 @@ export const useTaskInboxStore = defineStore('cnTaskInbox', {
 				if (value === undefined || value === null || value === '') {
 					continue
 				}
-				params[key] = (key === 'overdue' || key === 'isTerminal') ? String(value) : value
+				params[key] = (key === 'overdue' || key === 'isTerminal' || key === 'openFirst') ? String(value) : value
 			}
 			const response = await axios.get(generateUrl(FLOW_TASKS_URL), { params })
 			const results = response.data?.results || []
@@ -358,7 +359,7 @@ export const useTaskInboxStore = defineStore('cnTaskInbox', {
 				}
 				// The endpoint reads `overdue` as a boolean-ish string; a quick
 				// filter authors it as `true` for legibility.
-				params[key] = (key === 'overdue' || key === 'isTerminal') ? String(value) : value
+				params[key] = (key === 'overdue' || key === 'isTerminal' || key === 'openFirst') ? String(value) : value
 			}
 
 			this.loading = true

package/src/css/look-board.css

@@ -3004,8 +3004,8 @@ body:has(.cn-look-board):not(:has(.cn-look-nextcloud)) .v-popper__popper.action-
 
 /* A dialog's options as the boards draw them (DqVolgendeStap, DqBesluit,
    DqDocumentGenereren, DqFilterBewerken): rounded at 10px, an idle option
-   edged in the dark border grey, and an 18px radio. The chosen and the
-   refused options keep their own edges. */
+   edged in the dark border grey, and an 18px radio. The chosen option keeps
+   its own edge. */
 .cn-look-board .cn-choice-cards .cn-choice-cards__row:not(.cn-look-nextcloud *),
 .cn-look-board .cn-choice-cards .cn-choice-cards__cell--with-details:not(.cn-look-nextcloud *) {
 	border-radius: 10px;
@@ -3015,6 +3015,14 @@ body:has(.cn-look-board):not(:has(.cn-look-nextcloud)) .v-popper__popper.action-
 	border-color: var(--color-border-maxcontrast);
 }
 
+/* A refused option keeps that edge and sits on the sunken ground
+   (DqVolgendeStap: Hervatten, Archiveren, Heropenen). */
+.cn-look-board .cn-choice-cards .cn-choice-cards__row--disabled:not(.cn-look-nextcloud *),
+.cn-look-board .cn-choice-cards .cn-choice-cards__row--disabled:hover:not(.cn-look-nextcloud *) {
+	border-color: var(--color-border-maxcontrast);
+	background: var(--cn-board-sunken-ground);
+}
+
 /* A chosen option stays white under its primary edge, as every Dq dialog board
    draws it (design-system #371); the Nextcloud look keeps the tint.
    @spec openspec/changes/board-choice-row-chosen-white/specs/board-choice-row-chosen-white/spec.md#requirement-a-chosen-board-option-is-white */

package/src/css/table.css

@@ -289,6 +289,19 @@
 	white-space: nowrap;
 }
 
+/* A growing column that opts into wrapping (`cn-cell--wrap`, DqDoorlooptijd
+   "Zaken met risico" titles) wraps its text over lines instead of cutting
+   it, and keeps a readable width: with `max-width: 0` the wide one-line
+   cells beside it squeezed it to its padding (24px).
+   @spec openspec/changes/fit-table-wrap-column-keeps-width/specs/fit-table-wrap-column-keeps-width/spec.md#requirement-a-wrapping-growing-column-keeps-a-readable-width */
+.cn-data-table--fit th.cn-table-col--grow.cn-cell--wrap,
+.cn-data-table--fit td.cn-table-col--grow.cn-cell--wrap {
+	min-width: 8em;
+	max-width: none;
+	overflow-wrap: anywhere;
+	white-space: normal;
+}
+
 /* The secondary line of the growing column ("2026-0004" under a case title)
    is a line of its own with its own ellipsis. The cell does not wrap, so in
    the board look, where the secondary line is an inline block (the title

package/src/utils/builtInFormatters.js

@@ -470,6 +470,27 @@ export function formatMasked(value, _row, _property, options) {
 	return '*'.repeat(Math.min(text.length - visible, 5)) + (visible > 0 ? text.slice(-visible) : '')
 }
 
+/**
+ * A stored value through a display map (`valueMap` registry key): the label
+ * `options.map` gives the value, else the value as stored. "Besloten
+ * Vennootschap" reads "BV" on DqOrganisaties.
+ *
+ * @param {unknown} value The stored value.
+ * @param {object} [_row] The full row (unused).
+ * @param {object} [_property] The schema property (unused).
+ * @param {{map?: Object<string, string>}} [options] The column's `formatterOptions`.
+ * @return {string} The label, or the value.
+ * @spec openspec/changes/value-map-formatter/specs/index-page/spec.md#requirement-a-column-can-show-stored-values-through-a-display-map
+ */
+export function formatValueMap(value, _row, _property, options) {
+	if (value === null || value === undefined || value === '') {
+		return ''
+	}
+	const map = options && options.map && typeof options.map === 'object' ? options.map : {}
+	const label = Object.hasOwn(map, String(value)) ? map[String(value)] : undefined
+	return typeof label === 'string' && label !== '' ? label : String(value)
+}
+
 /**
  * Built-in formatter registry merged under any consumer-registered
  * `formatters` in `CnAppRoot`'s `cnFormatters` provide.
@@ -516,4 +537,5 @@ export const BUILT_IN_FORMATTERS = {
 	connectionSettingsLabel: formatConnectionSettingsLabel,
 	masked: formatMasked,
 	isoDuration: formatIsoDuration,
+	valueMap: formatValueMap,
 }

package/src/utils/fillTemplate.js

@@ -64,7 +64,7 @@ export function formatLongDate(value, now = new Date(), withYear = false) {
  * Format one token value.
  *
  * @param {unknown} value The raw value.
- * @param {string} format `date`, `datetime`, `weekday`, `longdate`, `time`, `user`, `currency`, `relative`, `relativetime`, `ago`, `week`, `days`, `lower` or '' (as is).
+ * @param {string} format `date`, `datetime`, `weekday`, `longdate`, `time`, `user`, `currency`, `relative`, `relativetime`, `ago`, `week`, `days`, `lower`, `mailbox` or '' (as is).
  * @param {Date} now The reference moment.
  * @param {string} [arg] The format's argument (`currency:EUR`, or a row path holding the code).
  * @param {object|null} [object] The row, for a currency read from a field.
@@ -125,6 +125,12 @@ function formatValue(value, format, now, arg = '', object = null, config = null,
 	if (format === 'ago') {
 		return formatAgo(value, now)
 	}
+	if (format === 'mailbox') {
+		// An address up to and with its @ ("gemeente@" from gemeente@zuiddrecht.nl).
+		const text = String(value)
+		const at = text.indexOf('@')
+		return at > 0 ? text.slice(0, at + 1) : text
+	}
 	if (format === 'lower') {
 		return String(value).toLocaleLowerCase()
 	}

package/src/utils/myTeam.js

@@ -30,12 +30,32 @@ let _source = null
 /** The read in flight, shared by every caller. */
 let _pending = null
 
+/**
+ * The team the app answered, as kept: one group id, a list of two or more,
+ * or `''` for none. Blank entries are dropped and a list of one reads as that
+ * one id.
+ *
+ * @spec openspec/changes/my-team-source-may-answer-several-teams/specs/schema-utilities/spec.md#requirement-myteam-may-resolve-to-several-teams
+ * @param {unknown} team What the app's loader answered.
+ * @return {string|string[]} The kept team.
+ */
+function normalizeTeam(team) {
+	if (Array.isArray(team)) {
+		const ids = team.filter((id) => typeof id === 'string').map((id) => id.trim()).filter((id) => id !== '')
+		if (ids.length === 0) {
+			return ''
+		}
+		return ids.length === 1 ? ids[0] : ids
+	}
+	return typeof team === 'string' ? team.trim() : ''
+}
+
 /**
  * Name where the current user's primary team is read: a function answering
  * the team's Nextcloud group id, or null/'' for a user in no team.
  *
  * @spec openspec/changes/saved-view-tokens-my-team/specs/schema-utilities/spec.md#requirement-myteam-resolves-to-the-current-users-primary-team
- * @param {(() => Promise<string|null>)|null} loader The app's loader, or null to unregister.
+ * @param {(() => Promise<string|string[]|null>)|null} loader The app's loader (a group id, or the ids of several teams), or null to unregister.
  * @return {void}
  */
 export function registerMyTeamSource(loader) {
@@ -49,7 +69,7 @@ export function registerMyTeamSource(loader) {
  * when no source is registered, or when the read fails.
  *
  * @spec openspec/changes/saved-view-tokens-my-team/specs/schema-utilities/spec.md#requirement-myteam-resolves-to-the-current-users-primary-team
- * @return {Promise<string>} The team's group id, or ''.
+ * @return {Promise<string|string[]>} The team's group id (or ids), or ''.
  */
 export function loadMyTeam() {
 	if (_state.team !== null) {
@@ -64,7 +84,7 @@ export function loadMyTeam() {
 	}
 	_pending = Promise.resolve()
 		.then(() => _source())
-		.then((team) => (typeof team === 'string' ? team.trim() : ''))
+		.then((team) => normalizeTeam(team))
 		.catch(() => '')
 		.then((team) => {
 			_state.team = team
@@ -79,7 +99,7 @@ export function loadMyTeam() {
  * it is being read (and starts the read on first use).
  *
  * @spec openspec/changes/saved-view-tokens-my-team/specs/schema-utilities/spec.md#requirement-myteam-resolves-to-the-current-users-primary-team
- * @return {string|null} The team, '' or null.
+ * @return {string|string[]|null} The team (or teams), '' or null.
  */
 export function peekMyTeam() {
 	if (_state.team === null) {

package/src/utils/resolveFilterTokens.js

@@ -89,15 +89,16 @@ export const MY_GROUPS_TOKEN = '@myGroups'
 export const MY_TEAM_TOKEN = '@myTeam'
 
 /**
- * Resolve `@myTeam`: the team's group id; `@myTeam` while it is being read (the
+ * Resolve `@myTeam`: the team's group id, or the ids of several teams when the
+ * app answers a list (an IN filter); `@myTeam` while it is being read (the
  * caller waits); `@myTeam?` for a user in no team (the caller drops the key).
  *
  * @spec openspec/changes/saved-view-tokens-my-team/specs/schema-utilities/spec.md#requirement-myteam-resolves-to-the-current-users-primary-team
- * @param {{myTeam?: string}} [ctx] Optional context; `ctx.myTeam` wins.
- * @return {string} The group id or the token.
+ * @param {{myTeam?: (string|string[])}} [ctx] Optional context; `ctx.myTeam` wins.
+ * @return {string|string[]} The group id(s) or the token.
  */
 function resolveMyTeam(ctx) {
-	const team = ctx && typeof ctx.myTeam === 'string' ? ctx.myTeam : peekMyTeam()
+	const team = ctx && (typeof ctx.myTeam === 'string' || Array.isArray(ctx.myTeam)) ? ctx.myTeam : peekMyTeam()
 	if (team === null) {
 		return MY_TEAM_TOKEN
 	}