@conduction/nextcloud-vue 2.138.0 → 2.140.0

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

@@ -6,9 +6,11 @@
 import { getCanonicalLocale, translate as t } from '@nextcloud/l10n'
 import { generateOcsUrl, generateUrl } from '@nextcloud/router'
 import { reactive } from 'vue'
+import AccountOutline from 'vue-material-design-icons/AccountOutline.vue'
 import CalendarClock from 'vue-material-design-icons/CalendarClock.vue'
 import Cancel from 'vue-material-design-icons/Cancel.vue'
 import Check from 'vue-material-design-icons/Check.vue'
+import EmailOutline from 'vue-material-design-icons/EmailOutline.vue'
 import HandBackRight from 'vue-material-design-icons/HandBackRight.vue'
 import LightningBolt from 'vue-material-design-icons/LightningBolt.vue'
 import Pencil from 'vue-material-design-icons/Pencil.vue'
@@ -19,6 +21,7 @@ import { fillTemplate } from '../utils/fillTemplate.js'
 import { FLOW_RUN_ERROR_STATUSES, flowRunStatuses } from '../utils/flowRunStatus.js'
 import { fetchGroupMembers, fetchPresence, fetchStatuses, fetchUsers } from '../utils/nextcloudDirectory.js'
 import { readPath } from '../utils/readPath.js'
+import { resolveNextcloudUser } from '../utils/userAutocomplete.js'
 import { useFlowStore } from './useFlowStore.js'
 import { organisationRecord, useOrganisationStore } from './useOrganisationStore.js'
 import { useTaskInboxStore } from './useTaskInboxStore.js'
