@conduction/nextcloud-vue 2.85.0 → 2.87.0

package/dist/esm/components/CnBoardView/CnBoardView.vue2.js

@@ -2,13 +2,14 @@ import { translate } from '@nextcloud/l10n';
 import __sfc_main from '../CnStatusBadge/CnStatusBadge.vue.js';
 import { normalizeLook } from '../../composables/useLook.js';
 import { isBadgeVariant } from '../../utils/badgeVariants.js';
-import { buildBoardColumns, resolveStageColor } from '../../utils/boardColumns.js';
+import { buildBoardColumns, normalizeAllowed, resolveStageColor } from '../../utils/boardColumns.js';
 import { buildSwimlanes } from '../../utils/boardSwimlanes.js';
 import { runBoardDrop, DROP_OUTCOMES } from '../../utils/boardTransition.js';
 import { dueStateForRow } from '../../utils/dueRule.js';
 import { formatMetricValue } from '../../utils/formatMetric.js';
 import { readPath } from '../../utils/readPath.js';
 import { preventMiddleClickAutoscroll, isRowMiddleClick } from '../../utils/rowAuxClick.js';
+import { userLocale } from '../../utils/userLocale.js';
 import { daysUntil } from '../../utils/dateVariant.js';
 
 /**
@@ -248,7 +249,13 @@ var script = {
 		 * 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}
+		 * An entry may also be `{ key, allowed, reason }`. With `allowed:
+		 * false` the column is blocked: the menu shows the reason under its
+		 * name, the column shows it under its header during a drag, and a
+		 * drop there is refused with it.
+		 *
+		 * @type {((card: object) => Promise<Array<string|{key: string, allowed?: boolean, reason?: string}>|null>)|null}
+		 * @spec openspec/changes/board-move-block-reasons/specs/board-view/spec.md#requirement-a-move-target-can-be-blocked-with-a-reason
 		 * @spec openspec/changes/screens-board-reference-columns/specs/board-view/spec.md#requirement-the-board-shows-where-a-card-can-go
 		 */
 		allowedMoves: {
@@ -273,9 +280,9 @@ var script = {
 			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. */
+			/** Where each card may move (`allowedMoves`), as `{ keys, reasons }` by card key; null = everywhere, absent = not asked yet. */
 			allowedByCard: {},
-			/** The column keys the dragged card may reach, or null for all. */
+			/** Where the dragged card may move, as `{ keys, reasons }`, or null for everywhere. */
 			dragAllowed: null,
 		}
 	},
@@ -331,6 +338,21 @@ var script = {
 			return translate('nextcloud-vue', 'not allowed')
 		},
 
