@conduction/nextcloud-vue 2.83.0 → 2.85.0

package/src/components/CnBoardView/CnBoardView.vue

@@ -5,7 +5,7 @@
 <template>
 	<div
 		class="cn-board-view"
-		:class="{ 'cn-board-view--board': isBoardLook }"
+		:class="{ 'cn-board-view--board': isBoardLook, 'cn-board-view--wrap': wrapColumns, 'cn-board-view--selecting': selectedKeys.length > 0 }"
 		data-testid="cn-board-view">
 		<p v-if="!usable" class="cn-board-view__unusable" data-testid="cn-board-unusable">
 			{{ unusableText }}
@@ -36,9 +36,11 @@
 					v-for="column in lane.columns"
 					:key="`col-${lane.key}-${column.key}`"
 					class="cn-board-view__column"
+					:class="{ 'cn-board-view__column--unreachable': isUnreachable(column) }"
 					role="listitem"
 					data-testid="cn-board-column"
 					:data-column="column.key"
+					:data-unreachable="isUnreachable(column) ? 'true' : null"
 					@dragover.prevent
 					@drop="onDrop(column, $event)">
 					<!-- Board look: a dot, the label and a white count badge, with an
@@ -116,11 +118,21 @@
 							:data-card-id="cardKey(card)"
 							:draggable="canMove"
 							@dragstart="onDragStart(card, column, $event)"
+							@dragend="onDragEnd"
 							@keydown="onCardKeydown(card, column, lane, $event)">
 							<!-- Board look: title link, sub line, pill, footer, and a
 							     menu button instead of the Move to select. -->
 							<template v-if="isBoardLook">
 								<div class="cn-board-view__card-head">
+									<input
+										v-if="selectable"
+										type="checkbox"
+										class="cn-board-view__select"
+										data-testid="cn-board-card-select"
+										:data-card-id="cardKey(card)"
+										:checked="isSelected(card)"
+										:aria-label="selectLabel(card)"
+										@change="toggleSelected(card)">
 									<a
 										href="#"
 										class="cn-board-view__card-title"
@@ -164,8 +176,14 @@
 													class="cn-board-view__menu-item"
 													data-testid="cn-board-menu-move"
 													:data-target="target.key"
-													@click="onMenuMove(card, column, target)">
+													:aria-disabled="isMoveAllowed(card, target) ? null : 'true'"
+													:class="{ 'cn-board-view__menu-item--blocked': !isMoveAllowed(card, target) }"
+													@click="isMoveAllowed(card, target) && onMenuMove(card, column, target)">
 													{{ target.label }}
+													<span
+														v-if="!isMoveAllowed(card, target)"
+														class="cn-board-view__menu-note"
+														data-testid="cn-board-menu-blocked">{{ notAllowedLabel }}</span>
 												</button>
 											</div>
 											<button
@@ -216,6 +234,16 @@
 								</span>
 							</template>
 							<template v-else>
+								<label v-if="selectable" class="cn-board-view__select-label">
+									<input
+										type="checkbox"
+										class="cn-board-view__select"
+										data-testid="cn-board-card-select"
+										:data-card-id="cardKey(card)"
+										:checked="isSelected(card)"
+										:aria-label="selectLabel(card)"
+										@change="toggleSelected(card)">
+								</label>
 								<span
 									v-if="dueLabel(card)"
 									class="cn-board-view__due"