@@ -699,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
@@ -1088,7 +1094,7 @@ function fillRowTemplate(template, row) {
  * and its count (DqZoekresultaten).
  *
  * `sourceConfig.kinds` lists what is searched:
- * `{ id, label, register, schema, titleField?, subtitleField?, subtitleTemplate?, statusField?, statusResolve?, linkedField?, linkedTemplate?, href?, limit? }`
+ * `{ id, label, register, schema, titleField?, subtitleField?, subtitleTemplate?, statusField?, statusResolve?, linkedField?, linkedTemplate?, linkedUser?, href?, limit? }`
  * for objects (OpenRegister's `_search`, so the reader sees what they may
  * read), or `{ id, label, files: true, limit? }` for the reader's files
  * (Nextcloud's unified search). The term is `sourceConfig.term`, else the
@@ -1104,6 +1110,8 @@ function fillRowTemplate(template, row) {
  * column, drawn when a kind declares one; `sourceConfig.linkedLabel` names it.
  * `subtitleTemplate` ("Case {identifier}", translated) fills the line under a
  * result, else `subtitleField`.
+ * `linkedUser: true` reads that value as a user id and shows the user's
+ * display name. `sourceConfig.columnWidths` sets a width per column key.
  * The page's title and count line can name the term as `{term}`, and the
  * count is the active kind's total. Kind, link and status are filterable.
  *
@@ -1113,6 +1121,23 @@ function fillRowTemplate(template, row) {
  * @return {object} The source adapter.
  * @spec openspec/changes/index-search-source/specs/index-page/spec.md#requirement-an-index-page-can-search-several-schemas-and-files
  */
+/**
+ * Columns with the widths a page names per column key
+ * (`sourceConfig.columnWidths`, `{ title: '250px' }`); a column it does not
+ * name keeps none.
+ *
+ * @param {Array<object>} columns The columns.
+ * @param {object|undefined} widths The widths by key.
+ * @return {Array<object>} The columns.
+ * @spec openspec/changes/search-linked-user-and-widths/specs/search-linked-user-and-widths/spec.md
+ */
+function withColumnWidths(columns, widths) {
+	if (!widths || typeof widths !== 'object') {
+		return columns
+	}
+	return columns.map((col) => (typeof widths[col.key] === 'string' && widths[col.key] !== '' ? { ...col, width: widths[col.key] } : col))
+}
+
 function searchSource(config = {}, context = {}) {
 	const translate = typeof context.translate === 'function' ? context.translate : (text) => text
 	const kinds = (Array.isArray(config && config.kinds) ? config.kinds : [])
@@ -1208,12 +1233,20 @@ function searchSource(config = {}, context = {}) {
 		return kind.subtitleField ? String(readPath(object, kind.subtitleField) ?? '') : ''
 	}
 
+	// `linkedUser`: the Linked cell holds a user id; name the user instead.
+	const linkedUserNames = async (kind, objects) => {
+		const ids = [...new Set(objects.map((object) => linkedOf(kind, object)).filter((id) => id !== ''))]
+		const options = await Promise.all(ids.map((id) => resolveNextcloudUser(id).catch(() => null)))
+		return new Map(ids.map((id, index) => [id, (options[index] && options[index].label) || id]))
+	}
+
 	const searchObjects = async (axios, kind, term) => {
 		const url = generateUrl('/apps/openregister/api/objects/{register}/{schema}', { register: kind.register, schema: kind.schema })
 		const res = await axios.get(url, { params: { _search: term, _limit: kind.limit || 20 } })
 		const body = (res && res.data) || {}
 		const results = Array.isArray(body.results) ? body.results : (Array.isArray(body) ? body : [])
 		const labels = kind.statusResolve && kind.statusField ? await statusLabels(kind) : null
+		const userNames = kind.linkedUser === true ? await linkedUserNames(kind, results) : null
 		return {
 			total: typeof body.total === 'number' ? body.total : results.length,
 			rows: results.map((object) => {
@@ -1230,7 +1263,7 @@ function searchSource(config = {}, context = {}) {
 					title: String(readPath(object, kind.titleField || 'title') ?? object.name ?? id ?? ''),
 					subtitle: subtitleOf(kind, object),
 					status,
-					linked: linkedOf(kind, object),
+					linked: userNames ? (userNames.get(linkedOf(kind, object)) || linkedOf(kind, object)) : linkedOf(kind, object),
 					href: kind.href ? generateUrl(fillRowTemplate(kind.href, { ...object, id })) : '',
 					object,
 				}
@@ -1338,7 +1371,7 @@ function searchSource(config = {}, context = {}) {
 		 */
 		loading: () => state.loading,
 
-		columns: [
+		columns: withColumnWidths([
 			{ key: 'title', label: t('nextcloud-vue', 'Result'), secondary: 'subtitle', sortable: true },
 			// `kindAsText`: what one row is, as plain text ("Zaak", "Lantaarnpaal",
 			// DqZoekresultaten), instead of the plural kind as a pill.
@@ -1353,7 +1386,7 @@ function searchSource(config = {}, context = {}) {
 				widgetProps: { colorMap: (config && config.statusColorMap) || {} },
 				sortable: true,
 			},
-		],
+		], config && config.columnWidths),
 
 		/**
 		 * Every column header carries a filter button (DqZoekresultaten); the
@@ -1603,6 +1636,15 @@ function usersSource() {
 		/** A filter button on every head (DqAfdelingen); the members read are narrowed here. */
 		headerFilters: true,
 
+		/**
+		 * A member's row menu (DqAfdelingen): their Nextcloud profile, and an
+		 * e-mail when they have an address. Both are links.
+		 */
+		rowActions: [
+			{ id: 'open-profile', label: t('nextcloud-vue', 'Open profile'), icon: AccountOutline, href: (row) => generateUrl(`/u/${encodeURIComponent(row.id)}`) },
+			{ id: 'send-email', label: t('nextcloud-vue', 'Send email'), icon: EmailOutline, href: (row) => `mailto:${row.email}`, visible: (row) => Boolean(row && row.email) },
+		],
+
 		showAdd: false,
 	}
 }

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/dialog.css

@@ -204,6 +204,24 @@ body:has(.cn-look-board):not(:has(.cn-look-nextcloud)) .modal-mask {
 	gap: 10px;
 }
 
+/* A choice card with a checkbox (CnAssignDialog's toggles) is as tight as
+   the board draws it (DqOverdragen, 76px for a label and a two-line note):
+   10px 14px padding, the checkbox row at the 24px minimum target instead of
+   NcCheckboxRadioSwitch's 34px, the note at 1.2 line height. */
+.cn-dialog-board .cn-assign-dialog__toggle {
+	padding: 10px 14px;
+}
+
+.cn-dialog-board .cn-assign-dialog__toggle .checkbox-radio-switch-checkbox .checkbox-content,
+.cn-dialog-board .cn-assign-dialog__toggle .checkbox-radio-switch__input {
+	min-height: 24px;
+	padding-block: 0;
+}
+
+.cn-dialog-board .cn-assign-dialog__toggle-note {
+	line-height: 1.2;
+}
+
 /* Body: padding 20px 24px, 18px between blocks. */
 .cn-dialog-board .dialog__content {
 	display: flex;

package/src/css/look-board-detail.css

@@ -579,9 +579,16 @@
 .cn-look-board .cn-conversation-thread .cn-conversation-thread__meta:not(.cn-look-nextcloud *),
 .cn-look-board .cn-conversation-thread .cn-conversation-thread__meta time:not(.cn-look-nextcloud *) {
 	color: var(--cn-board-text-soft);
+	font-size: 13px;
 	line-height: normal;
 }
 
+/* 6px between the meta line and the text.
+   @spec openspec/changes/board-conversation-bubble-meta-gap/specs/board-conversation-bubble-meta-gap/spec.md#requirement-a-board-message-sets-its-meta-line-at-13px-6px-above-the-text */
+.cn-look-board .cn-conversation-thread .cn-conversation-thread__bubble:not(.cn-look-nextcloud *) {
+	gap: 6px;
+}
+
 .cn-look-board .cn-conversation-thread .cn-conversation-thread__message--us .cn-conversation-thread__bubble:not(.cn-look-nextcloud *) {
 	color: var(--color-main-text);
 }
@@ -1270,6 +1277,11 @@
 	line-height: normal;
 }
 
+/* Head and body text at line height 1.2, as the board draws the table. */
+.cn-look-board .cn-detail-page .cn-widget-wrapper__content > .cn-tasks-widget .cn-tasks-widget__table :is(th, td) {
+	line-height: 1.2;
+}
+
 /* A long task name wraps under itself, as the board draws it, rather than
    widening the table past the card. */
 .cn-look-board .cn-detail-page .cn-widget-wrapper__content > .cn-tasks-widget .cn-tasks-widget__table :is(.cn-tasks-widget__name, .cn-tasks-widget__meta) {
@@ -1569,3 +1581,15 @@
 	font-size: 14px;
 	line-height: 1.2;
 }
+
+/* The contacts tab inside a detail card (DqZaakBetrokkenen "Partijen") takes
+   the card's padding instead of its own, and its buttons start at the card's
+   edge under the subtitle.
+   @spec openspec/changes/board-contacts-in-card/specs/contacts/spec.md */
+.cn-look-board .cn-detail-page__leaf-card .cn-contacts-tab {
+	padding: 0;
+}
+
+.cn-look-board .cn-detail-page__leaf-card .cn-contacts-tab .cn-contacts-tab__header {
+	justify-content: flex-start;
+}

package/src/css/look-board-index.css

@@ -71,6 +71,27 @@
 	margin-inline-start: 0;
 }
 
+/* With the side panel open the buttons take the row under the title, the
+   breadcrumb and the count line follow (DqZakenSorteren).
+   @spec openspec/changes/board-header-buttons-under-title-beside-side-panel/specs/board-header-buttons-under-title-beside-side-panel/spec.md#requirement-the-header-buttons-sit-under-the-title-while-the-side-panel-is-open */
+.cn-look-board.cn-index-page--sidebar-open .cn-page-header .cn-index-page__header-buttons,
+.cn-look-board .cn-index-page--sidebar-open .cn-page-header .cn-index-page__header-buttons {
+	grid-column: 1 / -1;
+	grid-row: 2;
+	justify-self: start;
+	margin-block: 6px 3px;
+}
+
+.cn-look-board.cn-index-page--sidebar-open .cn-page-header .cn-header-trail,
+.cn-look-board .cn-index-page--sidebar-open .cn-page-header .cn-header-trail {
+	grid-row: 3;
+}
+
+.cn-look-board.cn-index-page--sidebar-open .cn-page-header .cn-page-header__text > .cn-page-header__description,
+.cn-look-board .cn-index-page--sidebar-open .cn-page-header .cn-page-header__text > .cn-page-header__description {
+	grid-row: 4;
+}
+
 /* The header buttons keep the board's button under a theme that styles every
    secondary or primary button with `!important` (the nldesign theme: a
    primary border, 8px 16px padding): Download and the Actions menu are 40px,

package/src/css/look-board.css

@@ -321,6 +321,20 @@
 	border: 0;
 }
 
+/* A dashboard banner's kicker is a 13px bold line in sentence case, no
+   tracking (DqMijnWerk "Vandaag eerst", BqMijnGoedkeuringen "First, today");
+   the plain look keeps its spaced capitals. The kicker is a paragraph, so its
+   size and weight also go to the theme's paragraph tokens.
+   @spec openspec/changes/board-banner-kicker-case/specs/board-banner-kicker-case/spec.md#requirement-a-board-dashboard-banners-kicker-is-in-sentence-case */
+.cn-look-board .cn-dashboard-page:not(.cn-look-nextcloud *) .cn-banner-widget__kicker {
+	--nldesign-component-paragraph-font-size: 13px;
+	--nldesign-component-paragraph-font-weight: 700;
+	font-size: 13px;
+	font-weight: 700;
+	letter-spacing: 0;
+	text-transform: none;
+}
+
 /* ---- A workspace filter form (CnWorkspaceFilterWidget) ----------------- */
 /* The boards draw the form's field and its load button 40px tall, the button
    16px in at both sides (DqTermijnen "Jaar" with "Rapport laden"); the form
@@ -647,6 +661,13 @@
 	--button-size: 34px;
 }
 
+/* Two buttons in a card's title row stand 8px apart (DqZaakContact "Live
+   gesprek", DqZaakEmail "Mail koppelen" / "Mail opstellen").
+   @spec openspec/changes/board-card-header-actions-gap/specs/board-card-header-actions-gap/spec.md#requirement-a-board-cards-title-row-buttons-stand-8px-apart */
+.cn-look-board .cn-widget-wrapper__actions:not(.cn-look-nextcloud *) {
+	gap: 8px;
+}
+
 /* A detail page marked `cardButtons: "regular"` draws them at the 40px
    control height: the case page's tab cards (DqZaakContact "Live gesprek",
    DqZaakHistorie, DqZaakBetrokkenen), where setting and case-type pages keep 34.
@@ -2983,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;
@@ -2994,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
 	}

package/src/utils/transitionInputs.js

@@ -223,6 +223,41 @@ function daysAfter(days, now) {
 	return date
 }
 
+/**
+ * Today plus that many days, as a date input's value.
+ *
+ * @param {unknown} days Whole days, 1 or more.
+ * @param {Date} [now] What counts as today.
+ * @return {string} `yyyy-mm-dd`, '' without a positive whole number.
+ * @spec openspec/changes/days-input-as-date/specs/transition-inputs/spec.md
+ */
+export function dayAfterIso(days, now = new Date()) {
+	const date = daysAfter(days, now)
+	if (date === null) {
+		return ''
+	}
+	const pad = (number) => String(number).padStart(2, '0')
+	return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())}`
+}
+
+/**
+ * The whole days from today to a date input's value, at least 1.
+ *
+ * @param {unknown} iso A `yyyy-mm-dd` date.
+ * @param {Date} [now] What counts as today.
+ * @return {string} The days, '' without a date.
+ * @spec openspec/changes/days-input-as-date/specs/transition-inputs/spec.md
+ */
+export function daysUntilIso(iso, now = new Date()) {
+	const match = /^(\d{4})-(\d{2})-(\d{2})$/.exec(String(iso ?? '').trim())
+	if (!match) {
+		return ''
+	}
+	const target = Date.UTC(Number(match[1]), Number(match[2]) - 1, Number(match[3]))
+	const today = Date.UTC(now.getFullYear(), now.getMonth(), now.getDate())
+	return String(Math.max(1, Math.round((target - today) / 86400000)))
+}
+
 /**
  * A date as a reader sees it: day, short month and year.
  *
@@ -290,6 +325,9 @@ export function fillInputTemplate(template, values, now = new Date()) {
  *   in that other input.
  * - `preview: { label, template, note, testid }`: a line under the input,
  *   filled by `fillInputTemplate` and shown only once it resolves.
+ * - `dateField: { label, note, testid }`: on a days input, an editable date
+ *   under it, today plus the days; a chosen date sets the days to the whole
+ *   days from today, at least 1. `dateValue` carries the date.
  * - `default`: the starting value.
  * - Presentation: `labelOutside`, `id`, `note`, `wide`, `testid`, `rows`,
  *   `placeholder`.
@@ -302,7 +340,7 @@ export function fillInputTemplate(template, values, now = new Date()) {
  * @param {string} [options.register] Register the reference pickers fall back to.
  * @param {object} [options.context] What `optionsSource` reads.
  * @param {object} [options.values] The values so far.
- * @param {Date} [options.now] What counts as today, for previews.
+ * @param {Date} [options.now] What counts as today, for previews and `dateField`.
  * @return {Array<object>} The descriptors.
  */
 export function resolveInputFields(declared, { schema = null, register = '', context = {}, values = {}, now } = {}) {
@@ -345,6 +383,9 @@ export function resolveInputFields(declared, { schema = null, register = '', con
 		field.previewText = preview && typeof preview === 'object'
 			? fillInputTemplate(preview.template, values, now)
 			: ''
+		field.dateValue = field.input.dateField && typeof field.input.dateField === 'object'
+			? dayAfterIso(values[field.key], now)
+			: ''
 	}
 
 	return fields