+		/** @return {string} The note on a menu target that is full. */
+		fullLabel() {
+			return translate('nextcloud-vue', 'full')
+		},
+
+		/**
+		 * Every column's total over all lanes, by key: what a limit is
+		 * measured against, since a swimlane holds only part of a column.
+		 *
+		 * @return {Map<string, number>} The totals.
+		 */
+		columnTotals() {
+			return new Map(this.board.columns.map((column) => [String(column.key), column.count]))
+		},
+
 		/** @return {Array<string>} The selected row keys as strings. */
 		selectedKeys() {
 			return (Array.isArray(this.selectedIds) ? this.selectedIds : []).map(String)
@@ -437,7 +459,7 @@ var script = {
 		 * 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.
+		 * @return {Promise<{keys: Array<string>, reasons: object}|null>} Where it may go, or null for everywhere.
 		 * @spec openspec/changes/screens-board-reference-columns/specs/board-view/spec.md#requirement-the-board-shows-where-a-card-can-go
 		 */
 		async loadAllowed(card) {
@@ -450,8 +472,7 @@ var script = {
 			}
 			let allowed;
 			try {
-				const answer = await this.allowedMoves(card);
-				allowed = Array.isArray(answer) ? answer.map(String) : null;
+				allowed = normalizeAllowed(await this.allowedMoves(card));
 			} catch {
 				// Unknown is not "nowhere": the host's move stays the authority.
 				allowed = null;
@@ -469,7 +490,116 @@ var script = {
 		 */
 		isMoveAllowed(card, target) {
 			const allowed = this.allowedByCard[this.cardKey(card)];
-			return !Array.isArray(allowed) || allowed.includes(String(target.key))
+			return !allowed || allowed.keys.includes(String(target.key))
+		},
+
+		/**
+		 * Why the host blocked a card's move to a column, when it said.
+		 *
+		 * @param {object} card The card.
+		 * @param {object} target The column.
+		 * @return {string} The reason, '' when the move is allowed or no reason was given.
+		 * @spec openspec/changes/board-move-block-reasons/specs/board-view/spec.md#requirement-a-move-target-can-be-blocked-with-a-reason
+		 */
+		blockReason(card, target) {
+			const allowed = this.allowedByCard[this.cardKey(card)];
+			if (!allowed || this.isMoveAllowed(card, target)) {
+				return ''
+			}
+			return allowed.reasons[String(target.key)] || ''
+		},
+
+		/**
+		 * The note beside a menu target the card cannot move to.
+		 *
+		 * @param {object} card The card.
+		 * @param {object} target The column.
+		 * @return {string} "full" or "not allowed"; '' when a reason is shown instead.
+		 */
+		blockedNote(card, target) {
+			if (this.blockReason(card, target) !== '') {
+				return ''
+			}
+			return this.isMoveAllowed(card, target) && this.isFull(target) ? this.fullLabel : this.notAllowedLabel
+		},
+
+		/**
+		 * Why the dragged card cannot land on a column, shown under its header.
+		 *
+		 * @param {object} column The column.
+		 * @return {string} The host's reason while a drag is on, else ''.
+		 * @spec openspec/changes/board-move-block-reasons/specs/board-view/spec.md#requirement-a-move-target-can-be-blocked-with-a-reason
+		 */
+		dragReason(column) {
+			if (this.dragging === null || !this.dragAllowed || column.key === this.dragging.fromKey) {
+				return ''
+			}
+			const key = String(column.key);
+			return this.dragAllowed.keys.includes(key) ? '' : (this.dragAllowed.reasons[key] || '')
+		},
+
+		/**
+		 * A column's limit.
+		 *
+		 * @param {object} column The column.
+		 * @return {number|null} The limit, or null when it has none.
+		 * @spec openspec/changes/board-column-capacity/specs/board-view/spec.md#requirement-a-column-can-carry-a-capacity
+		 */
+		capacityOf(column) {
+			const capacity = Number(column?.capacity);
+			return Number.isFinite(capacity) && capacity > 0 ? capacity : null
+		},
+
+		/**
+		 * Whether a column holds as many cards as its limit, or more.
+		 *
+		 * @param {object} column The column.
+		 * @return {boolean} True when full; false without a limit.
+		 * @spec openspec/changes/board-column-capacity/specs/board-view/spec.md#requirement-a-column-can-carry-a-capacity
+		 */
+		isFull(column) {
+			const capacity = this.capacityOf(column);
+			return capacity !== null && (this.columnTotals.get(String(column.key)) ?? column.count) >= capacity
+		},
+
+		/**
+		 * "count / capacity" for a column with a limit.
+		 *
+		 * @param {object} column The column.
+		 * @return {string} The text.
+		 */
+		capacityText(column) {
+			return translate('nextcloud-vue', '{count} / {capacity}', {
+				count: this.columnTotals.get(String(column.key)) ?? column.count,
+				capacity: this.capacityOf(column),
+			})
+		},
+
+		/**
+		 * Whether a card may move to a column: the host allows it and the
+		 * column is not full.
+		 *
+		 * @param {object} card The card.
+		 * @param {object} target The column.
+		 * @return {boolean} True when the move may be asked for.
+		 * @spec openspec/changes/board-column-capacity/specs/board-view/spec.md#requirement-a-drop-into-a-full-column-is-refused
+		 */
+		canMoveTo(card, target) {
+			return this.isMoveAllowed(card, target) && !this.isFull(target)
+		},
+
+		/**
+		 * The sentence a drop into a full column is refused with.
+		 *
+		 * @param {object} column The column.
+		 * @return {string} The sentence.
+		 */
+		fullRefusal(column) {
+			return translate('nextcloud-vue', '{column} is full: {count} of {capacity}.', {
+				column: column.label,
+				count: this.columnTotals.get(String(column.key)) ?? column.count,
+				capacity: this.capacityOf(column),
+			})
 		},
 
 		/**
@@ -479,10 +609,11 @@ var script = {
 		 * @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))
+			if (this.dragging === null || column.key === this.dragging.fromKey) {
+				return false
+			}
+			return this.isFull(column)
+				|| (this.dragAllowed !== null && !this.dragAllowed.keys.includes(String(column.key)))
 		},
 
 		/**
@@ -606,7 +737,7 @@ var script = {
 			const date = new Date(value);
 			const shown = Number.isNaN(date.getTime())
 				? String(value)
-				: date.toLocaleDateString(undefined, { day: 'numeric', month: 'short' });
+				: date.toLocaleDateString(userLocale(), { day: 'numeric', month: 'short' });
 			return days < 0
 				? translate('nextcloud-vue', 'Overdue {date}', { date: shown })
 				: translate('nextcloud-vue', 'Due {date}', { date: shown })
@@ -956,6 +1087,9 @@ var script = {
 		 * @return {string} The count.
 		 */
 		countLabel(column) {
+			if (this.capacityOf(column) !== null) {
+				return this.capacityText(column)
+			}
 			return this.paged
 				? translate('nextcloud-vue', '{count} on this page', { count: column.count })
 				: String(column.count)
@@ -1045,7 +1179,8 @@ var script = {
 			this.dragAllowed = null;
 			if (column.key !== fromKey && !this.isMoveAllowed(card, column)) {
 				const name = this.roleText(card, this.roles.title) || this.cardKey(card);
-				this.refusal = translate('nextcloud-vue', '{name} cannot move to {column}.', { name, column: column.label });
+				this.refusal = this.blockReason(card, column)
+					|| translate('nextcloud-vue', '{name} cannot move to {column}.', { name, column: column.label });
 				this.$emit('refused', { card, message: this.refusal });
 				return
 			}
@@ -1075,6 +1210,13 @@ var script = {
 		async move(card, fromKey, toKey) {
 			this.refusal = '';
 
+			const target = this.board.columns.find((column) => String(column.key) === String(toKey));
+			if (target && String(toKey) !== String(fromKey) && this.isFull(target)) {
+				this.refusal = this.fullRefusal(target);
+				this.$emit('refused', { card, message: this.refusal });
+				return
+			}
+
 			const result = await runBoardDrop({
 				card,
 				fromKey,