@@ -354,6 +382,12 @@ export default {
 		 * draws the screens' board anatomy (screens-kanban-parity).
 		 */
 		cnLook: { default: 'nextcloud' },
+		/**
+		 * The app's cell-formatter registry, provided by CnAppRoot. A card
+		 * role named in `cardRoles.formatters` shows its value through it, as
+		 * the table's cells do (screens-board-reference-columns).
+		 */
+		cnFormatters: { default: () => ({}) },
 	},
 
 	props: {
@@ -494,9 +528,72 @@ export default {
 			type: Number,
 			default: 0,
 		},
+
+		/**
+		 * The column a row belongs in, for a status whose raw value is not
+		 * the column key: a reference whose rows are merged by name
+		 * (screens-board-reference-columns). Absent, the row's `statusField`
+		 * value is the key.
+		 *
+		 * @type {((row: object) => string)|null}
+		 * @spec openspec/changes/screens-board-reference-columns/specs/board-view/spec.md#requirement-columns-can-be-the-rows-a-field-references
+		 */
+		columnKeyOf: {
+			type: Function,
+			default: null,
+		},
+
+		/**
+		 * Wrap the columns onto more rows, as many to a row as fit at 240px,
+		 * instead of one row that scrolls sideways (manifest
+		 * `config.board.wrap`). For a board with more stages than fit.
+		 *
+		 * @spec openspec/changes/screens-board-reference-columns/specs/board-view/spec.md#requirement-a-wide-board-can-wrap-its-columns
+		 */
+		wrapColumns: {
+			type: Boolean,
+			default: false,
+		},
+
+		/**
+		 * Offer a checkbox on every card, so cards can be selected for the
+		 * list's bulk actions (the same selection the table holds).
+		 *
+		 * @spec openspec/changes/screens-board-reference-columns/specs/board-view/spec.md#requirement-cards-can-be-selected-for-bulk-actions
+		 */
+		selectable: {
+			type: Boolean,
+			default: false,
+		},
+
+		/**
+		 * The selected cards, by row key.
+		 *
+		 * @type {Array<string|number>}
+		 */
+		selectedIds: {
+			type: Array,
+			default: () => [],
+		},
+
+		/**
+		 * The columns one card may move to, asked when its menu opens or its
+		 * drag starts: `(card) => Promise<Array<string>|null>`, column keys,
+		 * `null` for every column. A column the card cannot reach is greyed
+		 * during the drag and marked "not allowed" in the menu, and a drop on
+		 * it is refused without asking the host. Absent, every column is
+		 * offered and the host's move decides.
+		 *
+		 * @type {((card: object) => Promise<Array<string>|null>)|null}
+		 * @spec openspec/changes/screens-board-reference-columns/specs/board-view/spec.md#requirement-the-board-shows-where-a-card-can-go
+		 */
+		allowedMoves: {
+			type: Function,
+			default: null,
+		},
 	},
 
-	emits: ['card-click', 'card-aux-click', 'moved', 'refused', 'stale', 'load-more'],
+	emits: ['card-click', 'card-aux-click', 'moved', 'refused', 'stale', 'load-more', 'select'],
 
 	data() {
 		return {
@@ -512,6 +609,10 @@ export default {
 			expanded: [],
 			/** The card whose menu is open (board look), by card key. */
 			openMenuKey: null,
+			/** Column keys each card may move to (`allowedMoves`), by card key; absent = not asked yet. */
+			allowedByCard: {},
+			/** The column keys the dragged card may reach, or null for all. */
+			dragAllowed: null,
 		}
 	},
 
@@ -529,6 +630,7 @@ export default {
 				statusField: this.statusField,
 				offBoardLabel: t('nextcloud-vue', 'Elsewhere'),
 				colorField: this.colorField,
+				keyOf: this.columnKeyOf,
 			})
 		},
 
@@ -556,9 +658,20 @@ export default {
 				due: (given && given.due) || '',
 				owner: (given && given.owner) || '',
 				pillColors: (given && given.pillColors) || {},
+				formatters: (given && given.formatters && typeof given.formatters === 'object') ? given.formatters : {},
 			}
 		},
 
+		/** @return {string} The note on a menu target the card cannot reach. */
+		notAllowedLabel() {
+			return t('nextcloud-vue', 'not allowed')
+		},
+
+		/** @return {Array<string>} The selected row keys as strings. */
+		selectedKeys() {
+			return (Array.isArray(this.selectedIds) ? this.selectedIds : []).map(String)
+		},
+
 		/** @return {string} The Open in new tab menu item. */
 		openInNewTabLabel() {
 			return t('nextcloud-vue', 'Open in new tab')
@@ -617,6 +730,97 @@ export default {
 
 		preventMiddleClickAutoscroll,
 
+		/**
+		 * Whether a card is selected.
+		 *
+		 * @param {object} card The card.
+		 * @return {boolean} True when selected.
+		 */
+		isSelected(card) {
+			return this.selectedKeys.includes(this.cardKey(card))
+		},
+
+		/**
+		 * The checkbox's accessible name.
+		 *
+		 * @param {object} card The card.
+		 * @return {string} "Select <name>".
+		 */
+		selectLabel(card) {
+			const name = this.roleText(card, this.roles.title) || this.cardKey(card)
+			return t('nextcloud-vue', 'Select {name}', { name })
+		},
+
+		/**
+		 * Select a card, or unselect it.
+		 *
+		 * @param {object} card The card.
+		 * @return {void}
+		 * @spec openspec/changes/screens-board-reference-columns/specs/board-view/spec.md#requirement-cards-can-be-selected-for-bulk-actions
+		 */
+		toggleSelected(card) {
+			const key = this.cardKey(card)
+			const next = this.isSelected(card)
+				? this.selectedIds.filter((id) => String(id) !== key)
+				: [...this.selectedIds, card?.[this.rowKey]]
+			/**
+			 * @event select Emitted when a card's checkbox changes. Payload: the selected row keys.
+			 */
+			this.$emit('select', next)
+		},
+
+		/**
+		 * Ask the host where one card may go (`allowedMoves`), once per card.
+		 *
+		 * @param {object} card The card.
+		 * @return {Promise<Array<string>|null>} The column keys, or null for all.
+		 * @spec openspec/changes/screens-board-reference-columns/specs/board-view/spec.md#requirement-the-board-shows-where-a-card-can-go
+		 */
+		async loadAllowed(card) {
+			if (typeof this.allowedMoves !== 'function') {
+				return null
+			}
+			const key = this.cardKey(card)
+			if (Object.hasOwn(this.allowedByCard, key)) {
+				return this.allowedByCard[key]
+			}
+			let allowed
+			try {
+				const answer = await this.allowedMoves(card)
+				allowed = Array.isArray(answer) ? answer.map(String) : null
+			} catch {
+				// Unknown is not "nowhere": the host's move stays the authority.
+				allowed = null
+			}
+			this.allowedByCard = { ...this.allowedByCard, [key]: allowed }
+			return allowed
+		},
+
+		/**
+		 * Whether a card may move to a column, as far as the board knows.
+		 *
+		 * @param {object} card The card.
+		 * @param {object} target The column.
+		 * @return {boolean} False only when the host said it cannot.
+		 */
+		isMoveAllowed(card, target) {
+			const allowed = this.allowedByCard[this.cardKey(card)]
+			return !Array.isArray(allowed) || allowed.includes(String(target.key))
+		},
+
+		/**
+		 * Whether a column is out of reach for the card being dragged.
+		 *
+		 * @param {object} column The column.
+		 * @return {boolean} True while a drag is on and the card cannot go there.
+		 */
+		isUnreachable(column) {
+			return this.dragging !== null
+				&& Array.isArray(this.dragAllowed)
+				&& column.key !== this.dragging.fromKey
+				&& !this.dragAllowed.includes(String(column.key))
+		},
+
 		/**
 		 * A card's due state under `dueRule`.
 		 *
@@ -658,11 +862,35 @@ export default {
 			const fields = Array.isArray(role) ? role : [role]
 			return fields
 				.filter((field) => typeof field === 'string' && field !== '')
-				.map((field) => this.textOf(readPath(card, field)))
+				.map((field) => this.fieldText(card, field))
 				.filter((value) => value !== '')
 				.join(' \u00b7 ')
 		},
 
+		/**
+		 * One card field as text: through the formatter `cardRoles.formatters`
+		 * names for it, else the value itself.
+		 *
+		 * @param {object} card The card's row.
+		 * @param {string} field The dot-path.
+		 * @return {string} The text.
+		 * @spec openspec/changes/screens-board-reference-columns/specs/board-view/spec.md#requirement-a-card-field-can-show-through-a-formatter
+		 */
+		fieldText(card, field) {
+			const raw = readPath(card, field)
+			const id = this.roles.formatters[field]
+			const fn = id && this.cnFormatters ? this.cnFormatters[id] : null
+			if (typeof fn === 'function') {
+				try {
+					const out = fn(raw, card, null)
+					return out === null || out === undefined ? '' : String(out).trim()
+				} catch {
+					return this.textOf(raw)
+				}
+			}
+			return this.textOf(raw)
+		},
+
 		/**
 		 * A value as text: a string or number as is, an object by its label.
 		 *
@@ -687,7 +915,7 @@ export default {
 		 * @return {string} A CnStatusBadge variant.
 		 */
 		pillVariant(card) {
-			const raw = this.textOf(readPath(card, this.roles.pill))
+			const raw = this.fieldText(card, this.roles.pill)
 			const variant = this.roles.pillColors[raw] ?? this.roles.pillColors[raw.toLowerCase()]
 			return isBadgeVariant(variant) ? variant : 'default'
 		},
@@ -727,7 +955,7 @@ export default {
 		 * @return {string} The name, '' when there is none.
 		 */
 		ownerName(card) {
-			return this.roles.owner === '' ? '' : this.textOf(readPath(card, this.roles.owner))
+			return this.roles.owner === '' ? '' : this.fieldText(card, this.roles.owner)
 		},
 
 		/**
@@ -879,6 +1107,7 @@ export default {
 			const key = this.cardKey(card)
 			this.openMenuKey = this.openMenuKey === key ? null : key
 			if (this.openMenuKey !== null) {
+				this.loadAllowed(card)
 				this.focusMenuItem(card, 0)
 			}
 		},
@@ -967,6 +1196,7 @@ export default {
 				event.preventDefault()
 				if (!this.isMenuOpen(card)) {
 					this.openMenuKey = this.cardKey(card)
+					this.loadAllowed(card)
 					this.focusMenuItem(card, 0)
 				}
 			}
@@ -1113,8 +1343,27 @@ export default {
 		 */
 		onDragStart(card, column, event) {
 			this.dragging = { card, fromKey: column.key }
+			this.dragAllowed = null
 			// Firefox drops a drag that carries no data.
 			event?.dataTransfer?.setData?.('text/plain', this.cardKey(card))
+			if (typeof this.allowedMoves === 'function') {
+				this.loadAllowed(card).then((allowed) => {
+					if (this.dragging && this.dragging.card === card) {
+						this.dragAllowed = allowed
+					}
+				})
+			}
+		},
+
+		/**
+		 * The drag ended (dropped anywhere, or cancelled): no column stays
+		 * greyed. A drop on a column has already run by now.
+		 *
+		 * @return {void}
+		 */
+		onDragEnd() {
+			this.dragging = null
+			this.dragAllowed = null
 		},
 
 		/**
@@ -1129,6 +1378,13 @@ export default {
 			}
 			const { card, fromKey } = this.dragging
 			this.dragging = null
+			this.dragAllowed = null
+			if (column.key !== fromKey && !this.isMoveAllowed(card, column)) {
+				const name = this.roleText(card, this.roles.title) || this.cardKey(card)
+				this.refusal = t('nextcloud-vue', '{name} cannot move to {column}.', { name, column: column.label })
+				this.$emit('refused', { card, message: this.refusal })
+				return
+			}
 			await this.move(card, fromKey, column.key)
 		},
 

package/src/components/CnBodySections/CnBodySections.vue

@@ -82,6 +82,8 @@ export default {
 		cnRegistry: { default: () => ({}) },
 		/** Legacy custom-component map provided by CnAppRoot. */
 		cnCustomComponents: { default: () => ({}) },
+		/** The host's translate function for manifest-authored strings, provided by CnAppRoot. */
+		cnTranslate: { default: null },
 	},
 
 	props: {
@@ -201,7 +203,7 @@ export default {
 				return {
 					id,
 					name,
-					title: (section && section.title) || '',
+					title: this.translateTitle((section && section.title) || ''),
 					card: !!(section && section.card),
 					colSpan: section && section.colSpan,
 					placement: section && section.placement,
@@ -213,6 +215,25 @@ export default {
 	},
 
 	methods: {
+		/**
+		 * A manifest-authored section title in the reader's language.
+		 *
+		 * The title is written in the manifest, so it belongs to the host
+		 * app's catalogue, the same as every other manifest title the detail
+		 * page shows. A section heading printed raw read "Asked about" to a
+		 * Dutch handler on a pipelinq ticket (Zuiddrecht live round 3).
+		 *
+		 * @param {string} title The title as written in the manifest.
+		 * @return {string} The translated title, or '' when there is none.
+		 * @spec openspec/changes/detail-page-strings-dutch/specs/detail-page-strings-dutch/spec.md#requirement-the-detail-page-speaks-the-readers-language
+		 */
+		translateTitle(title) {
+			if (title === '' || typeof this.cnTranslate !== 'function') {
+				return title
+			}
+			return this.cnTranslate(title)
+		},
+
 		/**
 		 * Resolve a section's host-app component by registry name. Precedence
 		 * matches CnPageRenderer.resolveCustomComponent: the v2 `cnRegistry`

package/src/components/CnCountdownWidget/CnCountdownWidget.vue

@@ -69,6 +69,18 @@ const VARIANT_COLORS = Object.freeze({
  * negative number: "-3 days left" is a puzzle, and an overdue case is the one
  * state a handler must not have to decode.
  *
+ * ## A settled record
+ *
+ * `settledField` names a property on the record that is truthy once the work
+ * the date belongs to is done, such as a case in its final status. A settled
+ * record reads `settledLabel` (default "Closed") in no threshold colour, never
+ * "overdue": a closed case missed nothing that can still be acted on, and a red
+ * count of days on it sends a handler after a case that needs nobody.
+ *
+ * ```js
+ * content: { field: 'deadline', settledField: 'isFinalStatus', settledLabel: 'Handled' }
+ * ```
+ *
  * ## An unset date
  *
  * Renders a dash and no threshold colour. A case with no deadline is not urgent
@@ -91,8 +103,10 @@ export default {
 		 * - `icon` — MDI icon name.
 		 * - `thresholds` — `{ warn, danger }` in days remaining.
 		 * - `showDate` — render the absolute date underneath (default true).
+		 * - `settledField` — property on the record that is truthy once the work is done; the tile then reads `settledLabel` and never counts overdue.
+		 * - `settledLabel` — the headline of a settled record, run through the host's translate function (default "Closed").
 		 *
-		 * @type {{ field?: string, label?: string, icon?: string, thresholds?: {warn?: number, danger?: number}, showDate?: boolean }}
+		 * @type {{ field?: string, label?: string, icon?: string, thresholds?: {warn?: number, danger?: number}, showDate?: boolean, settledField?: string, settledLabel?: string }}
 		 */
 		content: {
 			type: Object,
@@ -115,6 +129,7 @@ export default {
 		return {
 			cnObjectContextInjected: inject('cnObjectContext', null),
 			cnDetailObjectContextInjected: inject('cnDetailObjectContext', null),
+			cnTranslate: inject('cnTranslate', null),
 		}
 	},
 
@@ -166,17 +181,44 @@ export default {
 			return Math.round((startOfDay(this.targetDate) - startOfDay(new Date())) / MS_PER_DAY)
 		},
 
-		/** @return {boolean} true once the date has passed. */
+		/**
+		 * Whether the record says its work is done (`settledField` is truthy).
+		 *
+		 * @return {boolean} True for a settled record.
+		 * @spec openspec/changes/countdown-settled-record/specs/countdown-settled-record/spec.md#requirement-a-settled-record-never-reads-as-overdue
+		 */
+		isSettled() {
+			const field = this.content?.settledField
+			if (!this.record || !field) {
+				return false
+			}
+			return Boolean(getByPath(this.record, field))
+		},
+
+		/**
+		 * Whether the date has passed on a record still open.
+		 *
+		 * @return {boolean} True when overdue.
+		 * @spec openspec/changes/countdown-settled-record/specs/countdown-settled-record/spec.md#requirement-a-settled-record-never-reads-as-overdue
+		 */
 		isOverdue() {
-			return this.daysRemaining !== null && this.daysRemaining < 0
+			return !this.isSettled && this.daysRemaining !== null && this.daysRemaining < 0
 		},
 
 		/**
 		 * The headline: the remaining time in words.
 		 *
 		 * @return {string} The headline text.
+		 * @spec openspec/changes/countdown-settled-record/specs/countdown-settled-record/spec.md#requirement-a-settled-record-never-reads-as-overdue
 		 */
 		headline() {
+			if (this.isSettled) {
+				const label = this.content?.settledLabel
+				if (label) {
+					return typeof this.cnTranslate === 'function' ? this.cnTranslate(label) : label
+				}
+				return t('nextcloud-vue', 'Closed')
+			}
 			const days = this.daysRemaining
 			if (days === null) {
 				return '—'
@@ -213,10 +255,11 @@ export default {
 		 * The threshold band this date falls in.
 		 *
 		 * @return {string} One of default / success / warning / error.
+		 * @spec openspec/changes/countdown-settled-record/specs/countdown-settled-record/spec.md#requirement-a-settled-record-never-reads-as-overdue
 		 */
 		variant() {
 			const days = this.daysRemaining
-			if (days === null) {
+			if (days === null || this.isSettled) {
 				return 'default'
 			}
 			if (days < 0) {